MCP Python SDK

Python implementation of the Model Context Protocol (MCP)

This documents v1.x, the stable release line of the MCP Python SDK. v2 is in alpha.

v2 pre-releases are published to PyPI as 2.0.0aN. Installers never select a pre-release unless you opt in (for example pip install mcp==2.0.0a1), so v1.x users are unaffected. If your package depends on mcp, add a <2 upper bound to your version constraint (for example mcp>=1.27,<2) before the stable v2 release lands. See the v2 documentation and the migration guide for what's changing.

v1.x remains recommended for production use. It is in maintenance mode and continues to receive critical bug fixes and security patches.

MCP Python SDK

Overview

The Model Context Protocol allows applications to provide context for LLMs in a standardized way, separating the concerns of providing context from the actual LLM interaction. This Python SDK implements the full MCP specification, making it easy to:

Build MCP clients that can connect to any MCP server
Create MCP servers that expose resources, prompts and tools
Use standard transports like stdio, SSE, and Streamable HTTP
Handle all MCP protocol messages and lifecycle events

Installation

Adding MCP to your python project

We recommend using uv to manage your Python projects.

If you haven't created a uv-managed project yet, create one:

uv init mcp-server-demo
cd mcp-server-demo

Then add MCP to your project dependencies:

uv add "mcp[cli]"

Alternatively, for projects using pip for dependencies:

pip install "mcp[cli]"

Running the standalone MCP development tools

To run the mcp command with uv:

uv run mcp

Quickstart

Let's create a simple MCP server that exposes a calculator tool and some data:

"""
FastMCP quickstart example.

Run from the repository root:
    uv run examples/snippets/servers/fastmcp_quickstart.py
"""

from mcp.server.fastmcp import FastMCP

# Create an MCP server
mcp = FastMCP("Demo", json_response=True)


# Add an addition tool
@mcp.tool()
def add(a: int, b: int) -> int:
    """Add two numbers"""
    return a + b


# Add a dynamic greeting resource
@mcp.resource("greeting://{name}")
def get_greeting(name: str) -> str:
    """Get a personalized greeting"""
    return f"Hello, {name}!"


# Add a prompt
@mcp.prompt()
def greet_user(name: str, style: str = "friendly") -> str:
    """Generate a greeting prompt"""
    styles = {
        "friendly": "Please write a warm, friendly greeting",
        "formal": "Please write a formal, professional greeting",
        "casual": "Please write a casual, relaxed greeting",
    }

    return f"{styles.get(style, styles['friendly'])} for someone named {name}."


# Run with streamable HTTP transport
if __name__ == "__main__":
    mcp.run(transport="streamable-http")

Full example: examples/snippets/servers/fastmcp_quickstart.py

You can install this server in Claude Code and interact with it right away. First, run the server:

uv run --with mcp examples/snippets/servers/fastmcp_quickstart.py

Then add it to Claude Code:

claude mcp add --transport http my-server http://localhost:8000/mcp

Alternatively, you can test it with the MCP Inspector. Start the server as above, then in a separate terminal:

npx -y @modelcontextprotocol/inspector

In the inspector UI, connect to http://localhost:8000/mcp.

What is MCP?

The Model Context Protocol (MCP) lets you build servers that expose data and functionality to LLM applications in a secure, standardized way. Think of it like a web API, but specifically designed for LLM interactions. MCP servers can:

Expose data through Resources (think of these sort of like GET endpoints; they are used to load information into the LLM's context)
Provide functionality through Tools (sort of like POST endpoints; they are used to execute code or otherwise produce a side effect)
Define interaction patterns through Prompts (reusable templates for LLM interactions)
And more!

Documentation

Building Servers -- tools, resources, prompts, logging, completions, sampling, elicitation, transports, ASGI mounting
Writing Clients -- connecting to servers, using tools/resources/prompts, display utilities
Authorization -- OAuth 2.1, token verification, client authentication
Low-Level Server -- direct handler registration for advanced use cases
Protocol Features -- MCP primitives, server capabilities
Testing -- in-memory transport testing with pytest
API Reference
Experimental Features (Tasks)
Model Context Protocol documentation
Model Context Protocol specification
Officially supported servers

Contributing

We are passionate about supporting contributors of all levels of experience and would love to see you get involved in the project. See the contributing guide to get started.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Metadata

Release files for mcp 1.28.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcp 1.28.1
File	Size	Uploaded
mcp-1.28.1.tar.gz	638.5 kB	Jun 26, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for mcp 1.28.1
File	Interpreter	ABI	Platform	Reset
mcp-1.28.1-py3-none-any.whl 222.6 kB Jun 26, 2026	Python 3	none	any	Details

Total release size: 861.1 kB

Release files / mcp-1.28.1.tar.gz

Download URL	mcp-1.28.1.tar.gz
Size	638.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`d51e36a5f5644faea4f85ea649bfffa6bc6c26770d42798ad6a3de3d2ba69683`
BLAKE2b-256 checksum How to use checksums	`6e779450b8f251a13affb6281997d0523c4615f8a8b35d0b21ff30db3a5aac9d`
Upload date	Jun 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/modelcontextprotocol/python-sdk
Publishing commit: github.com/modelcontextprotocol/python-sdk/tree/777b8d06710c140e3606b0d4598e2aa48546c266

Workflow

Publishing configuration: github.com/modelcontextprotocol/python-sdk/blob/777b8d06710c140e3606b0d4598e2aa48546c266/.github/workflows/publish-pypi.yml
Publishing logs: github.com/modelcontextprotocol/python-sdk/actions/runs/28238252704/attempts/1

Artifact

Subject: mcp-1.28.1.tar.gz
SHA-256 checksum: d51e36a5f5644faea4f85ea649bfffa6bc6c26770d42798ad6a3de3d2ba69683 Verifying attestations

Release files / mcp-1.28.1-py3-none-any.whl

Download URL	mcp-1.28.1-py3-none-any.whl
Size	222.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`2726bca5e7193f61c5dde8b12500a6de2d9acf6d1a1c0be9e8c2e706437991df`
BLAKE2b-256 checksum How to use checksums	`e25ed118fce19f87a2e7d8101c35c8ae0ec289098a4df0ff244cec23e415aca0`
Upload date	Jun 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/modelcontextprotocol/python-sdk
Publishing commit: github.com/modelcontextprotocol/python-sdk/tree/777b8d06710c140e3606b0d4598e2aa48546c266

Workflow

Publishing configuration: github.com/modelcontextprotocol/python-sdk/blob/777b8d06710c140e3606b0d4598e2aa48546c266/.github/workflows/publish-pypi.yml
Publishing logs: github.com/modelcontextprotocol/python-sdk/actions/runs/28238252704/attempts/1

Artifact

Subject: mcp-1.28.1-py3-none-any.whl
SHA-256 checksum: 2726bca5e7193f61c5dde8b12500a6de2d9acf6d1a1c0be9e8c2e706437991df Verifying attestations