# MCP Python SDK

> The official Python SDK for the Model Context Protocol

## Docs

- [MCP Python SDK](https://py.sdk.modelcontextprotocol.io/v2/index.md)
- [What's new in v2](https://py.sdk.modelcontextprotocol.io/v2/whats-new/index.md)
- [Protocol versions](https://py.sdk.modelcontextprotocol.io/v2/protocol-versions/index.md)
- [Deprecated features](https://py.sdk.modelcontextprotocol.io/v2/deprecated/index.md)
- [Troubleshooting](https://py.sdk.modelcontextprotocol.io/v2/troubleshooting/index.md)
- [Migration Guide](https://py.sdk.modelcontextprotocol.io/v2/migration/index.md)

## Get started

- [Get started](https://py.sdk.modelcontextprotocol.io/v2/get-started/index.md)
- [Installation](https://py.sdk.modelcontextprotocol.io/v2/get-started/installation/index.md)
- [First steps](https://py.sdk.modelcontextprotocol.io/v2/get-started/first-steps/index.md)
- [Connect to a real host](https://py.sdk.modelcontextprotocol.io/v2/get-started/real-host/index.md)
- [Testing](https://py.sdk.modelcontextprotocol.io/v2/get-started/testing/index.md)

## Servers

- [Servers](https://py.sdk.modelcontextprotocol.io/v2/servers/index.md)
- [Tools](https://py.sdk.modelcontextprotocol.io/v2/servers/tools/index.md)
- [Structured Output](https://py.sdk.modelcontextprotocol.io/v2/servers/structured-output/index.md)
- [Resources](https://py.sdk.modelcontextprotocol.io/v2/servers/resources/index.md)
- [URI templates](https://py.sdk.modelcontextprotocol.io/v2/servers/uri-templates/index.md)
- [Prompts](https://py.sdk.modelcontextprotocol.io/v2/servers/prompts/index.md)
- [Completions](https://py.sdk.modelcontextprotocol.io/v2/servers/completions/index.md)
- [Images, audio & icons](https://py.sdk.modelcontextprotocol.io/v2/servers/media/index.md)
- [Handling errors](https://py.sdk.modelcontextprotocol.io/v2/servers/handling-errors/index.md)

## Inside your handler

- [Inside your handler](https://py.sdk.modelcontextprotocol.io/v2/handlers/index.md)
- [The Context](https://py.sdk.modelcontextprotocol.io/v2/handlers/context/index.md)
- [Dependencies](https://py.sdk.modelcontextprotocol.io/v2/handlers/dependencies/index.md)
- [Lifespan](https://py.sdk.modelcontextprotocol.io/v2/handlers/lifespan/index.md)
- [Elicitation](https://py.sdk.modelcontextprotocol.io/v2/handlers/elicitation/index.md)
- [Multi-round-trip requests](https://py.sdk.modelcontextprotocol.io/v2/handlers/multi-round-trip/index.md)
- [Sampling and roots](https://py.sdk.modelcontextprotocol.io/v2/handlers/sampling-and-roots/index.md)
- [Progress](https://py.sdk.modelcontextprotocol.io/v2/handlers/progress/index.md)
- [Logging](https://py.sdk.modelcontextprotocol.io/v2/handlers/logging/index.md)
- [Subscriptions](https://py.sdk.modelcontextprotocol.io/v2/handlers/subscriptions/index.md)

## Running your server

- [Running your server](https://py.sdk.modelcontextprotocol.io/v2/run/index.md)
- [Add to an existing app](https://py.sdk.modelcontextprotocol.io/v2/run/asgi/index.md)
- [Deploy & scale](https://py.sdk.modelcontextprotocol.io/v2/run/deploy/index.md)
- [Authorization](https://py.sdk.modelcontextprotocol.io/v2/run/authorization/index.md)
- [OpenTelemetry](https://py.sdk.modelcontextprotocol.io/v2/run/opentelemetry/index.md)
- [Serving legacy clients](https://py.sdk.modelcontextprotocol.io/v2/run/legacy-clients/index.md)

## Clients

- [The Client](https://py.sdk.modelcontextprotocol.io/v2/client/index.md)
- [Callbacks](https://py.sdk.modelcontextprotocol.io/v2/client/callbacks/index.md)
- [Transports](https://py.sdk.modelcontextprotocol.io/v2/client/transports/index.md)
- [OAuth](https://py.sdk.modelcontextprotocol.io/v2/client/oauth-clients/index.md)
- [Identity assertion](https://py.sdk.modelcontextprotocol.io/v2/client/identity-assertion/index.md)
- [Multiple servers](https://py.sdk.modelcontextprotocol.io/v2/client/session-groups/index.md)
- [Subscriptions](https://py.sdk.modelcontextprotocol.io/v2/client/subscriptions/index.md)
- [Caching](https://py.sdk.modelcontextprotocol.io/v2/client/caching/index.md)

## Advanced

- [Advanced](https://py.sdk.modelcontextprotocol.io/v2/advanced/index.md)
- [The low-level Server](https://py.sdk.modelcontextprotocol.io/v2/advanced/low-level-server/index.md)
- [Pagination](https://py.sdk.modelcontextprotocol.io/v2/advanced/pagination/index.md)
- [Middleware](https://py.sdk.modelcontextprotocol.io/v2/advanced/middleware/index.md)
- [Extensions](https://py.sdk.modelcontextprotocol.io/v2/advanced/extensions/index.md)
- [MCP Apps](https://py.sdk.modelcontextprotocol.io/v2/advanced/apps/index.md)

## Optional

- [mcp API reference](https://py.sdk.modelcontextprotocol.io/v2/api/mcp/): Auto-generated API reference for the mcp package (rendered HTML)
- [mcp-types API reference](https://py.sdk.modelcontextprotocol.io/v2/api/mcp_types/): Auto-generated API reference for the mcp-types package (rendered HTML)