Second v2 beta. Pre-releases are opt-in only; pip install mcp still resolves to the stable 1.x line.
pip install mcp==2.0.0b2
# or
uv add "mcp==2.0.0b2"
The documentation has the full tutorial and API reference, and the migration guide covers coming from v1. Stable v2 is still targeted for 2026-07-28 alongside the spec release - keep pinning an exact version.
Highlights
httpx is replaced by httpx2 (#2972)
The SDK's HTTP stack now runs on httpx2 (>=2.5.0), the next-generation httpx fork with SSE support built in, replacing httpx + httpx-sse. Most code needs no changes; if you pass your own http_client into a transport, change the import to httpx2. Runtime behavior that changes:
- TLS verification uses the operating system trust store (via
truststore) instead of certifi's bundle. SSL_CERT_FILE / SSL_CERT_DIR are honored first.
- Loggers are renamed:
httpx -> httpx2, httpcore.* -> httpcore2.* - update logging filters that match on those names.
- SSE GET streams send
Accept: application/json, text/event-stream (previously exactly text/event-stream).
Client-side subscriptions/listen (#3047)
The client half of subscriptions/listen (SEP-2575), promised in the b1 notes: one context manager, async for consumption, typed events.