typescript-sdk
The official MCP TypeScript SDK supplies a protocol foundation for teams exposing tools and resources to agents or connecting their own host to MCP services. Current v2 uses separate server and client packages, while the older @modelcontextprotocol/sdk package remains the v1 maintenance line. Identify the version before combining examples, transports and error-handling code; similar names do not establish that objects from the two generations are interchangeable.
We ran client and server 2.4.0 with Zod 4.1.12 on Node.js 26.6.0 using a synthetic stdio service. Initialization and discovery succeeded, adding 2 and 3 returned 5, and a string supplied for a numeric field was rejected before the addition handler ran again. A controlled handler failure returned isError true, while an unknown tool produced a protocol exception with code -32602. Resource reads exposed the invocation count, and a fresh server process started at zero.
This checks local protocol contracts without calling a model or real business service. It does not verify HTTP deployment, OAuth, shared multi-user state, Bun or Deno. Schema validation checks argument structure, not whether the current user may perform a business action. Hosts still need completion criteria, authorization, cleanup and handling for the application-specific content returned by the services they use.
Read the full review, verification scope and sources →Features
Why choose it
Trade-offs
Maintenance check
- Last commit
- 2026-11-10
- Commits, last 90 days
- 85
- Releases, last 90 days
- 30
- Latest release
- v2.4.0 (2026-10-23)
- Open issues
- 661
- Recent issues with at least one comment
- 19/20
Oldest week on the left; the latest four weeks are orange. Source: GitHub commit activity.
Status rule: archived on GitHub = Archived; last commit within 90 days = Active; 91 to 365 days = Slowing; older = Stale. All figures come from the GitHub API on the date shown.
Most discussed open issues
- #1238 Feature Request: Middleware support for McpServer15 comments · 2025-12-05
- #2695 `maxTotalTimeout` is never enforced unless a progress notification arrives12 comments · 2026-08-21
- #3053 Streamable HTTP: the POST for a cancelled request never settles11 comments · 2026-10-19
- #2677 tools/list emits draft-07 $schema for Zod v4 schemas: toJsonSchemaCompat is called without a target, and mapMiniTarget defaults to 'draft-7'8 comments · 2026-08-17
Issue titles are quoted from GitHub. Open the link to check whether a problem still applies to the version you use.
Who it fits
- You are implementing a TypeScript MCP service or host and want direct control of protocol integration.
- You can maintain contract tests for valid input, failures, lifecycle and the versions of connected peers.
- You only need an already configured agent rather than a protocol library.
- You cannot yet allocate work for business authorization and deployment beyond a local demo.
Compatibility
Quick start
Use cases
Alternatives
Comments
No comments yet. Be the first!