modelcontextprotocol/python-sdk

Tool that uses initialized resources

A test tool with an icon.

A tool with multiple icons.

Send a log notification to the client.

Send a log notification with a dict payload.

Return the contextvar value visible to the handler.

Get weather for a city - returns structured data.

Get location coordinates

Get various statistics

Get user profile - returns structured data

This returns unstructured output - no schema generated

Get a list of cities

Get temperature as a simple float

Get API status

Send a chat message

A simple hello tool

Get domain-specific information

Tool to add two to the input

Add two numbers

Create a thumbnail from an image

Generate a poem using LLM sampling.

Tool that checks lifespan context.

A greeting tool

Echo a message back.

Upload a file.

Analyze text content.

First tool.

Second tool.

Third tool without metadata.

Tool with both metadata and annotations.

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.

Process data with logging.

Execute a task with progress updates.

Return CallToolResult directly for full control including _meta field.

Return CallToolResult with structured output validation.

For empty results, return CallToolResult with empty content.

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 SSE polling by closing stream mid-call (SEP-1699)

Get the current server time. This tool demonstrates that system information can be protected by OAuth authentication. User must be authenticated to access it.

Get a brief weather summary for a city

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

Get active weather alerts for a region

Get weather statistics for the past N days

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.

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

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.

Greet a user with optional title and repetition

Echo the input text

A demo tool with an icon.

List all shrimp names in the tank