go-sdk/internal/docs
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Guglielmo Colombo dd978160ab
mcp: Implement server-side support for discover method (SEP-2575) (#987)
## Summary
Part 3 of the SEP-2575 ("Make MCP Stateless") implementation. Builds on
PR #975 which landed the client-side discover/fallback flow and the
per-request `_meta` plumbing. This PR adds the **server-side**
counterparts:

- `server/discover` handler (replaces the
stub),ProtocolVersionSupporter`
- transport hook for per-transport version filtering,
- transport-agnostic version validation and method-removal enforcement
in `ServerSession.handle`,
- HTTP-level wire compliance for SEP-2575 error codes/status codes,
- bug fix in `internal/jsonrpc2`,`processResult` with an `MCPGODEBUG`
opt-out for backward compatibility.
2026-06-08 17:52:10 +02:00
..
client.src.md mcp: add Capabilities fields to ServerOptions and ClientOptions (#713) 2025-12-11 20:17:46 -05:00
doc.go Add documentation backed by mkdocs (#883) 2026-04-09 14:25:43 +02:00
mcpgodebug.src.md mcp: Implement server-side support for discover method (SEP-2575) (#987) 2026-06-08 17:52:10 +02:00
protocol.src.md auth: issuer mix-up mitigation (#859) 2026-05-27 11:39:08 +02:00
quick_start.src.md Add documentation backed by mkdocs (#883) 2026-04-09 14:25:43 +02:00
README.src.md Add documentation backed by mkdocs (#883) 2026-04-09 14:25:43 +02:00
rough_edges.src.md fix: do not omitempty ReadOnlyHint in ToolAnnotations (#908) 2026-05-25 15:52:15 +02:00
server.src.md Add documentation backed by mkdocs (#883) 2026-04-09 14:25:43 +02:00
troubleshooting.src.md docs: add feature and troubleshooting documentation (#463) 2025-09-16 11:13:40 -04:00

Overview

The SDK consists of several importable packages:

These docs mirror the official MCP spec. Use the index below to learn how the SDK implements a particular aspect of the protocol.

Base Protocol

  1. Lifecycle (Clients, Servers, and Sessions).
  2. Transports
    1. Stdio transport
    2. Streamable transport
    3. Custom transports
  3. Authorization
  4. Security
  5. Utilities
    1. Cancellation
    2. Ping
    3. Progress

Client Features

  1. Roots
  2. Sampling
  3. Elicitation

Server Features

  1. Prompts
  2. Resources
  3. Tools
  4. Utilities
    1. Completion
    2. Logging
    3. Pagination

TroubleShooting

See troubleshooting.md for a troubleshooting guide.

Backwards compatibility

See mcpgodebug.md for a list of backwards incompatible behavior changes and description how they can be temporarily undone.

Rough edges

See rough_edges.md for a list of rough edges or API oversights that can't be addressed due to our compatibility promise. We'll revisit these if/when we move to a v2 of the SDK.