You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 38519ce
Browse filesBrowse the repository at this point in the historyBrowse files
Rename Classic to Legacy and add sync and async tabs to the docs
Follow the terms of the MCP specification, which names the
handshake-based revisions "legacy" and the per-request ones "modern".
- Classic is renamed to Legacy in the navigation, the guides and the
diagrams. Modern now comes first everywhere.
- The SSE transport is labelled "Deprecated", as in the specification.
- The modern client and server guides show each example in a Sync and
an Async tab.
- "Calling the Server" in the modern client guide explains the two
steps of a call, in place of the "Spec" and "Terminal" columns.
- Spring AI links point to the 2.1.0-SNAPSHOT reference.
Signed-off-by: Christian Tzolov <christian.tzolov@broadcom.com>
Copy file name to clipboardExpand all lines: docs/client.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -19,11 +19,11 @@ The MCP Client is a key component in the Model Context Protocol (MCP) architectu
19
19
!!! tip
20
20
The core `io.modelcontextprotocol.sdk:mcp` module provides STDIO, SSE, and Streamable HTTP client transport implementations without requiring external web frameworks.
21
21
22
-
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.
23
-
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.
22
+
The Spring-specific WebFlux transport (`mcp-spring-webflux`) is now part of [Spring AI](https://docs.spring.io/spring-ai/reference/2.1.0-SNAPSHOT/api/mcp/mcp-overview.html) 2.0+ (group `org.springframework.ai`) and is no longer shipped by this SDK.
23
+
See the [MCP Client Boot Starter](https://docs.spring.io/spring-ai/reference/2.1.0-SNAPSHOT/api/mcp/mcp-client-boot-starter-docs.html) documentation for Spring-based client setup.
24
24
25
25
!!! note "2026-07-28 specification"
26
-
This page covers the classic client, which implements the 2025-11-25 specification and earlier revisions.
26
+
This page covers the legacy client, which implements the 2025-11-25 specification and earlier revisions.
27
27
A client for the stateless 2026-07-28 revision is also available; see
28
28
[MCP Client (2026-07-28)](client-modern.md).
29
29
@@ -173,15 +173,15 @@ McpTransport transport = new StdioClientTransport(params, McpJsonDefaults.getMap
173
173
174
174
=== "Streamable WebClient (external)"
175
175
176
-
Creates Streamable HTTP WebClient-based client transport. Requires the `mcp-spring-webflux` dependency from [Spring AI](https://docs.spring.io/spring-ai/reference/2.0-SNAPSHOT/api/mcp/mcp-overview.html) 2.0+ (group `org.springframework.ai`):
176
+
Creates Streamable HTTP WebClient-based client transport. Requires the `mcp-spring-webflux` dependency from [Spring AI](https://docs.spring.io/spring-ai/reference/2.1.0-SNAPSHOT/api/mcp/mcp-overview.html) 2.0+ (group `org.springframework.ai`):
177
177
178
178
```java
179
179
McpTransport transport = WebFluxSseClientTransport
Copy file name to clipboardExpand all lines: docs/index.md
+34-34Lines changed: 34 additions & 34 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,42 +10,43 @@ Use it to build MCP clients and MCP servers in Java 17 or later, with a synchron
10
10
11
11
The SDK implements two generations of the protocol, side by side in the same module:
12
12
13
-
-**Classic**, for the [2025-11-25](https://modelcontextprotocol.io/specification/2025-11-25) specification and earlier revisions, where client and server keep a session.
14
13
-**Modern**, for the stateless [2026-07-28](https://modelcontextprotocol.io/specification/2026-07-28) specification, where every request stands alone.
14
+
-**Legacy**, for the [2025-11-25](https://modelcontextprotocol.io/specification/2025-11-25) specification and earlier revisions, where client and server keep a session.
15
15
16
-
See [Classic or Modern?](overview.md#classic-or-modern) to choose between them.
16
+
The names are the specification's own, and legacy does not mean deprecated here: the SDK supports both.
17
+
See [Modern or Legacy?](overview.md#modern-or-legacy) to choose between them.
|[Completions](https://modelcontextprotocol.io/specification/2025-11-25/server/utilities/completion) for argument values | Yes | Yes |
28
-
|[Elicitation](https://modelcontextprotocol.io/specification/2025-11-25/client/elicitation): asking the user for input | Yes, as a request from the server| Yes, as a multi round-trip request (form and URL)|
29
-
|[Sampling](https://modelcontextprotocol.io/specification/2025-11-25/client/sampling)|Yes |Server only |
30
-
|[Roots](https://modelcontextprotocol.io/specification/2025-11-25/client/roots)|Yes |Server only |
29
+
|[Elicitation](https://modelcontextprotocol.io/specification/2025-11-25/client/elicitation): asking the user for input | Yes, as a multi round-trip request (form and URL)| Yes, as a request from the server|
30
+
|[Sampling](https://modelcontextprotocol.io/specification/2025-11-25/client/sampling)| Server only| Yes|
31
+
|[Roots](https://modelcontextprotocol.io/specification/2025-11-25/client/roots)| Server only| Yes|
|[Logging](https://modelcontextprotocol.io/specification/2025-11-25/server/utilities/logging)|Yes |No (deprecated by the revision) |
33
-
| Change notifications | Yes, over the session | Yes, with `subscriptions/listen`|
34
-
| Finding out what a server supports |`initialize` handshake |`server/discover`|
35
-
| Caching hints on results |No|Yes|
36
-
| Custom HTTP headers for tool arguments (SEP-2243) |No|Yes|
33
+
|[Logging](https://modelcontextprotocol.io/specification/2025-11-25/server/utilities/logging)| No (deprecated by the revision)| Yes|
34
+
| Change notifications | Yes, with `subscriptions/listen`| Yes, over the session|
35
+
| Finding out what a server supports |`server/discover`|`initialize` handshake|
36
+
| Caching hints on results |Yes|No|
37
+
| Custom HTTP headers for tool arguments (SEP-2243) |Yes|No|
37
38
38
39
Both implementations share the following:
39
40
40
41
-**Sync and async APIs.** Choose blocking calls or Project Reactor types.
41
-
-**Transports without a web framework.** STDIO, and Streamable HTTP on the JDK `HttpClient` (client) and the Servlet API (server). The classic implementation also has the legacy[SSE](https://modelcontextprotocol.io/specification/2025-11-25/basic/transports) transport.
42
+
-**Transports without a web framework.** STDIO, and Streamable HTTP on the JDK `HttpClient` (client) and the Servlet API (server). The legacy implementation also has the deprecated[SSE](https://modelcontextprotocol.io/specification/2025-11-25/basic/transports) transport.
42
43
-**Pluggable JSON serialization.** Jackson 3.x by default, or Jackson 2.x.
43
44
-**Security hooks.** Pluggable authorization hooks, and opt-in DNS rebinding protection with Host/Origin header validation (see [HTTP Transport Security](server.md#http-transport-security)).
44
45
45
46
!!! tip "Spring applications"
46
-
Spring WebFlux and WebMVC transports for the classic client and server are part of [Spring AI](https://docs.spring.io/spring-ai/reference/2.0-SNAPSHOT/api/mcp/mcp-overview.html) 2.0+ and are not shipped by this SDK.
47
-
Use the [MCP Client Boot Starter](https://docs.spring.io/spring-ai/reference/2.0-SNAPSHOT/api/mcp/mcp-client-boot-starter-docs.html) and the [MCP Server Boot Starter](https://docs.spring.io/spring-ai/reference/2.0-SNAPSHOT/api/mcp/mcp-server-boot-starter-docs.html) from Spring AI.
48
-
Also consider the [MCP Annotations](https://docs.spring.io/spring-ai/reference/2.0-SNAPSHOT/api/mcp/mcp-annotations-overview.html) and [MCP Security](https://docs.spring.io/spring-ai/reference/2.0-SNAPSHOT/api/mcp/mcp-security.html).
47
+
Spring WebFlux and WebMVC transports for the legacy client and server are part of [Spring AI](https://docs.spring.io/spring-ai/reference/2.1.0-SNAPSHOT/api/mcp/mcp-overview.html) 2.0+ and are not shipped by this SDK.
48
+
Use the [MCP Client Boot Starter](https://docs.spring.io/spring-ai/reference/2.1.0-SNAPSHOT/api/mcp/mcp-client-boot-starter-docs.html) and the [MCP Server Boot Starter](https://docs.spring.io/spring-ai/reference/2.1.0-SNAPSHOT/api/mcp/mcp-server-boot-starter-docs.html) from Spring AI.
49
+
Also consider the [MCP Annotations](https://docs.spring.io/spring-ai/reference/2.1.0-SNAPSHOT/api/mcp/mcp-annotations-overview.html) and [MCP Security](https://docs.spring.io/spring-ai/reference/2.1.0-SNAPSHOT/api/mcp/mcp-security.html).
49
50
50
51
## Getting Started
51
52
@@ -64,52 +65,51 @@ The [Quickstart](quickstart.md) covers versions, the BOM, Gradle, and the other
64
65
65
66
<divclass="grid cards"markdown>
66
67
67
-
-:rocket:{ .lg .middle } **Quickstart**
68
+
- :material-sitemap:{ .lg .middle } **Overview**
68
69
69
70
---
70
71
71
-
Get started with dependencies and BOM configuration.
72
+
Understand the architecture, and choose between modern and legacy.
0 commit comments