MCP TypeScript SDK (V2) / @modelcontextprotocol/client

@modelcontextprotocol/client

The MCP (Model Context Protocol) TypeScript client SDK. Build MCP clients that connect to MCP servers.

This is v2 of the MCP TypeScript SDK, the stable release line, implementing the 2026-07-28 MCP spec. It replaces the single @modelcontextprotocol/sdk package from v1. Start with the documentation; coming from v1, see the migration guide. Found a problem? Open an issue.

Install

npm install @modelcontextprotocol/client

TypeScript ≥6.0 no longer auto-includes @types/* — add "types": ["node"] to your tsconfig.json compilerOptions (the published .d.mts references Buffer).

Documentation

• Repository README — overview, package layout, examples
• Client guide — connecting, calling tools, OAuth, and middleware
• API reference
• MCP specification

Modules

• client/auth
• client/auth.examples
• client/authErrors
• client/authExtensions
• client/authExtensions.examples
• client/authSeam
• client/client
• client/client.examples
• client/crossAppAccess
• client/dpop
• client/middleware
• client/middleware.examples
• client/probeClassifier
• client/responseCache
• client/sse
• client/stdio
• client/streamableHttp
• client/streamableHttp.examples
• client/versionNegotiation
• ext/skills
• ext/skills/entries
• ext/skills/errors
• ext/skills/pageSchemas
• ext/skills/skillsClient
• ext/skills/verify
• fromJsonSchema
• index
• shimsBrowser
• shimsNode
• shimsWorkerd
• stdio
• validators/ajv
• validators/cfWorker