Back to projects
mcpcheck
CLI · TypeScript · MCP · MIT
Audit any MCP server for agent ergonomics. One command, a 0-100 score, and a list of what breaks for the agent. Unlike the manual MCP Inspector, mcpcheck is a non-interactive auditor focused on real-world usability for AI agents, not just spec compliance.
What it scores
- Protocol: handshakes, capability matching, error handling, stdout-corruption detection.
- Schema: description quality, input/output schemas, naming, safety annotations.
- Context: bloated descriptions, 40+ tool counts, near-duplicates, token cost.
- Probes: invalid-argument tests, response size & latency, secret/path leak checks.
Install & run
npm install -g @m9ter1a/mcpcheck
mcpcheck ./server.js
mcpcheck ./server.js --min-score 80 # CI gate
mcpcheck ./server.js --json # machine-readable
mcpcheck ./server.js
mcpcheck ./server.js --min-score 80 # CI gate
mcpcheck ./server.js --json # machine-readable
Supports stdio & streamable HTTP · human, JSON & Markdown output with CI badges · MIT licensed.