MCP Toolkit Documentation
Welcome to the MCP Toolkit documentation.
MCP Toolkit is an open-source suite for describing, validating, previewing, and publishing MCP servers. It is built by Cisco contributors, maintained under Cisco Open Source, and licensed under Apache-2.0.
Where to start
Section titled “Where to start”- Getting started — install and open the editor.
- Privacy — what the site and editor do and do not collect.
The MCP Description format (mcpdesc)
Section titled “The MCP Description format (mcpdesc)”The suite is built around mcpdesc — a portable, machine-readable contract that
declares everything an MCP server offers (tools, resources, prompts, transports,
security), much like OpenAPI does for REST APIs. Its canonical home is the
mcptoolkit-contract repository.
The suite
Section titled “The suite”| Tool | What it does | Install / open |
|---|---|---|
| mcpcontract | CLI to dump capabilities from live MCP servers, detect breaking changes, and generate changelogs and documentation. Canonical home of the mcpdesc spec. |
npm i -g @cisco_open/mcptoolkit-contract |
| mcpeditor | Web-based editor to author, validate, preview, and export MCP Descriptions in your browser. | editor.mcptoolkit.org |
| mcpmock | Run, record, and build mock MCP servers from mcpdesc files — for testing clients, development, and demos. |
npm i -g @cisco_open/mcptoolkit-mock |
| mcptest | Automated testing framework for MCP servers, with scenarios auto-generated from MCP Descriptions. | npm i -g @cisco_open/mcptoolkit-test |
Source for every tool lives under cisco-open:
mcptoolkit-contract,
mcptoolkit-editor,
mcptoolkit-mock,
mcptoolkit-test.
Browse the examples for real MCP Description dumps, configs, and generated output.