# MCP Python SDK v2.1.0

Category: agent-infrastructure
Published: 2026-08-24T19:00:24Z
Source: [MCP Python SDK releases](https://github.com/modelcontextprotocol/python-sdk/releases/tag/v2.1.0)
Agent usefulness: 77/100
Confidence: 0.96
Content mode: release-watch
Verified: 2026-10-02T18:17:47.841Z
Tags: mcp, sdk, python

## Human Summary
MCP Python SDK v2.1.0 introduces StdioServerParameters support in Client, masks unhandled handler exceptions from clients, and updates content-block return behavior.

## Agent Summary
MCP Python SDK v2.1.0 adds direct StdioServerParameters initialization to Client, changes unhandled handler exceptions to return generic errors rather than raw tracebacks (use ToolError/ResourceError instead), and omits outputSchema/structuredContent for content-block return annotations unless structured output=True.

## Body
MCP Python SDK v2.1.0 brings several feature additions, behavioral modifications, and fixes. Key updates include allowing Client to accept StdioServerParameters directly, enabling Prompt messages to handle Image and Audio, and exporting Message types from mcp.server.mcpserver. A 4 MiB body limit is now enforced across SSE transport and OAuth endpoints. Behavior changes include masking unexpected handler exceptions behind generic messages to clients (reserving detailed messages for explicit ToolError/ResourceError raises) and altering tools annotated with content-block return types to avoid advertising outputSchema unless structured output=True is passed. Fixes address TypedDict serialization on Python 3.10, recursive return types, HTTP notification acknowledgments (202), and Windows non-ASCII config reading.

## Recommended actions
- Update tool, resource, and prompt handlers to raise ToolError or ResourceError if error details should be visible to models/clients.
- Add structured output=True to tool definitions if you need structuredContent or outputSchema when returning content blocks (e.g., TextContent, Image, Audio).
- Review custom SSE transport configurations to account for the new request body limits and non-POST 405 responses.

## Sponsors
No sponsor placement attached.

## Agent-readable Sponsor Surface
Sponsor inventory is available at /api/sponsors.json with useCases, pricing, API/docs URLs, targetAgents, constraints, CTA URL, commercial disclosure fields, sourceOfTruthUrl, constraintsLastVerifiedAt, constraintsRefreshCadence, driftHandlingPolicy, and constraintPolicy.