Sandbox
@modelcontextprotocol/modelcontextprotocol

MCP specification, schema, and docs

This repository defines Model Context Protocol itself, including the TypeScript-first schema and the official documentation site. Builders use it as the source of truth when implementing or reviewing MCP behavior.

9,180 stars1.8k forksTypeScriptUpdated 6d ago
Who it's for

Builders who are implementing or documenting Model Context Protocol.

What it delivers

You can work from the protocol’s source of truth instead of piecing together scattered references.

What it does

Protocol specification

Defines the MCP spec in the repository as the canonical reference for protocol behavior.

TypeScript schema source

Keeps the protocol schema in TypeScript at `schema/2026-07-28/schema.ts`, with JSON Schema output alongside it.

Official documentation

Publishes the docs site from `docs/`, including spec pages, examples, extensions, and registry content.

Specification extensions process

Tracks protocol change proposals in `seps/`, with templates and rendered proposal documents.

README

Model Context Protocol (MCP)

Just heard of MCP and not sure where to start? Check out our documentation website.

This repo contains the:

  • MCP specification
  • MCP protocol schema
  • Official MCP documentation

The schema is defined in TypeScript first, but made available as JSON Schema as well, for wider compatibility.

The official MCP documentation is built using Mintlify and available at modelcontextprotocol.io.

Authors

The Model Context Protocol was created by David Soria Parra (@dsp) and Justin Spahr-Summers (@jspahrsummers).

Contributing

See CONTRIBUTING.md.

License

This project is licensed under the MIT License.

Files in the repo

Repository payload34 top-level entries
  • .claude-plugin
  • .github
  • blog
  • docs
  • plugins
  • schema
  • scripts
  • seps
  • tools
  • .gitattributes
  • .gitignore
  • .npmrc
  • .nvmrc
  • .prettierignore
  • .prettierrc.json
  • .prototools
  • AGENTS.md
  • AI_POLICY.md
  • ANTITRUST.md
  • CLAUDE.md
  • CODE_OF_CONDUCT.md
  • CONTRIBUTING.md
  • eslint.config.mjs
  • GOVERNANCE.md
  • LICENSE
  • MAINTAINERS.md
  • migrate_seps.js
  • package-lock.json
  • package.json
  • README.md
  • SECURITY.md
  • tsconfig.json
  • typedoc.config.mjs
  • typedoc.plugin.mjs

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More other

🎨 Best DeepSeek Harness Design Plugin. The open-source Claude Design alternative. 🖥️ Local-first desktop app. 🖼️ Your coding agent becomes the design engine: prototypes, landing pages, dashboards, slides, images & video — real files, HTML/PDF/PPTX/MP4 export. 🤖 Claude Code / Codex / Cursor / DeepSeek Harness / OpenCode & 20+ CLIs via BYOK.

95k
HKUDS/
Vibe-Trading

"Vibe-Trading: Your Personal Trading Agent"

33k
tinyhumansai/
openhuman

OpenHuman is an open source personal AI for Mac, Windows and Linux — local-first memory, agent orchestration, and deep research.

40k

Your Personal AI Assistant; easy to install, deploy on your own machine or on the cloud; supports multiple chat apps with easily extensible capabilities.

35k