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 b0b8010
Browse filesBrowse the repository at this point in the historyBrowse files
- Spring AI 2.1+ integrates the modern client and server; both modern
guides gain a "Spring" section and drop it from "Not Yet Supported".
- Legacy server guide: spec links point to the 2025-11-25 revision.
- Documentation development page: project structure matches the folder.
Signed-off-by: Christian Tzolov <christian.tzolov@broadcom.com>
Copy file name to clipboardExpand all lines: docs/client-modern.md
+6-1Lines changed: 6 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -194,6 +194,12 @@ is closed, every open call fails with `McpResponseLostException`.
194
194
`StdioMcpClientTransport.builder(InputStream, OutputStream)` runs over streams that are already connected,
195
195
such as a socket's.
196
196
197
+
### Spring
198
+
199
+
Spring Boot integration for the modern client is part of Spring AI 2.1+, not of this SDK. Its MCP Client Boot
200
+
Starter configures modern connections and exposes their tools to Spring AI as tool callbacks. See
201
+
[MCP Client Boot Starter](https://docs.spring.io/spring-ai/reference/2.1.0-SNAPSHOT/api/mcp/mcp-client-boot-starter-docs.html) in the Spring AI reference.
202
+
197
203
### Custom Transports
198
204
199
205
Other transports implement `McpClientTransport`. Its single method, `exchange(McpTransportRequest)`, sends one
@@ -739,7 +745,6 @@ Failures outside those two types:
739
745
- Servers of earlier revisions. Use the [legacy client](client.md) for those.
740
746
- Obtaining OAuth tokens. Add tokens with a request customizer, as shown in
741
747
[Identity and Authorization](#identity-and-authorization).
Copy file name to clipboardExpand all lines: docs/index.md
+1Lines changed: 1 addition & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -46,6 +46,7 @@ Both implementations share the following:
46
46
!!! tip "Spring applications"
47
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
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
+
For the modern client and server, Spring AI 2.1+ provides Boot starters and Spring transports; see [MCP Client Boot Starter](https://docs.spring.io/spring-ai/reference/2.1.0-SNAPSHOT/api/mcp/mcp-client-boot-starter-docs.html) and [MCP 2026-07-28 Servers](https://docs.spring.io/spring-ai/reference/2.1.0-SNAPSHOT/api/mcp/mcp-modern-server-boot-starter-docs.html).
49
50
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).
Copy file name to clipboardExpand all lines: docs/overview.md
+1Lines changed: 1 addition & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -116,6 +116,7 @@ The SDK is organized into modules to separate concerns and allow adopters to bri
116
116
A minimal adopter may depend only on `mcp` (core + Jackson 3).
117
117
118
118
Spring-based applications that use the legacy client or server should use the `mcp-spring-webflux` or `mcp-spring-webmvc` artifacts 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`), which are no longer part of this SDK.
119
+
For the modern client and server, Spring AI 2.1+ provides Boot starters and Spring transports; see [MCP Client Boot Starter](https://docs.spring.io/spring-ai/reference/2.1.0-SNAPSHOT/api/mcp/mcp-client-boot-starter-docs.html) and [MCP 2026-07-28 Servers](https://docs.spring.io/spring-ai/reference/2.1.0-SNAPSHOT/api/mcp/mcp-modern-server-boot-starter-docs.html).
Copy file name to clipboardExpand all lines: docs/quickstart.md
+2Lines changed: 2 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -128,6 +128,8 @@ This is all a client needs. It includes the modern and the legacy client and ser
128
128
129
129
With the `spring-ai-bom` or the Spring AI starters (`spring-ai-starter-mcp-server-webflux`, `spring-ai-starter-mcp-server-webmvc`, `spring-ai-starter-mcp-client-webflux`), no explicit version is needed.
130
130
131
+
For the modern client and server, Spring AI 2.1+ provides Boot starters and Spring transports; see [MCP Client Boot Starter](https://docs.spring.io/spring-ai/reference/2.1.0-SNAPSHOT/api/mcp/mcp-client-boot-starter-docs.html) and [MCP 2026-07-28 Servers](https://docs.spring.io/spring-ai/reference/2.1.0-SNAPSHOT/api/mcp/mcp-modern-server-boot-starter-docs.html).
132
+
131
133
## Your First Client
132
134
133
135
The SDK has two clients, one for each generation of the protocol; see [Modern or Legacy?](overview.md#modern-or-legacy) to choose. Both examples list the tools of a server at `http://localhost:8080/mcp` and call one of them.
Copy file name to clipboardExpand all lines: docs/server-modern.md
+6-2Lines changed: 6 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,7 +8,7 @@ description: Build a stateless MCP server for the 2026-07-28 specification revis
8
8
!!! note
9
9
The modern server is available since 2.2.0. Its API, in the `io.modelcontextprotocol.modern` packages,
10
10
may change in minor releases until 3.0, and [some parts of the revision](#not-yet-supported) are not
11
-
implemented. For production servers that talk to today's clients, use the [legacy server](server.md).
11
+
implemented. For clients that speak earlier revisions, use the [legacy server](server.md).
12
12
To call a modern server from Java, see the [modern client](client-modern.md).
13
13
14
14
## Overview
@@ -261,6 +261,11 @@ STDIO has no headers and no `contextExtractor`: handlers always see a transport
261
261
so anything that reads identity from `transportContext()`, such as a `requestState`
262
262
[principal binding](#securing-requeststate), has nothing to read.
263
263
264
+
### Spring
265
+
266
+
Spring WebMVC and WebFlux transports for the modern server, and a Boot starter that configures it, are part
267
+
of Spring AI 2.1+, not of this SDK. See [MCP 2026-07-28 Servers](https://docs.spring.io/spring-ai/reference/2.1.0-SNAPSHOT/api/mcp/mcp-modern-server-boot-starter-docs.html) in the Spring AI reference.
268
+
264
269
### HTTP Security
265
270
266
271
Authentication and authorization belong in servlet filters in front of `HttpServletMcpTransport`, including
@@ -948,7 +953,6 @@ record TaskChanged(String taskId) implements ServerChange {
948
953
949
954
- Tasks.
950
955
- Logging, which the 2026-07-28 revision deprecates. The modern server never sends log messages.
951
-
- Spring WebMVC and WebFlux transports. Spring AI's transports target the legacy server.
Copy file name to clipboardExpand all lines: docs/server.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -359,7 +359,7 @@ var capabilities = ServerCapabilities.builder()
359
359
360
360
### Tool Specification
361
361
362
-
The Model Context Protocol allows servers to [expose tools](https://spec.modelcontextprotocol.io/specification/2024-11-05/server/tools/) that can be invoked by language models.
362
+
The Model Context Protocol allows servers to [expose tools](https://modelcontextprotocol.io/specification/2025-11-25/server/tools) that can be invoked by language models.
363
363
The Java SDK allows implementing Tool Specifications with their handler functions.
364
364
Tools enable AI models to perform calculations, access external APIs, query databases, and manipulate files.
365
365
@@ -681,7 +681,7 @@ var resourceTemplateSpec = new McpServerFeatures.SyncResourceTemplateSpecificati
681
681
682
682
### PromptSpecification
683
683
684
-
As part of the [Prompting capabilities](https://spec.modelcontextprotocol.io/specification/2024-11-05/server/prompts/), MCP provides a standardized way for servers to expose prompt templates to clients.
684
+
As part of the [Prompting capabilities](https://modelcontextprotocol.io/specification/2025-11-25/server/prompts), MCP provides a standardized way for servers to expose prompt templates to clients.
685
685
ThePromptSpecification is a structured template forAI model interactions that enables consistent message formatting, parameter substitution, context injection, response formatting, and instruction templating.
686
686
687
687
==="Sync"
@@ -846,7 +846,7 @@ Completions can be registered for both `PromptReference` and `ResourceReference`
846
846
847
847
### UsingSampling from a Server
848
848
849
-
To use [Sampling capabilities](https://spec.modelcontextprotocol.io/specification/2024-11-05/client/sampling/), connect to a client that supports sampling.
849
+
To use [Sampling capabilities](https://modelcontextprotocol.io/specification/2025-11-25/client/sampling), connect to a client that supports sampling.
850
850
No special server configuration is needed, but verify client sampling support before making requests.
851
851
Learn about [client sampling support](client.md#sampling-support).
0 commit comments