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

Zombie Task Collision in StreamableHTTPServerTransport Open

bug P2 ready for work

modelcontextprotocol/typescript-sdk#1186 · 3 comments · 1 assignee · Opened Nov 28, 2025
Support `roots/list` request from server to client Open

bug documentation enhancement fix proposed P2 ready for work

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

modelcontextprotocol/typescript-sdk#1167 · 6 comments · Opened Nov 25, 2025
Call schema on inputSchema validation failure Open

enhancement help wanted needs decision P3 v2

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

modelcontextprotocol/typescript-sdk#1160 · 4 comments · 1 reaction · Opened Nov 24, 2025
Server SDK support for scope challenges on tool calls Open

auth enhancement needs decision P2

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

modelcontextprotocol/typescript-sdk#1151 · 1 comment · 3 reactions · Opened Nov 21, 2025
Question: Tool list changed notification Open

documentation good first issue P3 potentially close question

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

modelcontextprotocol/typescript-sdk#1132 · 5 comments · Opened Nov 18, 2025
What is the recommended way of writing unit tests for MCP endpoints? Open

documentation P3 potentially close question ready for work v2

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

modelcontextprotocol/typescript-sdk#1126 · 2 comments · 1 reaction · Opened Nov 17, 2025
Support Secure Hashed Client Secrets in OAuthRegisteredClientsStore Open

auth enhancement help wanted needs decision P3 v2

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

modelcontextprotocol/typescript-sdk#1124 · 5 comments · Opened Nov 17, 2025
Can not create proxy OAuth flow with google OAuth Open

auth bug P2 ready for work

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

modelcontextprotocol/typescript-sdk#1112 · 5 comments · Opened Nov 14, 2025
Implement SEP-990: Enterprise Managed Authorization (Extension) Open

auth enhancement P3 ready for work

modelcontextprotocol/typescript-sdk#1090 · 4 comments · 1 assignee · Opened Nov 7, 2025
# MCP SDK ResourceTemplate URI Validation Issue: RFC 6570 Template Matching Behavior Open

bug fix proposed help wanted P2 ready for work

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

modelcontextprotocol/typescript-sdk#1079 · 8 comments · 2 reactions · Opened Nov 4, 2025
Implement SEP-1724: Extensions Open

enhancement needs decision P1 pending SEP approval v2

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

modelcontextprotocol/typescript-sdk#1063 · 1 comment · 1 reaction · Opened Oct 31, 2025
Implement SEP-1649: MCP Server Cards (.well-known Discovery) Open

enhancement needs decision P3 pending SEP approval

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

modelcontextprotocol/typescript-sdk#1059 · Opened Oct 30, 2025
[MCP-SDK] stdio client crashes with "MCP error -32000: Connection closed" when spawned server exits unexpectedly Open

bug P2 ready for work

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

modelcontextprotocol/typescript-sdk#1049 · 2 comments · Opened Oct 28, 2025
Zod types via `infer` make TypeScript types a lot less readable Open

enhancement needs decision P3 v2

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

modelcontextprotocol/typescript-sdk#1046 · 4 comments · 2 reactions · Opened Oct 27, 2025
Support upscoping on insufficient_scope 403 like in Python SDK Open

auth enhancement needs decision P3 potentially close

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

modelcontextprotocol/typescript-sdk#1039 · 2 comments · Opened Oct 23, 2025
Simplify public access to McpServer registered tools Open

enhancement needs decision P3

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

modelcontextprotocol/typescript-sdk#1036 · 1 comment · Opened Oct 21, 2025
ListTools request handler fails to generate inputSchema (jsonSchema) Open

bug P1 potentially close ready for work

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

modelcontextprotocol/typescript-sdk#1028 · 7 comments · 2 reactions · Opened Oct 15, 2025
storeEvent in EventStore Receives Hardcoded `streamId` Open

bug fix proposed P2 question ready for work

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

modelcontextprotocol/typescript-sdk#1004 · 2 comments · 1 reaction · Opened Oct 3, 2025
Bug Report-3: Missing Progress Monotonicity Validation Leading to Resource Exhaustion Open

bug fix proposed P2 ready for work

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

modelcontextprotocol/typescript-sdk#1001 · 2 comments · Opened Oct 2, 2025
Bug Report-2: Missing Periodic Ping Implementation Open

enhancement help wanted needs decision P2 v2

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

modelcontextprotocol/typescript-sdk#1000 · 1 comment · Opened Oct 2, 2025
Bug Report-1: Missing Cancellation Logging Implementation Open

bug enhancement P2 ready for work

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

modelcontextprotocol/typescript-sdk#999 · 2 comments · Opened Oct 2, 2025
CommonJS export paths broken - missing index.js file in dist/cjs Open

bug fix proposed P1 ready for work

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

modelcontextprotocol/typescript-sdk#971 · 8 comments · 2 reactions · Opened Sep 25, 2025
Simplify attribution of elicitation to a tool call Open

enhancement P3 ready for work v2

modelcontextprotocol/typescript-sdk#963 · 2 comments · 1 assignee · Opened Sep 23, 2025
Ability to pass custom context to tool handlers Open

enhancement needs decision P3 v2

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

modelcontextprotocol/typescript-sdk#956 · 4 comments · 2 reactions · Opened Sep 20, 2025
Prefer token endpoint auth method obtained during OAuth client registration Open

auth bug P2 potentially close ready for work

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

modelcontextprotocol/typescript-sdk#951 · 3 comments · 5 reactions · Opened Sep 18, 2025
Client error for command SSE stream disconnected: TypeError: terminated Open

bug fix proposed P3 ready for work

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

modelcontextprotocol/typescript-sdk#949 · 4 comments · Opened Sep 18, 2025
The bug in InMemoryEventStore break SSE stream resumability Open

bug fix proposed P2 ready for work

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

modelcontextprotocol/typescript-sdk#943 · 4 comments · Opened Sep 15, 2025
OAuth: scope parameter missing from token exchange requests Open

auth bug fix proposed P2 ready for work

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

modelcontextprotocol/typescript-sdk#941 · 1 comment · Opened Sep 13, 2025
Elicitation with custom input [ SEP-1456 ] Open

enhancement needs decision P3 pending SEP approval

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

modelcontextprotocol/typescript-sdk#932 · 1 comment · Opened Sep 10, 2025
Client#listPrompts results in MCP error -32601: Method not found Open

bug fix proposed P3 potentially close ready for work

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

modelcontextprotocol/typescript-sdk#929 · 5 comments · Opened Sep 9, 2025
Use types for tool annotations to reduce confusion Open

enhancement needs decision P3

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

modelcontextprotocol/typescript-sdk#927 · 2 comments · Opened Sep 8, 2025
【BUG】Use Koa server create StreamableHTTPServerTransport, when call tool， server crash! Open

bug needs confirmation potentially close

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

modelcontextprotocol/typescript-sdk#912 · 5 comments · Opened Sep 2, 2025
Implement consistent structuredContent handling per specification clarification Open

bug enhancement needs decision P3 pending SEP approval

modelcontextprotocol/typescript-sdk#911 · 1 reaction · 1 assignee · Opened Sep 1, 2025
McpServer re-registers capabilities after connect, blocking dynamic registration even when capabilities were supplied at construction Open

bug fix proposed P2 ready for work

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

modelcontextprotocol/typescript-sdk#893 · 3 comments · 3 reactions · Opened Aug 21, 2025
Issue: No Reliable Mapping Between sessionId and streamId for Stateless Resumability Open

enhancement needs decision P2 v2

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

modelcontextprotocol/typescript-sdk#892 · 8 reactions · Opened Aug 21, 2025
Request guidance/feature to stream streaming tool responses back Open

enhancement needs decision P3

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

modelcontextprotocol/typescript-sdk#886 · 1 comment · 2 reactions · Opened Aug 19, 2025
sse timeout set dont work & always close after 5mins Open

bug fix proposed improves spec compliance P2 ready for work

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

modelcontextprotocol/typescript-sdk#876 · 5 comments · Opened Aug 14, 2025
When executing client.close(), onerror will be executed twice (Streamable HTTP) Open

bug fix proposed P2 ready for work v2

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

modelcontextprotocol/typescript-sdk#868 · 8 comments · Opened Aug 12, 2025
StreamableHTTPClientTransport is not implementing Transport properly Open

bug needs design P3 potentially close v2

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

modelcontextprotocol/typescript-sdk#861 · 2 comments · 1 reaction · Opened Aug 10, 2025
Missing session reuse in browser: client.connect ignores mcp-session-id Open

bug documentation P1 potentially close question ready for work

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

modelcontextprotocol/typescript-sdk#852 · 9 comments · 4 reactions · Opened Aug 7, 2025
Bulk tool registration causes EventEmitter memory leak warnings Open

bug fix proposed P2 ready for work

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

modelcontextprotocol/typescript-sdk#842 · 4 comments · Opened Aug 5, 2025
Dynamic Tool Registration Based on Authentication Context Open

auth enhancement needs decision P3 v2

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

modelcontextprotocol/typescript-sdk#836 · 8 comments · 2 reactions · Opened Aug 3, 2025
Need to handle GET and POST differently in OAuthServerProvider.authorize handler Open

auth enhancement needs decision P3

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

modelcontextprotocol/typescript-sdk#830 · 1 comment · Opened Jul 31, 2025
Package attaches process signal handlers Open

bug fix proposed P2 ready for work v2

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

modelcontextprotocol/typescript-sdk#817 · 2 comments · Opened Jul 28, 2025
Cannot destructure property 'requestInfo' of 'undefined' as it is undefined. Open

bug fix proposed P2 ready for work

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

modelcontextprotocol/typescript-sdk#811 · 4 comments · 1 reaction · Opened Jul 24, 2025
disconnect method for MCP client Open

documentation enhancement needs confirmation P3

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

modelcontextprotocol/typescript-sdk#794 · 2 comments · 3 reactions · Opened Jul 20, 2025
onerror and other listener not remove after client close (stdio) Open

bug fix proposed P2 ready for work

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

modelcontextprotocol/typescript-sdk#780 · 4 comments · Opened Jul 18, 2025
invoke asyn method in mcp tool through StreamableHttpTransport cause early return from tool call Open

bug P1 potentially close ready for work

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

modelcontextprotocol/typescript-sdk#778 · 5 comments · 1 reaction · Opened Jul 17, 2025
[BUG] Multi-Node Deployment with Persistent Storage Mode not working Open

bug fix proposed P2 ready for work

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

modelcontextprotocol/typescript-sdk#776 · 5 comments · 2 reactions · Opened Jul 16, 2025
Memory leak in StreamableHTTP and SSE Open

bug fix proposed P2 ready for work v2

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

modelcontextprotocol/typescript-sdk#771 · 6 comments · 4 reactions · Opened Jul 16, 2025

modelcontextprotocol/typescript-sdk

Get new issues in your inbox