modelcontextprotocol/python-sdk

Echo the input text

A demo tool with an icon.

A tool demonstrating multiple icons.

Send a text message to a phone number via https://surgemsg.com/

Echo the input text

Greet a user with optional title and repetition

Get current weather for a city with full structured data

Get a brief weather summary for a city

Get active weather alerts for a region

Get weather metrics for multiple cities Returns a dictionary mapping city names to their metrics

Get just the temperature for a city When returning primitives as structured output, the result is wrapped in {"result": value}

Get weather statistics for the past N days

Add two numbers

Take a screenshot of the user's screen and return it as an image. Use this tool anytime the user wants you to look at something they're doing.

A simple tool that demonstrates Unicode handling in: - Tool description (emojis, accents, CJK characters) - Parameter defaults (CJK characters) - Return values (Spanish punctuation, emojis)

Returns a list of emoji categories with emoji examples.

Returns hello in different scripts and writing systems.

List all shrimp names in the tank

Create a thumbnail from an image

Book a table with date availability check. This demonstrates form mode elicitation for collecting non-sensitive user input.

Process a secure payment requiring URL confirmation. This demonstrates URL mode elicitation using ctx.elicit_url() for operations that require out-of-band user interaction.

Connect to a third-party service requiring OAuth authorization. This demonstrates the "throw error" pattern using UrlElicitationRequiredError. Use this pattern when the tool cannot proceed without user authorization.

Get location coordinates

Get various statistics

Get user profile - returns structured data

This returns unstructured output - no schema generated

Get a list of cities

Add two numbers

Process some data

Say hello to someone.

Greet someone by name.

Tool to add two to the input

Get API status

Send a chat message

Return CallToolResult directly for full control including _meta field.

Return CallToolResult with structured output validation.

For empty results, return CallToolResult with empty content.

Generate a poem using LLM sampling.

Get domain-specific information

Execute a task with progress updates.

Tool that uses initialized resources.

Report which era the built-in router dispatched this request to.

Add a sticky note and register a `note:///{id}` resource for it.

Remove one sticky note and unregister its resource.

Remove every note after a confirmed form-mode elicitation (handshake-era only).

Emit one progress + one log notification per step; observes cancellation.

`who` arrives as a validated PersonModel instance.

`who` arrives as a plain dict; TypedDict drives the schema and editor hints.

`who` arrives as a PersonDC instance (pydantic coerces the wire dict).

`who` is a free-form object — any dict passes; the handler must check it.

Emit progress, close this call's SSE stream, emit more progress, then return. Everything sent after `close_sse_stream()` lands in the event store and is replayed when the client reconnects with `Last-Event-ID`.

Divide a by b. Division by zero is an execution error the LLM should see.

A tool that always rejects the caller at the protocol level.

Replace a note's text and tell subscribers that URI changed.

Register the `search` tool at runtime and tell subscribers the list changed.

Signal arrival as `tag`, block until every tag in `party` has also arrived, then return.

Tests simple text content response

Tests image content response

Tests audio content response

Tests embedded resource content response

Tests response with multiple content types (text, image, resource)

Tests tool that emits log messages during execution

Tests tool that reports progress notifications

Tests server-initiated sampling (LLM completion request)

Tests server-initiated elicitation (user input request)

Tests elicitation with default values for all primitive types (SEP-1034)

Tests elicitation with enum schema variations per SEP-1330

Tests error response handling

Tests SEP-2243 Mcp-Param-* server-side validation. Arms the http-custom-header-server-validation conformance scenario, which skips when no tool with an `x-mcp-header` annotation is found.

Tests that a handler-raised MISSING_REQUIRED_CLIENT_CAPABILITY surfaces as a top-level JSON-RPC error. Requires the client to declare the ``sampling`` capability. When absent, raises `MCPError` (which the tool dispatch re-raises rather than wrapping in ``CallToolResult.isError``) so the conformance harness observes a protocol-level error response with ``data.requiredCapabilities``.

Tests InputRequiredResult with a single elicitation request

Tests InputRequiredResult with a single sampling request

Tests InputRequiredResult with a single roots/list request

Tests requestState round-tripping in the InputRequiredResult flow

Tests InputRequiredResult carrying elicitation, sampling and roots requests together

Tests a three-round InputRequiredResult flow with evolving requestState

Tests that the server rejects a tampered requestState echo. The handler stays plaintext; tamper rejection happens in the SDK's request-state boundary.

Tests that inputRequests only include methods the client declared support for

Tests JSON Schema 2020-12 keyword preservation in tools/list (inputSchema installed below).

Tests SSE polling by closing stream mid-call (SEP-1699)

Mutates the tool list and announces it to subscriptions/listen streams (SEP-2575)

Mutates the prompt list and announces it to subscriptions/listen streams (SEP-2575)

Return the contextvar value visible to the handler.

Issue a voucher.

Send a log notification to the client.

Send a log notification with a dict payload.

Show the lifespan context.

Collect the new customer's details.

Ask where the party wants to sit.

Today's forecast for one city. Crashes: the upstream table is missing the key.

The week ahead for one city. Never called: it is the duplicate that gets dropped.

A tool still built on server-initiated sampling.

A tool still built on protocol logging.

A basic tool without icons.

Tool that checks lifespan context.

Emit one info-level log carrying the caller's label, then return it.

Emit n log notifications related to this call, plus one unrelated resource update.

Signal start, wait for the test, signal completion.

Emit, close this call's SSE stream, then emit again after the test releases the gate.

A tool removed at runtime; never called.

Buy an item.

Exchange a receipt token for the goods.

Report the extension identifiers the client advertised.

Upload a file.

Analyze text content.

First tool.

Second tool.

Third tool without metadata.

Tool with both metadata and annotations.

Order a book from the shop.

Reserve a copy of a book.

Recommend a book in the given genre.

A human-readable weather report for a city.

Daily forecast for a city.

Look up a weather station by name.

Current temperature for each city, in degrees Celsius.

Take the deposit that confirms a booking.

Record a payment reported by the payment provider.

Switch on the recommendation tool.

Search the catalog by title or author.

Describe how the catalog is organised.

Issue a new library card.

Which optional features the connected client declared.

List every note in the notebook.

Add a book to the catalog.

Look up the author of a book in the catalog.

Today's forecast for one city.

The next few hours for one city.

The brand logo as a PNG.

The brand logo as a PNG.

The brand guidelines as a Markdown document.

The brand colour palette as hex codes.

The notification chime as a WAV.

Look up a book by its exact title.

Save an instruction as a prompt the user can pick from the menu.

Search the library catalog.

Refresh the report data.

Refresh the dashboard data.

Import book records from a list of catalog URLs.

Import every record a catalog feed yields.

Put copies of a book back on the shelf.

Reserve copies of a book, asking the user how many.

Count the books in a genre.

Report whether the database connection is up.

Draft a blurb for a book.

Pick the folder the catalog export should go to.

Create a task.