Skip to content

Overview

Version: 0.7.0 · Status: Draft · Date: March 23, 2026

This specification defines the MCP Description format — a portable, machine-readable document that describes the capabilities of a Model Context Protocol (MCP) server.

An MCP Description declares the tools, resources, prompts, transports, security requirements, and metadata of an MCP server in a static JSON document, enabling offline discovery, documentation generation, contract validation, and interoperable tooling across the MCP ecosystem.

This document is a Draft specification. It is intended for review and feedback. The specification may change before reaching a stable release.

  1. Introduction
  2. Terminology
  3. Document Structure
  4. Versioning
  5. Info Object
  6. Transports
  7. Security
  8. Capabilities
  9. Tools
  10. Resources and Resource Templates
  11. Prompts
  12. Tags
  13. Specification Extensions
  14. Serialization
  15. Conformance

See also the examples and the cross-version changelog.