ModelContextPro.dev / Migration
MIGRATION GUIDE · SSE → STATELESS HTTP

Migrating Legacy SSE MCP Servers to Stateless 2026-07-28

Eliminate sticky-session load balancers, broken reconnect loops, and untyped tool schemas in four deterministic stages.

Migration Matrix: Legacy SSE vs. 2026-07-28 Stateless

SurfaceLegacy 2024/2025 SSE2026-07-28 Stateless Target
TransportDual endpoint (GET /sse + POST /messages?sessionId=...)Single endpoint POST /mcp (Streamable HTTP, stateless per request)
AuthStatic API key in query string or server envOAuth 2.1 / short-lived JWT in Authorization: Bearer + Resource Indicators
Tool MetadataFreeform prose descriptions, missing annotationsDeclarative descriptions + readOnlyHint / destructiveHint / idempotentHint
Multi-Agent DiscoveryManual client JSON config per hostCompile tools/list into an A2A v1.0.1 Agent Card via a2amcp.dev

4-Step Cutover Checklist

Interoperability Cluster

Compile validated MCP tools to A2A v1.0.1 on a2amcp.dev →