Description

Asim-dev-web

opened on Aug 16, 2026

Issue body actions

What happened?

README, under "A client in 10 lines":

"Swap mcp for http://localhost:8000/mcp and the exact same code talks to a remote server."

localhost is the same machine though, not remote. I think what's meant is that
the client is now going through an actual transport (HTTP) instead of talking directly to an in-memory object, which makes sense, but "remote" is a bit confusing to read literally.

What did you expect?

No response

Code to reproduce

https://github.com/modelcontextprotocol/python-sdk#a-client-in-10-lines

SDK version

No response

Area

None

Activity

1. Asim-dev-web

   added

   v2Affects the v2 line (2.x on main)Affects the v2 line (2.x on main)

   on Aug 16, 2026
2. maxisbey

   added a commit that references this issue on Aug 16, 2026

   docs: lead the README client example with a URL, not the server object

   This issue will close once commit d64e623 is merged into the 'main' branch.

   d64e623
3. maxisbey

   closed this as completedin #3315on Aug 16, 2026
4. maxisbey commented on Aug 16, 2026

   

   maxisbey

   on Aug 16, 2026

   Contributor

   More actions

   Fair point! I've changed the README to just show how to connect to it via shttp to reduce confusion. I'll also push up some PRs to fix the rest of the docs so this is more consistent/clear :)

   Thanks for the issue @Asim-dev-web!

Issue actions