Record sessions, generate mock servers, gate your CI pipeline, and catch Tool Poisoning — all without writing a single line of test code. The reliability platform for Model Context Protocol servers.
npm install -g mcpspec
# 1. Explore a server interactively
mcpspec inspect "npx my-server"
# 2. Record a session (no test code needed!)
mcpspec record start "npx my-server"
# 3. Generate a mock for your team
mcpspec mock my-recording --generate ./mocks/server.js
# 4. Add CI gating in 30 seconds
mcpspec ci-init
Unlike LLM-based testing, MCPSpec runs are fast and repeatable. No flaky tests, no token costs. Ideal for CI pipelines.
Catch Tool Poisoning (prompt injection in descriptions) and Excessive Agency (destructive tools without safeguards) before they reach production.
Record server interactions and share mocks with your team. Frontend developers and CI can test against mocks — no API keys required.
No config files needed. Try a pre-built collection or explore a server interactively.
npm install -g mcpspec
mcpspec test examples/collections/servers/filesystem.yaml
mcpspec init --template standard && mcpspec test
13 CLI commands, 10 assertion types, 8 security rules, 5 reporter formats, and a full web dashboard.
Record inspector sessions, replay to catch regressions, and generate mock servers. Standalone .js files for CI.
8 rules including Tool Poisoning and Excessive Agency. Passive mode is safe for production. Active mode auto-skips destructive tools.
YAML-based suites with 10 assertion types, environments, variable extraction, tags, retries, and parallel execution.
0–100 quality rating across 5 categories. Opinionated schema linting with 6 sub-criteria. SVG badges for your README.
Run mcpspec ci-init to generate GitHub Actions, GitLab CI, or shell scripts. Exit codes for pipeline gating.
Full React UI with 10 pages: servers, collections, runs, inspector, recordings, audit, benchmarks, score, and docs. Dark mode.
Community collections for popular MCP servers. See all examples
| Collection | Server | Tests |
|---|---|---|
| filesystem.yaml | @modelcontextprotocol/server-filesystem | 12 |
| memory.yaml | @modelcontextprotocol/server-memory | 10 |
| everything.yaml | @modelcontextprotocol/server-everything | 11 |
| time.yaml | @modelcontextprotocol/server-time | 10 |
| fetch.yaml | @modelcontextprotocol/server-fetch | 7 |
| github.yaml | @modelcontextprotocol/server-github | 9 |
| chrome-devtools.yaml | chrome-devtools-mcp | 11 |