MCP Specification

The authoritative protocol definition for the Model Context Protocol, maintained at modelcontextprotocol.io and in the modelcontextprotocol/ specification GitHub repository. The TypeScript schema (schema.ts) is the source of truth, with an auto-generated JSON Schema (schema.json) for tooling. The current dated version is 2025-11-25. The protocol uses JSON-RPC 2.0 messages between hosts, clients, and servers and defines tools, resources, prompts, sampling, roots, elicitation, completion, and logging features.

API entry from apis.yml

apis.yml Raw ↑
name: MCP Specification
description: The authoritative protocol definition for the Model Context Protocol, maintained at modelcontextprotocol.io
  and in the modelcontextprotocol/ specification GitHub repository. The TypeScript schema (schema.ts)
  is the source of truth, with an auto-generated JSON Schema (schema.json) for tooling. The current dated
  version is 2025-11-25. The protocol uses JSON-RPC 2.0 messages between hosts, clients, and servers and
  defines tools, resources, prompts, sampling, roots, elicitation, completion, and logging features.
humanURL: https://modelcontextprotocol.io/specification
baseURL: ''
tags:
- Specification
- JSON-RPC
- Schema
- Protocol
properties:
- type: Documentation
  url: https://modelcontextprotocol.io/specification/2025-11-25
- type: GitHubRepository
  url: https://github.com/modelcontextprotocol/specification
- type: JSONSchema
  url: https://github.com/modelcontextprotocol/specification/blob/main/schema/2025-11-25/schema.json
- type: Versioning
  url: https://modelcontextprotocol.io/specification/versioning