Build Better MCP Servers
The authoritative resource for MCP server quality — backed by scoring data from thousands of servers
Guides & Best Practices
The patterns that separate great MCP servers from the rest — distilled from real scoring data.
Tool Naming & Descriptions →
Agents discover tools by reading names and descriptions. Learn what makes tools findable — clear action verbs, scoped names, and descriptions that tell agents when to use a tool, not just what it does.
Schema Design →
Parameter types, required vs. optional fields, enum constraints, and return schemas. Well-typed schemas reduce agent errors and make your server predictable.
Error Handling →
JSON-RPC 2.0 error codes, graceful degradation, and structured error messages. Help agents recover instead of failing silently.
Common Mistakes →
The top issues we see across the scoreboard — missing descriptions, overly broad tool scopes, no input validation, and more. Learn from what others get wrong.
Starter Template
Skip the boilerplate. Start with best practices baked in.
MCP Server Starter →
A reference server with 6 example tools demonstrating typed schemas, proper error handling, and fuzz resilience. Install from PyPI or clone from GitHub.
- Best-practice tool schemas out of the box
- Both stdio and HTTP transports
- Clear descriptions, input validation, and graceful errors
Dev Mode
Get structured feedback before you ship.
Local Dev Mode
Point agents at your in-progress server and get instant feedback on tool discoverability, schema clarity, and error messages — the same criteria the scoreboard uses to grade live servers.
Ship It
Your server goes live, appears on the scoreboard, and you can claim and monitor it.
Pre-flight Check →
Run an instant deep-probe scan against your live endpoint. See exactly what the scoreboard sees — protocol compliance, schema validation, error handling — before your server is indexed.
Leaderboard →
Once your server is live and indexed, find it on the leaderboard. Claim it to track score changes, get alerts on regressions, and show off your grade.