MCP Toolkit

Open-source tools to describe, validate, preview, and publish MCP servers.

Built by Cisco contributors. Maintained under Cisco Open Source. Apache-2.0 licensed.

Open the Editor Read the Docs Explore Examples

Describe

Author MCP server descriptions with a clear, structured format.

Validate

Catch schema issues early with instant validation feedback.

Preview

See how tools, resources, and prompts come together.

Publish

Prepare descriptions for sharing and publishing.

One format, four tools

The suite is built around MCP Description (mcpdesc) — a portable, machine-readable contract for what an MCP server offers, like OpenAPI for REST.

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

Your MCP Description stays in your browser.

No MCP server description content is uploaded to our servers. Analytics only tracks anonymous product usage events.