ModelContextPro.dev / Migration
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
| Surface | Legacy 2024/2025 SSE | 2026-07-28 Stateless Target |
|---|---|---|
| Transport | Dual endpoint (GET /sse + POST /messages?sessionId=...) | Single endpoint POST /mcp (Streamable HTTP, stateless per request) |
| Auth | Static API key in query string or server env | OAuth 2.1 / short-lived JWT in Authorization: Bearer + Resource Indicators |
| Tool Metadata | Freeform prose descriptions, missing annotations | Declarative descriptions + readOnlyHint / destructiveHint / idempotentHint |
| Multi-Agent Discovery | Manual client JSON config per host | Compile tools/list into an A2A v1.0.1 Agent Card via a2amcp.dev |
4-Step Cutover Checklist
- Step 1 — Audit existing tools: paste your live
tools/listresponse into the ModelContextPro.dev Linter and eliminate all FAIL rules. - Step 2 — Externalize session state: move cursor/pagination tokens into explicit tool parameters or signed opaque tokens rather than server RAM.
- Step 3 — Lock schemas & annotations: add
additionalProperties: falseand explicitrequiredfields on every tool. - Step 4 — Publish discovery card: feed the clean manifest into a2amcp.dev and verify its RFC 8785 JCS fingerprint on mcpa2a.dev.