MCP Toolkit

Open-source tools to capture, compare,document, mock, and test MCP servers — powered by MCP Descriptions.

Capture

Dump the capabilities of a live MCP server into a portable format.

Edit

Author, validate, and preview MCP Descriptions.

Compare

Diff descriptions across releases, spot breaking changes, control MCP servers lifecycle.

Document

Generate and publish human-readable docs and changelogs.

Mock

Run mock servers from MCP descriptions, capture and replay MCP traffic.

Test

Validate MCP servers against their capabilities, auto-generate test scenarios.

One format, four tools

The tools are built around the MCP Description (mcpdesc) specifications — a portable, machine-readable format for what an MCP server offers (like OpenAPI for REST APIs).

mcpcontract

→

CLI to dump capabilities from live MCP servers, detect breaking changes, and generate changelogs and docs. 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 — entirely 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