modelcontextprotocol

modelcontextprotocol: Define the Model Context Protocol

The Model Context Protocol repository maintains the MCP specification, its TypeScript-first protocol schema, and official documentation. It is a reference for developers building or integrating software that communicates through MCP.

Stars
9.6k
Forks
1.9k
Stars, last 30 days
+236
Last commit
today
Contributors
100+

Our take

Activeregular commits and releases

Health score

71/100

How it is scored
Activity
69
Community
91
Issues
67
Pull requests
57

+236 stars in the last 30 days

  • Merges more pull requests than 80% of the projects we track
  • More contributors than 78% of the projects we track

This is an active, well-supported reference repository for teams adopting MCP, rather than a ready-to-run protocol implementation.

Good fit if

  • You are implementing or integrating MCP and need its canonical specification and schema.
  • Your tooling can work with TypeScript or JSON Schema references.
  • You want documentation maintained alongside protocol definitions, with recent commits and releases and contributions from a broad contributor base.

Look elsewhere if

  • You need a runnable MCP client or server rather than protocol documentation and definitions.
  • You need a project that provides tests or a packaged installation path in this repository, neither of which is specified in the supplied project information.
  • Your environment cannot meet the Node.js 24 or newer requirement for working with the repository.
All health signals
Last commit2026-10-30 (today)
Commits, last 90 days100+
Releases, last 12 months4 (latest 2026-07-28, 2026-07-28)
Contributors100+ (top contributor: 21% of commits)
Issues closed, last 90 days23+ (typically closed in 4 days)
Pull requests merged, last 90 days67 (typically merged in 1 day)
Project age2 years

Checked on 2026-10-31 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

9,714

Forks

1,918

Change since Nov 17, 2026: +11 stars·+5 forks

Overview

The Model Context Protocol (MCP) repository is the home of the MCP specification, protocol schema, and official documentation. Its schema is defined in TypeScript first and also provided as JSON Schema, giving developers a shared reference for implementing and integrating the protocol.

MCP is intended for developers who need a common protocol for communication between software components. This repository defines and explains that protocol; it is not itself an MCP client or server implementation. The documentation is published at modelcontextprotocol.io.

Key Features

  • Defines the Model Context Protocol specification.
  • Maintains a protocol schema authored in TypeScript.
  • Provides the schema in JSON Schema format for broader compatibility.
  • Publishes official MCP documentation through Mintlify.
  • Accepts contributions through the repository's contribution process.

Use Cases

  • A developer implementing an MCP-compatible client can consult the specification and schema as reference material.
  • A team building an MCP server can use the protocol definitions to guide its implementation.
  • Maintainers of tools that exchange data through MCP can refer to the JSON Schema when working across languages.
  • Developers evaluating MCP can use the official documentation to understand the protocol before choosing an implementation.

What you need

Detected in the repository

  • Node.js >=24 (from package.json)
  • Automated checks on GitHub Actions

Getting Started

Start with the official MCP documentation for an introduction. For protocol details, browse the specification and schema in the repository; see the README for contribution details.

License in Plain Words

No standard license was detected. Without a license, the default copyright rules apply: you may read the code, but not reuse it. Check the repository or ask the authors.

Alternatives

  • utcp-specification: UTCP defines protocol-independent tool discovery and calling across HTTP, WebSocket, CLI, and MCP, while MCP specifies its own client-server protocol.
ProjectLanguageLicenseStarsStatus
modelcontextprotocolTypeScript–9.6kActive
utcp-specificationTypeScript–314Active

Considerations

  • This repository defines the protocol but does not provide a client or server implementation, so adopting MCP in an application requires implementation elsewhere.
  • The repository is actively maintained, with recent commits, regular releases, and issues and pull requests handled quickly. It has a broad contributor base, with no indication that work depends mostly on one person.
  • Working with the repository requires Node.js 24 or newer. The supplied project facts do not indicate that tests are available.
  • The README identifies the project as MIT-licensed, while the GitHub API reports the license as NOASSERTION. Verify the license file and terms for your intended use.

Found this useful?

Share it with someone who would like modelcontextprotocol.

Comparisons