Initial Checks

• I confirm that I'm using the latest version of Pydantic AI
• I confirm that I searched for my issue in https://github.com/pydantic/pydantic-ai/issues before opening this issue

Description

https://ai.pydantic.dev/mcp/client/#streamable-http-client

Minor issue:
https://ai.pydantic.dev/mcp/client/#usage says "two" and then lists three

Major issue:
https://ai.pydantic.dev/mcp/client/#streamable-http-client
The MCP server only has an add function, but then "What's happening" describes it calling run_python_code, which sounds like a really cool tool, but isn't elsewhere in the doc. The MCP server code and the "What's happening" should agree with eachother.

I ended up making a fancier example serve with Pydantic models (https://github.com/Azure-Samples/python-ai-agent-frameworks-demos/blob/main/examples/mcp_server_basic.py) but the add function would be fine too, if the description was consistent.

Example Code

Docs issue

Python, Pydantic AI & LLM client version

Docs issue