github-featured/modelcontextprotocol--python-sdk

Files

T

History

Max Isbey f0e6057a19 Deprecate the legacy HTTP+SSE transport

The HTTP+SSE transport was superseded by Streamable HTTP in the 2025-03-26
spec revision and is formally deprecated under SEP-2596. Mark every public
entry point with typing_extensions.deprecated so type checkers flag it and a
runtime MCPDeprecationWarning fires: sse_client, SseServerParameters,
SseServerTransport, MCPServer.sse_app / run_sse_async, and the
run(transport="sse") overload. Nested constructions suppress the inner
warning so callers see exactly one.

Also: mcp run --transport help text drops sse, python -m mcp.client
connects with Streamable HTTP, and the url_elicitation client snippet
moves to Streamable HTTP. Docs and migration guide updated.

No-Verification-Needed: user requested immediate push, verification explicitly waived

2026-07-28 15:19:45 +00:00

clients

Deprecate the legacy HTTP+SSE transport

2026-07-28 15:19:45 +00:00

mcpserver

Add mcp.types as a permanent alias for mcp_types (#3190 )

2026-07-27 23:47:04 +01:00

servers

Deprecate the legacy HTTP+SSE transport

2026-07-28 15:19:45 +00:00

snippets

Deprecate the legacy HTTP+SSE transport

2026-07-28 15:19:45 +00:00

stories

Gate log notifications on the per-request log-level opt-in at 2026-07-28 (#3198 )

2026-07-28 02:20:33 +01:00

pyproject.toml

Add story-style examples suite (27 stories + harness + CI) (#2957 )

2026-06-26 12:02:27 +02:00

README.md

docs: restructure into topical sections and add the four most-asked-for pages (#3044 )

2026-07-01 21:06:04 +01:00

README.md

Python SDK examples

stories/ — the canonical reference. One self-verifying example per protocol feature, each with its own README. Start with stories/tools/; the stories README has the full table and how to run them.
snippets/ — short extracts that were embedded into the v1 README (now on the v1.x branch); superseded by docs_src/, which the docs and README embed today. Retained pending consolidation into stories/.
servers/everything-server/ — the conformance target for the cross-SDK conformance suite. Exercises every server capability in one process.
mcpserver/ — single-file v1-era examples retained for the migration guide; superseded by stories/ and slated for removal.
clients/ and the remaining servers/ directories (simple-*, sse-polling-demo, structured-output-lowlevel) — standalone v1-era projects retained pending consolidation into stories/ (the simple-auth pair is still linked from docs/run/authorization.md and docs/client/oauth-clients.md).

For real-world servers see the servers repository.