python-sdk/examples
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-07-25 20:23:36 +01:00
..
clients Replace httpx and httpx-sse with httpx2 (#2972) 2026-07-14 17:05:08 +01:00
mcpserver Replace httpx and httpx-sse with httpx2 (#2972) 2026-07-14 17:05:08 +01:00
servers Align with spec #3002: optional clientInfo, serverInfo in result _meta (#3143) 2026-07-23 12:00:36 +01:00
snippets Replace httpx and httpx-sse with httpx2 (#2972) 2026-07-14 17:05:08 +01:00
stories Rename scopes= to scope= on the client-credentials OAuth providers (#3166) 2026-07-25 20:23:36 +01:00
pyproject.toml Add story-style examples suite (27 stories + harness + CI) (#2957) 2026-06-26 12:02:27 +02:00
README.md docs: restructure into topical sections and add the four most-asked-for pages (#3044) 2026-07-01 21:06:04 +01:00

Python SDK examples

  • stories/ — the canonical reference. One self-verifying example per protocol feature, each with its own README. Start with stories/tools/; the stories README has the full table and how to run them.
  • snippets/ — short extracts that were embedded into the v1 README (now on the v1.x branch); superseded by docs_src/, which the docs and README embed today. Retained pending consolidation into stories/.
  • servers/everything-server/ — the conformance target for the cross-SDK conformance suite. Exercises every server capability in one process.
  • mcpserver/ — single-file v1-era examples retained for the migration guide; superseded by stories/ and slated for removal.
  • clients/ and the remaining servers/ directories (simple-*, sse-polling-demo, structured-output-lowlevel) — standalone v1-era projects retained pending consolidation into stories/ (the simple-auth pair is still linked from docs/run/authorization.md and docs/client/oauth-clients.md).

For real-world servers see the servers repository.