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 f27cfee
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: guides/mcp/migrate-2026-07-28.md
+8-6Lines changed: 8 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,9 +4,9 @@ type: guide
4
4
title: Migrate a Python MCP server to the 2026-07-28 specification
5
5
summary: Update a Python MCP server for the stateless 2026-07-28 specification by removing the initialize handshake, adopting the input_required round-trip, dropping deprecated features, and hardening authorization.
6
6
lang: en-US
7
-
content_version: 1
7
+
content_version: 2
8
8
status: reviewed
9
-
reviewed_on: 2026-09-06
9
+
reviewed_on: 2026-10-31
10
10
---
11
11
12
12
# Migrate a Python MCP server to the 2026-07-28 specification
@@ -33,8 +33,9 @@ and your authorization path satisfies the new issuer rules.
33
33
`resultType: "input_required"` plus the requests that need answers; the client retries
34
34
the original call with the answers attached in `inputResponses`.
35
35
-**Per-request version and routing headers (SEP-2243).**`MCP-Protocol-Version`
36
-
travels with every request (`2026-07-28`), and Streamable HTTP requests must include
37
-
`Mcp-Method` and `Mcp-Name` so infrastructure can route without parsing JSON bodies.
36
+
travels with every request (`2026-07-28`). Streamable HTTP requests must include
37
+
`Mcp-Method`; `Mcp-Name` is required only for `tools/call`, `resources/read`, and
38
+
`prompts/get`, matching the named parameter in each request.
38
39
-**Authorization hardening.** Authorization servers must return the `iss` parameter per
39
40
RFC 9207 (SEP-2468), clients must set `application_type` during dynamic registration
40
41
(SEP-837), and client credentials are issuer-bound — never reused across authorization
@@ -64,8 +65,9 @@ and your authorization path satisfies the new issuer rules.
64
65
5.**Upgrade the official Python SDK.** The TypeScript, Python, Go, and C# SDKs shipped
65
66
with the specification; the RC-to-final window was roughly ten weeks, so older SDK
66
67
versions predate the breaking changes.
67
-
6.**Update transports.** Drop the legacy HTTP+SSE transport on its one-year offramp and
68
-
emit the required `Mcp-Method` and `Mcp-Name` headers on Streamable HTTP.
68
+
6.**Update transports.** Drop the legacy HTTP+SSE transport on its one-year offramp. On
69
+
Streamable HTTP, send `Mcp-Method` on every POST and `Mcp-Name` only on
70
+
`tools/call`, `resources/read`, and `prompts/get`.
69
71
7.**Check the authorization path.** Validate `iss` per RFC 9207, set `application_type`
70
72
during registration, and keep one credential per issuer.
71
73
8.**Adopt caching metadata.** Annotate list responses with `ttlMs` and `cacheScope` so
0 commit comments