modelcontextprotocol/typescript-sdk

View on GitHub

The official TypeScript SDK for Model Context Protocol servers and clients

Stars: 13.4k
Forks: 2.2k
Open beginner issues: 25
Indexed issues: 300
Avg merge: 3d 15h
Merged PRs (30d): 4

Dominant language: TypeScript
License: No license data
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

300 open issues indexed

OAuth token exchange fails with URL-encoded responses - assumes JSON format only Open

auth bug fix proposed P2 ready for work

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

modelcontextprotocol/typescript-sdk#759 · 4 comments · 2 reactions · Opened Jul 11, 2025
ProxyOAuthServerProvider fails with Zod validation error when using Ory Hydra as OAuth provider Open

auth bug fix proposed P2 ready for work

modelcontextprotocol/typescript-sdk#754 · 4 comments · 1 reaction · 1 assignee · Opened Jul 9, 2025
Feature: Retrieve info about registered Resources and execute them from a tool Open

enhancement needs decision P3 v2

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

modelcontextprotocol/typescript-sdk#741 · Opened Jul 7, 2025
Can we have a chatbot example that connected to multiple remote servers Open

documentation enhancement good first issue P3

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

modelcontextprotocol/typescript-sdk#740 · 4 comments · Opened Jul 7, 2025
Request time out issue repeatedly Open

bug needs repro potentially close

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

modelcontextprotocol/typescript-sdk#737 · 7 comments · Opened Jul 4, 2025
Prompts - Metadata attributes in prompt registration, similar to resource metadata or tool annotations Open

enhancement needs decision P3 v2

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

modelcontextprotocol/typescript-sdk#703 · 2 comments · Opened Jun 27, 2025
Resource completion performance: Consider client-side caching and fuzzy filtering Open

enhancement needs confirmation P3 question

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

modelcontextprotocol/typescript-sdk#690 · 2 comments · Opened Jun 23, 2025
Resource Templates: Support for display names vs values in completion and better handling of special characters in URI paths Open

enhancement needs decision P3 v2

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

modelcontextprotocol/typescript-sdk#688 · 3 comments · 1 reaction · Opened Jun 23, 2025
Dynamic MCP Tool Registration Not Available Mid-Chain or Same Cycle Open

enhancement needs confirmation P3 potentially close question

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

modelcontextprotocol/typescript-sdk#682 · 3 comments · Opened Jun 23, 2025
ResourceTemplate fails when user selects <Empty> for optional parameter Open

bug fix proposed P2 ready for work

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

modelcontextprotocol/typescript-sdk#677 · 5 comments · 1 reaction · Opened Jun 21, 2025
OAuth Request Should Accept client_id and client_secret via Headers, Not Just in the Request Body Open

auth enhancement needs decision P3

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

modelcontextprotocol/typescript-sdk#676 · 1 comment · Opened Jun 20, 2025
Please add the ability to supply the the registerClient and defaultScopes to the ProxyOAuthServerProvider Open

auth enhancement needs decision P3

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

modelcontextprotocol/typescript-sdk#674 · Opened Jun 20, 2025
update server examples to cover external authentication servers Open

auth documentation enhancement good first issue P3

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

modelcontextprotocol/typescript-sdk#658 · 1 comment · Opened Jun 18, 2025
SDK assumes one authorization server to be used from PRM Open

auth bug enhancement P3 ready for work

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

modelcontextprotocol/typescript-sdk#584 · Opened Jun 3, 2025
Enforcing Content-Type header on client requests Open

bug fix proposed P2 ready for work

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

modelcontextprotocol/typescript-sdk#581 · 1 comment · Opened Jun 2, 2025
Auth : Allow user provided routes to escape Auth middleware Open

auth enhancement needs decision P3

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

modelcontextprotocol/typescript-sdk#577 · 1 comment · Opened May 31, 2025
Invalid JSON RPC requests do not respond with an error Open

bug fix proposed improves spec compliance P2 ready for work

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

modelcontextprotocol/typescript-sdk#563 · 2 comments · 1 reaction · Opened May 29, 2025
Support the resources/subscribe method Open

enhancement needs design P2

modelcontextprotocol/typescript-sdk#558 · 6 comments · 3 reactions · 1 assignee · Opened May 27, 2025
tool/call results in 'Method not found' with StreamableHTTPServerTransport in stateful session after successful initialize (SDK v1.12.0) Open

bug P1 potentially close ready for work

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

modelcontextprotocol/typescript-sdk#553 · 4 comments · Opened May 27, 2025
Raw bytes support sending to mcp server in callTool method Open

bug enhancement needs decision P3

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

modelcontextprotocol/typescript-sdk#539 · 5 comments · Opened May 22, 2025
Bug Report: Tool Handlers Not Invoked with StdioServerTransport on macOS Open

bug P2 potentially close ready for work

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

modelcontextprotocol/typescript-sdk#509 · 3 comments · Opened May 17, 2025
SDK makes HTTPS fetches through an HTTP proxy Open

bug P2 ready for work

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

modelcontextprotocol/typescript-sdk#484 · 3 comments · 3 reactions · Opened May 12, 2025
MCP SDK Can not handle the MCP Servers with subpath Open

bug fix proposed P2 ready for work

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

modelcontextprotocol/typescript-sdk#471 · 9 comments · 1 reaction · Opened May 9, 2025
MCP SDK Path Handling Bug for Subpath Servers Open

bug fix proposed P2 ready for work

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

modelcontextprotocol/typescript-sdk#470 · 5 comments · Opened May 9, 2025
Subclassing McpServer causes tool invocation issues Open

bug needs confirmation potentially close

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

modelcontextprotocol/typescript-sdk#451 · 4 comments · Opened May 5, 2025
Cannot load a basic STDIO MCP server (JS) in claude desktop Open

bug needs confirmation potentially close question

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

modelcontextprotocol/typescript-sdk#419 · 3 comments · Opened Apr 28, 2025
Promise/async handling causes unhandled rejections Open

bug fix proposed P2 ready for work

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

modelcontextprotocol/typescript-sdk#392 · 4 comments · 2 reactions · Opened Apr 24, 2025
Allow receiving messages per stream in client sdk Open

enhancement needs decision P3

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

modelcontextprotocol/typescript-sdk#387 · Opened Apr 23, 2025
Allow Custom Client Features for MCP Tools Open

enhancement needs decision P3

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

modelcontextprotocol/typescript-sdk#370 · 1 comment · Opened Apr 20, 2025
SSEClientTransport Open

bug needs confirmation potentially close question

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

modelcontextprotocol/typescript-sdk#342 · 6 comments · Opened Apr 15, 2025
SSEServerTransport doesn't seem to close properly Open

bug fix proposed P2 ready for work

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

modelcontextprotocol/typescript-sdk#321 · 9 comments · 1 reaction · Opened Apr 12, 2025
The MCP client using a tool launched with uvx does not terminate. Open

bug needs confirmation potentially close

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

modelcontextprotocol/typescript-sdk#320 · 2 comments · Opened Apr 12, 2025
Support JSON schema in addition to zod Open

enhancement needs decision P1 v2

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

modelcontextprotocol/typescript-sdk#283 · 11 comments · 42 reactions · Opened Apr 7, 2025
Bug: npm spawn processes incorrectly use root directory instead of project directory Open

bug P1 potentially close ready for work

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

modelcontextprotocol/typescript-sdk#251 · 1 comment · 1 reaction · Opened Apr 1, 2025
Revoke tokens if authorization code presented a second time Open

auth bug enhancement fix proposed P1 ready for work

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

modelcontextprotocol/typescript-sdk#235 · 3 comments · Opened Mar 28, 2025
/token endpoint should validate redirect_uri matches Open

auth bug fix proposed P1 ready for work

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

modelcontextprotocol/typescript-sdk#209 · 3 comments · 1 reaction · Opened Mar 19, 2025
Add ways for server processes to self-terminate when host is gone Open

enhancement help wanted needs decision P3

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

modelcontextprotocol/typescript-sdk#208 · 2 comments · 1 reaction · Opened Mar 19, 2025
consider defaulting resetTimeoutOnProgress to True Open

enhancement needs decision P2 v2

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

modelcontextprotocol/typescript-sdk#192 · 5 reactions · Opened Mar 13, 2025
MCP should return empty instead of error if tools / prompts / resources are not defined Open

bug needs confirmation needs repro potentially close

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

modelcontextprotocol/typescript-sdk#181 · 9 comments · 3 reactions · Opened Mar 11, 2025
Expected manner to capture error details during startup Open

enhancement needs decision P3

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

modelcontextprotocol/typescript-sdk#153 · 5 comments · 1 reaction · Opened Feb 18, 2025
Unordered and partial query parameter matching Open

bug fix proposed P2 ready for work

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

modelcontextprotocol/typescript-sdk#149 · 5 comments · 6 reactions · Opened Feb 12, 2025
Additional parameters are not passed through to tools Open

bug fix proposed P2 ready for work

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

modelcontextprotocol/typescript-sdk#147 · 3 comments · Opened Feb 10, 2025
Better CORS defaults for SSE transport Open

enhancement needs decision P2

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

modelcontextprotocol/typescript-sdk#143 · 6 comments · Opened Feb 3, 2025
Publish on the JSR Open

enhancement P3 ready for work

modelcontextprotocol/typescript-sdk#74 · 1 comment · 2 reactions · 1 assignee · Opened Nov 27, 2024
Typechecking should fail on returning {} for all requests Open

bug P3 potentially close ready for work

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

modelcontextprotocol/typescript-sdk#42 · 2 comments · Opened Nov 8, 2024
Make it easy to send progress notifications from a request handler Open

enhancement needs decision P2

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

modelcontextprotocol/typescript-sdk#34 · 1 comment · Opened Nov 4, 2024
Automate sending pings from SSE servers Open

enhancement needs decision P2

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

modelcontextprotocol/typescript-sdk#28 · 1 comment · Opened Oct 28, 2024
Automatically create a new server from a template Open

enhancement needs confirmation P3

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

modelcontextprotocol/typescript-sdk#19 · Opened Oct 16, 2024
Add conveniences for MCP proxy pattern Open

enhancement needs decision P3

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

modelcontextprotocol/typescript-sdk#10 · Opened Oct 11, 2024
`Host` abstraction for multiple client → server connections in one process Open

enhancement needs decision P2

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

modelcontextprotocol/typescript-sdk#6 · 1 comment · 7 reactions · Opened Oct 3, 2024

modelcontextprotocol/typescript-sdk

Get new issues in your inbox