Skip to content

Commit db7ae5c

Browse files
committed
Update migration notes
Signed-off-by: Dariusz Jędrzejczyk <2554306+chemicL@users.noreply.github.com>
1 parent 265868d commit db7ae5c

1 file changed

Lines changed: 12 additions & 0 deletions

File tree

MIGRATION-2.0.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -214,6 +214,18 @@ The deprecated `Builder.customizeRequest(Consumer<HttpRequest.Builder>)` method
214214

215215
**Action:** Use `requestBuilder(HttpRequest.Builder)` for static request setup, or `httpRequestCustomizer(McpSyncHttpClientRequestCustomizer)` for per-request customization.
216216

217+
### `protocolVersions()` default now advertises all known versions
218+
219+
The default implementation of `protocolVersions()` on `McpTransport` and `McpServerTransportProviderBase` previously returned only `["2024-11-05"]`. It now returns all four versions the SDK understands:
220+
221+
```
222+
["2024-11-05", "2025-03-26", "2025-06-18", "2025-11-25"]
223+
```
224+
225+
**Impact for transport implementors:** If your custom `McpClientTransport` or `McpServerTransportProvider` did not override `protocolVersions()`, it will now advertise all four versions during protocol negotiation instead of just `2024-11-05`. This is the intended upgrade path for most transports, but if you need to restrict your transport to a specific set of versions, override `protocolVersions()` explicitly and return the desired list.
226+
227+
**Impact for users of built-in transports:** No action is required. `StdioClientTransport`, `StdioServerTransportProvider`, and `HttpServletStreamableServerTransportProvider` all advertise the full version list.
228+
217229
### SSE transports are deprecated
218230

219231
The HTTP+SSE client and server transports (and their supporting validator/exception types) are deprecated in favour of Streamable HTTP — `HttpClientStreamableHttpTransport` on the client, and `HttpServletStreamableServerTransportProvider` on the server. They still work; plan a move to Streamable HTTP.

0 commit comments

Comments
 (0)