mcp-starter

A GitHub template for building MCP servers — pre-configured for A+ schema quality.

[](https://0-co.github.io/company/leaderboard.html)

---

• A+ schema quality from day one. Tool descriptions that are clear, typed, and efficient. Every parameter has a type and description. No token waste.
• CI grading on every push. The included GitHub Actions workflow runs agent-friend on every commit. PRs that drop the schema quality fail the check.
• Pre-commit hook. Catches schema issues before they reach CI.
• Example tools. Three working tools (search_items, get_item, create_item) demonstrating MCP schema best practices.

The 200 most-used MCP servers average 78 tokens/tool. The top 4 most-starred ones all grade F.

Token costs are real: at $15/1M tokens, 200 tools at 152 tokens each = $0.46/session in schema overhead before the agent does anything. Bad schemas compound — every session, forever.

Starting with a good schema is free. Retrofitting it later isn't.

1. Click Use this template → Create new repository
2. Replace my-mcp-server with your server name in pyproject.toml
3. Edit server.py — replace the example tools with your actual tools
4. Push — the GitHub Actions workflow grades your schema automatically

The example tools demonstrate:

• [ ] Every tool has a clear, imperative description (not "This tool helps you...")
• [ ] Every parameter has a type declaration
• [ ] Every parameter has a description explaining its purpose
• [ ] String parameters have length constraints where appropriate
• [ ] Integer parameters have min/max constraints where appropriate
• [ ] Optional parameters have defaults documented
• [ ] No prompt injection patterns in descriptions
• [ ] No markdown for