mcpkit

Apr 7, 2026

Changes in this version

+ func ContextWithSession(ctx context.Context, notify NotifyFunc, request RequestFunc, ...) context.Context

+ func MarshalNotification(method string, params any) (json.RawMessage, error)

Apr 7, 2026

Changes in this version

+ var ErrElicitationNotSupported = errors.New("client does not support elicitation")

+ var ErrNoRequestFunc = errors.New("server-to-client requests not available in this context")

+ var ErrSamplingNotSupported = errors.New("client does not support sampling")

type ClientOption

+ func WithElicitationHandler(h ElicitationHandler) ClientOption

+ func WithSamplingHandler(h SamplingHandler) ClientOption

+ type CreateMessageRequest struct

+ IncludeContext string

+ MaxTokens int

+ Messages []SamplingMessage

+ Metadata map[string]any

+ ModelPreferences *ModelPreferences

+ StopSequences []string

+ SystemPrompt string

+ Temperature *float64

+ type CreateMessageResult struct

+ Content Content

+ Model string

+ Role string

+ StopReason string

+ func Sample(ctx context.Context, req CreateMessageRequest) (CreateMessageResult, error)

type Dispatcher

+ func (d *Dispatcher) RouteResponse(resp *Response) bool

+ type ElicitationHandler func(context.Context, ElicitationRequest) (ElicitationResult, error)

+ type ElicitationRequest struct

+ Message string

+ RequestedSchema json.RawMessage

+ type ElicitationResult struct

+ Action string

+ Content map[string]any

+ func Elicit(ctx context.Context, req ElicitationRequest) (ElicitationResult, error)

+ type ModelHint struct

+ Name string

+ type ModelPreferences struct

+ CostPriority *float64

+ Hints []ModelHint

+ IntelligencePriority *float64

+ SpeedPriority *float64

+ type RequestFunc func(ctx context.Context, method string, params any) (json.RawMessage, error)

+ type SamplingHandler func(context.Context, CreateMessageRequest) (CreateMessageResult, error)

+ type SamplingMessage struct

+ Content Content

+ Role string

Apr 7, 2026

Changes in this version

type Client

+ func (c *Client) SubscribeResource(uri string) error

+ func (c *Client) UnsubscribeResource(uri string) error

type ClientOption

+ func WithNotificationHandler(fn func(method string, params any)) ClientOption

type Dispatcher

+ func (d *Dispatcher) Close()

type Option

+ func WithSubscriptions() Option

+ type ResourceUpdatedNotification struct

+ URI string

type Server

+ func (s *Server) NotifyResourceUpdated(uri string)

Apr 7, 2026

Changes in this version

type Option

+ func WithRequestLogging(logger *log.Logger) Option

Apr 7, 2026

Changes in this version

+ const ErrCodeServerError

type ClientOption

+ func WithClientLogging(logger *log.Logger) ClientOption

+ func WithInMemoryServer(srv *Server) ClientOption

+ func WithMaxRetries(n int) ClientOption

+ func WithReconnectBackoff(d time.Duration) ClientOption

+ type Middleware func(ctx context.Context, req *Request, next MiddlewareFunc) *Response

+ func LoggingMiddleware(logger *log.Logger) Middleware

+ type MiddlewareFunc func(context.Context, *Request) *Response

type Option

+ func WithMiddleware(mw ...Middleware) Option

type Server

+ func (s *Server) CloseAllSessions()

+ func (s *Server) CloseSession(id string) bool

+ func (s *Server) Run(addr string, opts ...TransportOption) error

type ToolDef

+ OutputSchema any

type ToolResult

+ StructuredContent any

+ func StructuredError(text string, data any) ToolResult

+ func StructuredResult(text string, data any) ToolResult

type TransportOption

+ func WithStateless(enabled bool) TransportOption

Apr 6, 2026

Changes in this version

+ const StreamableHTTPAccept

+ func HasScope(ctx context.Context, scope string) bool

+ func ParseWWWAuthenticate(header string) (resourceMetadata string, scopes []string, err error)

type AuthError

+ WWWAuthenticate string

+ type Claims struct

+ Audience []string

+ Extra map[string]any

+ Issuer string

+ Scopes []string

+ Subject string

+ func AuthClaims(ctx context.Context) *Claims

+ type ClaimsProvider interface

+ Claims func(r *http.Request) *Claims

+ type ClientAuthError struct

+ Message string

+ RequiredScopes []string

+ StatusCode int

+ WWWAuthenticate string

+ func (e *ClientAuthError) Error() string

type ClientOption

+ func WithClientBearerToken(token string) ClientOption

+ func WithTokenSource(ts TokenSource) ClientOption

+ type Extension struct

+ Config map[string]any

+ ID string

+ SpecVersion string

+ Stability Stability

+ type ExtensionProvider interface

+ Extension func() Extension

type Option

+ func WithExtension(ext ExtensionProvider) Option

type PromptDef

+ Annotations map[string]any

type ResourceDef

+ Annotations map[string]any

type ResourceTemplate

+ Annotations map[string]any

+ type ScopeAwareTokenSource interface

+ TokenForScopes func(scopes []string) (string, error)

type Server

+ func (s *Server) RegisterExperimentalPrompt(def PromptDef, handler PromptHandler)

+ func (s *Server) RegisterExperimentalResource(def ResourceDef, handler ResourceHandler)

+ func (s *Server) RegisterExperimentalTool(def ToolDef, handler ToolHandler)

+ type Stability string

+ const Deprecated

+ const Experimental

+ const Stable

+ type TokenSource interface

+ Token func() (string, error)

type ToolDef

+ Annotations map[string]any

Apr 5, 2026

Changes in this version

+ type CallResult struct

+ Raw any

+ func (r *CallResult) JSON() string

+ func (r *CallResult) Unmarshal(v any) error

+ type Client struct

+ ServerInfo ServerInfo

+ func NewClient(url string, info ClientInfo, opts ...ClientOption) *Client

+ func (c *Client) Call(method string, params any) (*CallResult, error)

+ func (c *Client) Close() error

+ func (c *Client) Connect() error

+ func (c *Client) ListResourceTemplates() ([]ResourceTemplate, error)

+ func (c *Client) ListResources() ([]ResourceDef, error)

+ func (c *Client) ListTools() ([]ToolDef, error)

+ func (c *Client) ReadResource(uri string) (string, error)

+ func (c *Client) SessionID() string

+ func (c *Client) ToolCall(name string, args any) (string, error)

+ type ClientOption func(*Client)

+ func WithSSEClient() ClientOption

Apr 3, 2026

Changes in this version

type TransportOption

+ func WithAllowedOrigins(origins ...string) TransportOption

Apr 3, 2026

Changes in this version

+ func EmitProgress(ctx context.Context, token any, progress, total float64, message string)

+ type CompletionArgument struct

+ Name string

+ Value string

+ type CompletionHandler func(ctx context.Context, ref CompletionRef, arg CompletionArgument) (CompletionResult, error)

+ type CompletionRef struct

+ Name string

+ Type string

+ URI string

+ type CompletionResult struct

+ HasMore bool

+ Total int

+ Values []string

type Dispatcher

+ func (d *Dispatcher) RegisterCompletion(refType, name string, handler CompletionHandler)

+ type ProgressNotification struct

+ Message string

+ Progress float64

+ ProgressToken any

+ Total float64

type Server

+ func (s *Server) RegisterCompletion(refType, name string, handler CompletionHandler)

type ToolRequest

+ ProgressToken any

Apr 3, 2026

Changes in this version

+ func EmitLog(ctx context.Context, level LogLevel, logger string, data any)

+ func Notify(ctx context.Context, method string, params any) bool

+ type LogLevel int

+ const LogAlert

+ const LogCritical

+ const LogDebug

+ const LogEmergency

+ const LogError

+ const LogInfo

+ const LogNotice

+ const LogWarning

+ func ParseLogLevel(s string) (LogLevel, bool)

+ func (l LogLevel) String() string

+ type LogMessage struct

+ Data any

+ Level string

+ Logger string

+ type NotifyFunc func(method string, params any)

Apr 3, 2026

Changes in this version

+ const ErrCodeCancelled

type Dispatcher

+ func (d *Dispatcher) RegisterPrompt(def PromptDef, handler PromptHandler)

+ func (d *Dispatcher) RegisterResource(def ResourceDef, handler ResourceHandler)

+ func (d *Dispatcher) RegisterResourceTemplate(def ResourceTemplate, handler TemplateHandler)

+ type PromptArgument struct

+ Description string

+ Name string

+ Required bool

+ type PromptDef struct

+ Arguments []PromptArgument

+ Description string

+ Name string

+ Title string

+ type PromptHandler func(ctx context.Context, req PromptRequest) (PromptResult, error)

+ type PromptMessage struct

+ Content Content

+ Role string

+ type PromptRequest struct

+ Arguments map[string]string

+ Name string

+ type PromptResult struct

+ Description string

+ Messages []PromptMessage

+ type ResourceDef struct

+ Description string

+ MimeType string

+ Name string

+ Title string

+ URI string

+ type ResourceHandler func(ctx context.Context, req ResourceRequest) (ResourceResult, error)

+ type ResourceReadContent struct

+ Blob string

+ MimeType string

+ Text string

+ URI string

+ type ResourceRequest struct

+ URI string

+ type ResourceResult struct

+ Contents []ResourceReadContent

+ type ResourceTemplate struct

+ Description string

+ MimeType string

+ Name string

+ Title string

+ URITemplate string

type Server

+ func (s *Server) RegisterPrompt(def PromptDef, handler PromptHandler)

+ func (s *Server) RegisterResource(def ResourceDef, handler ResourceHandler)

+ func (s *Server) RegisterResourceTemplate(def ResourceTemplate, handler TemplateHandler)

+ type TemplateHandler func(ctx context.Context, uri string, params map[string]string) (ResourceResult, error)

Apr 3, 2026

Changes in this version

+ const ErrCodeInternal

+ const ErrCodeInvalidParams

+ const ErrCodeInvalidRequest

+ const ErrCodeMethodNotFound

+ const ErrCodeParse

+ type AuthError struct

+ Code int

+ Message string

+ func (e *AuthError) Error() string

+ type AuthValidator interface

+ Validate func(r *http.Request) error

+ type ClientCapabilities struct

+ Elicitation *struct{}

+ Roots *RootsCap

+ Sampling *struct{}

+ type ClientInfo struct

+ Name string

+ Version string

+ type Content struct

+ Data string

+ MimeType string

+ Resource *ResourceContent

+ Text string

+ Type string

+ type Dispatcher struct

+ func NewDispatcher(info ServerInfo) *Dispatcher

+ func (d *Dispatcher) Dispatch(ctx context.Context, req *Request) *Response

+ func (d *Dispatcher) NegotiatedVersion() string

+ func (d *Dispatcher) RegisterTool(def ToolDef, handler ToolHandler)

+ type Error struct

+ Code int

+ Data any

+ Message string

+ type Option func(*serverOptions)

+ func WithAllowedRoots(roots ...string) Option

+ func WithAuth(v AuthValidator) Option

+ func WithBearerToken(token string) Option

+ func WithListen(addr string) Option

+ func WithToolTimeout(d time.Duration) Option

+ type Request struct

+ ID json.RawMessage

+ JSONRPC string

+ Method string

+ Params json.RawMessage

+ func (r *Request) IsNotification() bool

+ type ResourceContent struct

+ Blob string

+ MimeType string

+ Text string

+ URI string

+ type Response struct

+ Error *Error

+ ID json.RawMessage

+ JSONRPC string

+ Result json.RawMessage

+ func NewErrorResponse(id json.RawMessage, code int, message string) *Response

+ func NewErrorResponseWithData(id json.RawMessage, code int, message string, data any) *Response

+ func NewResponse(id json.RawMessage, result any) *Response

+ type RootsCap struct

+ ListChanged bool

+ type SSEData struct

+ func SSEJSON(j json.RawMessage) SSEData

+ func SSEText(s string) SSEData

+ type Server struct

+ func NewServer(info ServerInfo, opts ...Option) *Server

+ func (s *Server) CheckAuth(r *http.Request) error

+ func (s *Server) Dispatch(ctx context.Context, req *Request) *Response

+ func (s *Server) Handler(opts ...TransportOption) http.Handler

+ func (s *Server) ListenAndServe(opts ...TransportOption) error

+ func (s *Server) RegisterTool(def ToolDef, handler ToolHandler)

+ type ServerInfo struct

+ Description string

+ Instructions string

+ Name string

+ Title string

+ Version string

+ WebsiteURL string

+ type ToolDef struct

+ Description string

+ InputSchema any

+ Name string

+ type ToolHandler func(ctx context.Context, req ToolRequest) (ToolResult, error)

+ type ToolRequest struct

+ Arguments json.RawMessage

+ Name string

+ RequestID json.RawMessage

+ func (r *ToolRequest) Bind(v any) error

+ type ToolResult struct

+ Content []Content

+ IsError bool

+ func ErrorResult(text string) ToolResult

+ func TextResult(text string) ToolResult

+ type TransportOption func(*transportConfig)

+ func WithKeepalivePeriod(d time.Duration) TransportOption

+ func WithMaxSessions(n int) TransportOption

+ func WithPrefix(p string) TransportOption

+ func WithPublicURL(u string) TransportOption

+ func WithSSE(enabled bool) TransportOption

+ func WithStreamableHTTP(enabled bool) TransportOption