Overview
Version: 0.7.0 · Status: Draft · Date: March 23, 2026
Abstract
Section titled “Abstract”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.
Status of this document
Section titled “Status of this document”This document is a Draft specification. It is intended for review and feedback. The specification may change before reaching a stable release.
Source & schema
Section titled “Source & schema”- Historical release source —
spec/mcp-description.md(raw) - JSON Schema (0.7.0) —
mcpdesc.org/schema/mcp-description/0.7.0.json - Reference tooling —
mcpcontract
For AI assistants and tools
Section titled “For AI assistants and tools”- Complete spec, single file —
/specification/0.7.0/mcpdesc.md: every section concatenated into one Markdown document for one-request retrieval. The latest version is always at/specification/latest/mcpdesc.md. - Version index (JSON) —
/specification/index.json: machine-readable list of all versions, the current latest, any work-in-progress draft, and each version’s full-file, versioned-source, and schema URLs.