MCP Toolkit
MCP Toolkit is an open-source suite to capture, compare, document, mock, and test MCP servers — powered by MCP Descriptions.
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 |
| 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 |
| mcpeditor | Web-based editor to author, validate, preview, and export MCP Descriptions in your browser. | editor.mcptoolkit.org |
Source for every tool lives under the ‘cisco-open’ github organisation: mcptoolkit-contract, mcptoolkit-editor, mcptoolkit-mock, mcptoolkit-test.
The MCP Description format
Section titled “The MCP Description format”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.