MCP TypeScript SDK banner
modelcontextprotocol modelcontextprotocol

MCP TypeScript SDK

Development community intermediate

Description

> [!IMPORTANT] **This is the `main` branch which contains v2 of the SDK (currently in development, pre-alpha).** > > We anticipate a stable v2 release in Q1 2026. Until then, **v1.x remains the recommended version** for production use. v1.x will continue to receive bug fixes and security updates for

Installation

Terminal
claude install-skill https://github.com/modelcontextprotocol/typescript-sdk

README

MCP TypeScript SDK

[!IMPORTANT] **This is the `main` branch which contains v2 of the SDK (currently in development, pre-alpha).**

We anticipate a stable v2 release in Q1 2026. Until then, **v1.x remains the recommended version** for production use. v1.x will continue to receive bug fixes and security updates for at least 6 months after v2 ships to give people time to upgrade.

For v1 documentation, see the [V1 API docs](https://ts.sdk.modelcontextprotocol.io/). For v2 API docs, see [`/v2/`](https://ts.sdk.modelcontextprotocol.io/v2/).

Table of Contents

    undefined

Overview

The Model Context Protocol (MCP) allows applications to provide context for LLMs in a standardized way, separating the concerns of providing context from the actual LLM interaction.

This repository contains the TypeScript SDK implementation of the MCP specification. It runs on **Node.js**, **Bun**, and **Deno**, and ships:

    undefined

Packages

This monorepo publishes split packages:

    undefined

Tool and prompt schemas use [Standard Schema](https://standardschema.dev/) — bring Zod v4, Valibot, ArkType, or any compatible library.

Middleware packages (optional)

...