modelcontextprotocol/python-sdk

View on GitHub

The official Python SDK for Model Context Protocol servers and clients

Stars: 24.3k
Forks: 4k
Open beginner issues: 17
Indexed issues: 241
Avg merge: 1d 1h
Merged PRs (30d): 31

Dominant language: Python
License: MIT
Last GitHub push: Sep 16, 2026
Latest indexed: Sep 20, 2026
Contributing guide: Contributing guide
Code of conduct: Code of conduct
Beginner labels: good first issue help wanted

Beginner friendly Everything

Open All

241 issues indexed so far

Requests with "id": null silently misclassified as notifications Open

bug improves spec compliance P2

Difficulty 3/5 1-2 days Newbie friendliness 48/100

modelcontextprotocol/python-sdk#2057 · 10 comments · 1 reaction · Opened Feb 14, 2026
Replace Field(description=...) with proper docstrings in auth models Open

auth enhancement v2

Difficulty 3/5 1-2 days Newbie friendliness 52/100

modelcontextprotocol/python-sdk#2053 · 1 comment · Opened Feb 13, 2026
Audit MCPServer constructor parameters Open

enhancement v2

Difficulty 5/5 Over a week Newbie friendliness 35/100

modelcontextprotocol/python-sdk#2052 · 1 comment · Opened Feb 13, 2026
Refactor handler context to be transport- and handler-type-aware Open

P1 v2

Difficulty 5/5 Over a week Newbie friendliness 25/100

modelcontextprotocol/python-sdk#2021 · 1 comment · Opened Feb 9, 2026
find_context_parameter() fails to detect Context parameter in callable class instances Open

bug P3 v2

Difficulty 2/5 1-3 hours Newbie friendliness 55/100

modelcontextprotocol/python-sdk#1974 · 1 comment · Opened Jan 30, 2026
Per-Request Transport Configuration for MCP Clients Open

documentation enhancement v2

Difficulty 5/5 Over a week Newbie friendliness 38/100

modelcontextprotocol/python-sdk#1966 · 2 comments · 1 reaction · Opened Jan 27, 2026
Using transport="stdio" closes real stdio, causing ValueError after server exits Open

bug good first issue P3

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

modelcontextprotocol/python-sdk#1933 · 8 comments · Opened Jan 22, 2026
Trailing slash in OAuthMetadata's `issuer` causes issues with clients Open

auth bug P1 ready for work

Difficulty 3/5 1-2 days Newbie friendliness 58/100

modelcontextprotocol/python-sdk#1919 · 5 comments · 1 reaction · Opened Jan 21, 2026
Bug: String parameters starting with digits coerced to numbers, causing UUID data loss Open

bug P2 ready for work

Difficulty 3/5 1-2 days Newbie friendliness 65/100

modelcontextprotocol/python-sdk#1873 · 4 comments · Opened Jan 15, 2026
ClientAuthenticator ignores token_endpoint_auth_method="none" when client_secret is stored Open

auth bug needs confirmation needs decision P2

Difficulty 2/5 1-3 hours Newbie friendliness 72/100

modelcontextprotocol/python-sdk#1842 · 6 comments · Opened Jan 8, 2026
Clarify JSON-RPC error code for 'session not found' responses Open

enhancement improves spec compliance needs decision P2 pending SEP approval v2

Difficulty 5/5 Over a week Newbie friendliness 25/100

modelcontextprotocol/python-sdk#1821 · Opened Dec 31, 2025
client's `read_stream_writer` open after SSE disconnection hanging `.receive()` Open

bug P1 ready for work

Difficulty 3/5 1-2 days Newbie friendliness 42/100

modelcontextprotocol/python-sdk#1811 · 3 comments · Opened Dec 21, 2025
More control over stderr in stdio client Open

enhancement needs decision P3

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

modelcontextprotocol/python-sdk#1806 · 1 comment · Opened Dec 19, 2025
Possible ressource leak / race condition in streamable_http_client Open

bug needs confirmation

Difficulty 4/5 3-5 days Newbie friendliness 45/100

modelcontextprotocol/python-sdk#1805 · 10 comments · 2 reactions · Opened Dec 19, 2025
Implement server-side support for Client ID Metadata Documents (CIMD) Open

auth enhancement needs decision P2

Difficulty 5/5 Over a week Newbie friendliness 35/100

modelcontextprotocol/python-sdk#1801 · 3 comments · Opened Dec 18, 2025
Make JSON-RPC ID type coercion configurable Open

bug P3 v2

Difficulty 4/5 3-5 days Newbie friendliness 45/100

modelcontextprotocol/python-sdk#1795 · 2 comments · Opened Dec 17, 2025
Remove jsonschema dependency Open

enhancement P3 v2

Difficulty 3/5 1-2 days Newbie friendliness 48/100

modelcontextprotocol/python-sdk#1745 · 1 comment · Opened Dec 5, 2025
Improve exception tracebacks for easier debugging Open

enhancement P2 v2

Difficulty 4/5 3-5 days Newbie friendliness 35/100

modelcontextprotocol/python-sdk#1744 · 1 comment · Opened Dec 5, 2025
Extract OAuth flow logic into reusable components for proxy use cases Open

auth enhancement P1 v2

Difficulty 5/5 Over a week Newbie friendliness 25/100

modelcontextprotocol/python-sdk#1743 · 9 comments · 2 reactions · Opened Dec 5, 2025
Introduce typed error classes with metadata Open

breaking change enhancement P2 v2

Difficulty 5/5 Over a week Newbie friendliness 35/100

modelcontextprotocol/python-sdk#1742 · 1 comment · 3 reactions · Opened Dec 5, 2025
Support clean server shutdown Open

enhancement P1 v2

modelcontextprotocol/python-sdk#1739 · 1 comment · 2 reactions · 1 assignee · Opened Dec 5, 2025
Audit and document the MCP server publishing experience Open

enhancement P2 v2

Difficulty 4/5 3-5 days Newbie friendliness 45/100

modelcontextprotocol/python-sdk#1734 · 1 comment · Opened Dec 5, 2025
`auth` specification in `ClientSessionGroup` Open

auth enhancement help wanted needs decision P2

Difficulty 3/5 1-2 days Newbie friendliness 68/100

modelcontextprotocol/python-sdk#1723 · 4 comments · 1 reaction · Opened Dec 4, 2025
Document and provide hooks for sandboxing file and network access in MCP tools Open

documentation enhancement needs confirmation

Difficulty 5/5 Over a week Newbie friendliness 35/100

modelcontextprotocol/python-sdk#1705 · 28 comments · Opened Nov 28, 2025
Define and document the public Python SDK API surface Open

breaking change enhancement P1 ready for work v2

modelcontextprotocol/python-sdk#1701 · 4 comments · 2 reactions · 1 assignee · Opened Nov 28, 2025
Refactor func_metadata() into smaller components for schema & metadata generation Open

enhancement needs decision P3

Difficulty 5/5 Over a week Newbie friendliness 42/100

modelcontextprotocol/python-sdk#1700 · 1 comment · Opened Nov 28, 2025
Simplify and harden session lifecycle with an explicit state machine Open

enhancement P2 v2

Difficulty 5/5 Over a week Newbie friendliness 25/100

modelcontextprotocol/python-sdk#1691 · 2 comments · Opened Nov 28, 2025
MCP client doesn't not initialize new session when getting 404 session not found Open

bug improves spec compliance P2 ready for work

Difficulty 3/5 1-2 days Newbie friendliness 70/100

modelcontextprotocol/python-sdk#1676 · 4 comments · Opened Nov 26, 2025
Streamable HTTP transport drops requests immediately after `initialize` Open

bug P1 ready for work

Difficulty 2/5 1-3 hours Newbie friendliness 25/100

modelcontextprotocol/python-sdk#1675 · 1 comment · 2 reactions · Opened Nov 26, 2025
ServerSession methods (create_message, elicit_form) don't expose progress_callback parameter Open

enhancement needs decision P2

Difficulty 2/5 1-3 hours Newbie friendliness 72/100

modelcontextprotocol/python-sdk#1671 · 2 comments · Opened Nov 25, 2025
User-Agent header in sHTTP transport is not forwarded to auth flow Open

auth bug P2 ready for work

Difficulty 3/5 1-2 days Newbie friendliness 68/100

modelcontextprotocol/python-sdk#1664 · 5 comments · 1 reaction · Opened Nov 25, 2025
FastMCP configures logging on init, which messes up application-level logging Open

bug P2 ready for work

Difficulty 4/5 3-5 days Newbie friendliness 45/100

modelcontextprotocol/python-sdk#1656 · 7 comments · 6 reactions · Opened Nov 24, 2025
ClientDisconnect returns HTTP 500 Open

bug P2 ready for work

Difficulty 2/5 1-3 hours Newbie friendliness 76/100

modelcontextprotocol/python-sdk#1648 · 6 comments · 1 reaction · Opened Nov 20, 2025
OAuth: 403 responses without insufficient_scope incorrectly retry with same token Open

auth P3

Difficulty 2/5 1-3 hours Newbie friendliness 55/100

modelcontextprotocol/python-sdk#1602 · Opened Nov 10, 2025
Client tool call hangs forever if server crashes or connection dies when using streamable-http Open

bug P2 ready for work

Difficulty 3/5 1-2 days Newbie friendliness 55/100

modelcontextprotocol/python-sdk#1577 · 3 comments · 2 reactions · Opened Nov 5, 2025
OAuthClientProvider._handle_token_response expect json Open

bug P2 ready for work

Difficulty 2/5 1-3 hours Newbie friendliness 58/100

modelcontextprotocol/python-sdk#1523 · 1 reaction · Opened Oct 28, 2025
FastMCP: Support dynamic annotation updates Open

enhancement improves spec compliance P2

Difficulty 5/5 Over a week Newbie friendliness 35/100

modelcontextprotocol/python-sdk#1475 · 2 comments · 1 reaction · Opened Oct 13, 2025
Improve docs on how to use `instructions` on `InitializeResult` Open

documentation P1 ready for work

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

modelcontextprotocol/python-sdk#1464 · 4 comments · 1 reaction · Opened Oct 10, 2025
Response leak in SSE handlers Open

needs repro P2 ready for work

Difficulty 2/5 1-3 hours Newbie friendliness 58/100

modelcontextprotocol/python-sdk#1450 · 3 comments · Opened Oct 9, 2025
feat: enhance dynamic tool management with notifications and enable/disable Open

enhancement needs decision P1 v2

Difficulty 4/5 3-5 days Newbie friendliness 38/100

modelcontextprotocol/python-sdk#1429 · 4 comments · 2 reactions · Opened Oct 6, 2025
It is not possible to define a Resource that takes only the Context parameter as an argument. Open

bug improves spec compliance P2 ready for work

Difficulty 3/5 1-2 days Newbie friendliness 42/100

modelcontextprotocol/python-sdk#1405 · 2 comments · Opened Sep 26, 2025
ClientSession Error Handling Open

bug good first issue P1 ready for work

Difficulty 4/5 3-5 days Newbie friendliness 45/100

modelcontextprotocol/python-sdk#1401 · 22 comments · 7 reactions · Opened Sep 25, 2025
Lazy HTTP connections seem to make error handling difficult. Open

enhancement needs decision P2

Difficulty 4/5 3-5 days Newbie friendliness 30/100

modelcontextprotocol/python-sdk#1393 · Opened Sep 24, 2025
No default timeout for requests (unlike TS SDK) Open

enhancement improves sdk consistency needs decision P2

Difficulty 4/5 3-5 days Newbie friendliness 35/100

modelcontextprotocol/python-sdk#1374 · 4 comments · Opened Sep 17, 2025
Using /.well-known/ OAuth endpoints behind custom path on GKE Open

auth enhancement good first issue needs decision P2 question

Difficulty 4/5 3-5 days Newbie friendliness 45/100

modelcontextprotocol/python-sdk#1335 · 4 comments · Opened Sep 2, 2025
`stdio_server` uses unbuffered memory streams which can cause server to block and become unresponsive Open

bug P2 ready for work

Difficulty 2/5 1-3 hours Newbie friendliness 52/100

modelcontextprotocol/python-sdk#1333 · 1 comment · 1 reaction · Opened Sep 1, 2025
Implement consistent structuredContent handling per specification clarification Open

bug enhancement needs decision P3 pending SEP approval

Difficulty 5/5 Over a week Newbie friendliness 25/100

modelcontextprotocol/python-sdk#1332 · 1 comment · Opened Sep 1, 2025
Clients Using Storage Face Deadlock on Token Refresh for SSE Open

bug P2 ready for work

Difficulty 4/5 3-5 days Newbie friendliness 48/100

modelcontextprotocol/python-sdk#1326 · 4 comments · Opened Aug 30, 2025
Support selection of authorization servers from PRM document Open

auth enhancement

Difficulty 4/5 3-5 days Newbie friendliness 35/100

modelcontextprotocol/python-sdk#1319 · Opened Aug 28, 2025
Critical Token Refresh Bugs - Prevents Proactive Refresh Open

auth P1 ready for work

Difficulty 4/5 3-5 days Newbie friendliness 48/100

modelcontextprotocol/python-sdk#1318 · 9 comments · 6 reactions · Opened Aug 28, 2025

modelcontextprotocol/python-sdk

Get new issues in your inbox