MCP Doctor
Audit and tighten MCP server schemas, tool descriptions, and contracts before you publish or hand off to other agents.
Overview
MCP Doctor is a Ship-phase MCP server that checks and helps improve the contract quality of MCP servers for humans, agents, and platforms.
What is this MCP server?
- Checks MCP server contract and description quality
- Targets publishers, agent orchestrators, and platform curators
- Stdio PyPI package mcp-doctor (v0.1.0)
- Improvement-oriented feedback, not just pass/fail lint
- Works on arbitrary MCP servers you are authoring or vetting
- PyPI package mcp-doctor version 0.1.0
- Stdio transport per MCP server schema 2025-12-11
- Repository: github.com/Jiansen/mcp-doctor
What problem does it solve?
Weak MCP schemas and tool docs make agents hallucinate arguments, fail silently, or misuse capabilities you thought were obvious.
Who is it for?
Indie MCP authors and integrators who want a structured review pass before listing a server or trusting it in production agent loops.
Skip if: Builders who only consume finished marketplace MCPs and never author or fork server.json and tool manifests.
What do I get? / Deliverables
After running MCP Doctor, you get actionable contract fixes so registered tools behave predictably in Claude Code, Cursor, and other MCP clients.
- Contract quality findings for the target MCP server
- Actionable improvements to schemas and tool documentation
- Higher-confidence handoff to registries and end-user agents
Recommended MCP Servers
Journey fit
Contract quality gates belong in Ship when you are hardening something others will call—parallel to code review, not first-line feature coding. Review is the canonical shelf for diagnostic tooling that judges whether an MCP server is safe and clear for humans and downstream agents.
How it compares
MCP contract reviewer, not a runtime monitor or proxy debugger for IDE networking.
Common Questions / FAQ
Who is MCP Doctor for?
MCP server authors, agent platform maintainers, and solo developers who need to validate tool contracts before release.
When should I use MCP Doctor?
Use it in Ship during review, right before you publish, share, or depend on a new or updated MCP server in your agent stack.
How do I add MCP Doctor to my agent?
Install mcp-doctor from PyPI, register it as a stdio MCP server in your client, then point its workflow at the MCP server package you want diagnosed.