testmcp

type Server struct {
	// Tools are the tools the mock server will register before starting.
	// Appending to Tools after a transport server has been constructed has
	// no effect — registration happens once, at server start.
	Tools []Tool
}

type Tool struct {
	// Annotations carries optional UI hints (title, read-only, destructive,
	// idempotent, open-world).
	Annotations *mcp.ToolAnnotations

	// Description is the human-readable tool description returned to MCP
	// clients.
	Description string

	// Icons lists optional icon references for the tool.
	Icons []mcp.Icon

	// InputSchema is the JSON Schema object describing the tool's accepted
	// arguments. Marshaled to [encoding/json.RawMessage] before being passed
	// to the MCP SDK so tests can supply arbitrary shapes.
	InputSchema map[string]any

	// Meta carries optional protocol-level metadata.
	Meta mcp.Meta

	// Name is the tool's programmatic identifier (the value clients send as
	// "name" in a tools/call request).
	Name string

	// OutputSchema is the optional JSON Schema describing structured tool
	// output. When nil the server emits no output schema.
	OutputSchema map[string]any

	// Response controls the content the mock returns when this tool is
	// invoked.
	Response ToolResponse

	// Title is the optional UI-facing tool name.
	Title string
}

type ToolResponse struct {
	// Content is the list of content blocks returned to the MCP client.
	// Each entry mirrors the MCP content-object shape — currently only
	// type="text" entries (with a "text" string) are materialized by the
	// mock.
	Content []map[string]any

	// IsError, when true, causes the mock to return a CallToolResult with
	// IsError set so tests can exercise tool-side error handling without
	// producing a protocol-level error.
	IsError bool
}