mcp

type Server struct {
	Name    string
	Version string
	// Instructions is natural-language guidance a client shows the model about
	// what this server is for. Worth writing well: it is the only place to say
	// "read before you act" to something that will otherwise guess.
	Instructions string
	// contains filtered or unexported fields
}

type Tool struct {
	// Name is what the model calls. The specification restricts these to
	// letters, digits, underscore, hyphen and dot.
	Name string `json:"name"`
	// Title is the human-readable name a client shows.
	Title string `json:"title,omitempty"`
	// Description is what the model reads to decide whether to call it.
	Description string `json:"description"`
	// InputSchema is required and must be a JSON Schema object — never null,
	// even for a tool that takes nothing.
	InputSchema json.RawMessage `json:"inputSchema"`
	// OutputSchema describes structuredContent. Optional, and binding: a
	// server that publishes one must produce results that conform.
	OutputSchema json.RawMessage `json:"outputSchema,omitempty"`

	// Handler performs the call. It returns the value to put in
	// structuredContent, and a human-readable rendering for content.
	//
	// An error it returns is a *tool execution* error — reported in the result
	// with isError so the model can read it and correct itself, rather than as
	// a JSON-RPC error which clients are told is less recoverable.
	Handler func(ctx context.Context, args json.RawMessage) (structured any, text string, err error) `json:"-"`
}