Skip to content

Commit 251ce0d

Browse files
committed
Document the modern client and restructure the docs
Add a guide for the 2026-07-28 client (docs/client-modern.md) and bring the rest of the documentation in line with an SDK that has a classic and a modern client and server. - Navigation groups the guides into Classic and Modern. - Overview, index and quickstart are rewritten to cover both: a "Classic or Modern?" comparison, a feature table, and a first client call for each. - The classic architecture diagrams are redrawn as SVG, with matching modern ones added. - The modern client and server are no longer described as a preview. - CHANGELOG gains an entry for the modern client. Signed-off-by: Christian Tzolov <christian.tzolov@broadcom.com>
1 parent c531bb8 commit 251ce0d

15 files changed

Lines changed: 1446 additions & 381 deletions

‎CHANGELOG.md‎

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,11 +19,17 @@ Versioning follows [Semantic Versioning](https://semver.org/); see
1919

2020
## Unreleased (2.2.0)
2121

22-
- Preview of a stateless server for the **2026-07-28** MCP specification revision, in
22+
- A stateless server for the **2026-07-28** MCP specification revision, in
2323
`io.modelcontextprotocol.modern`, with Servlet (Streamable HTTP) and STDIO transports. It supports
2424
`server/discover`, multi round-trip requests with sealed `requestState`, `subscriptions/listen`, caching
2525
hints, required client capabilities and SEP-2243 `Mcp-Param` header validation. The API may change in minor
2626
releases until 3.0. See [MCP Server (2026-07-28)](docs/server-modern.md).
27+
- A client for the **2026-07-28** MCP specification revision, in
28+
`io.modelcontextprotocol.modern.client`, with Streamable HTTP (JDK `HttpClient`) and STDIO transports. It
29+
needs no `initialize` handshake and supports multi round-trip requests with form and URL elicitation,
30+
progress, `subscriptions/listen`, `server/discover` and SEP-2243 `Mcp-Param` headers. Sampling, roots and
31+
logging are not supported. The API may change in minor releases until 3.0. See
32+
[MCP Client (2026-07-28)](docs/client-modern.md).
2733
- Add `McpTransportContext.putAll(Map)`, returning a context that combines an
2834
existing context with additional entries, which take precedence.
2935
- `McpTransportContext` no longer compares contexts by their contents in

‎docs/client-modern.md‎

Lines changed: 568 additions & 0 deletions
Large diffs are not rendered by default.

‎docs/client.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,11 @@ The MCP Client is a key component in the Model Context Protocol (MCP) architectu
2222
The Spring-specific WebFlux transport (`mcp-spring-webflux`) is now part of [Spring AI](https://docs.spring.io/spring-ai/reference/2.0-SNAPSHOT/api/mcp/mcp-overview.html) 2.0+ (group `org.springframework.ai`) and is no longer shipped by this SDK.
2323
See the [MCP Client Boot Starter](https://docs.spring.io/spring-ai/reference/2.0-SNAPSHOT/api/mcp/mcp-client-boot-starter-docs.html) documentation for Spring-based client setup.
2424

25+
!!! note "2026-07-28 specification"
26+
This page covers the classic client, which implements the 2025-11-25 specification and earlier revisions.
27+
A client for the stateless 2026-07-28 revision is also available; see
28+
[MCP Client (2026-07-28)](client-modern.md).
29+
2530
The client provides both synchronous and asynchronous APIs for flexibility in different application contexts.
2631

2732
=== "Sync API"
Lines changed: 78 additions & 0 deletions
Loading
Lines changed: 121 additions & 0 deletions
Loading
Lines changed: 103 additions & 0 deletions
Loading

0 commit comments

Comments
 (0)