Audit report
wong2/awesome-mcp-servers
https://github.com/wong2/awesome-mcp-servers
Type: mcp · Audited 2026-05-22
Top fixes
- high
Add a server.json manifest
Add a server.json manifest. It is the machine-readable declaration of your server that the MCP registry and agents read directly.
- high
Add a Tools section to the README listing every tool the server exposes
Add a Tools section to the README listing every tool the server exposes. Agents pick a tool by reading this list.
- high
Get the server into public MCP config files
Get the server into public MCP config files. Few or none reference it today, and real adoption is the strongest trust signal an agent has.
- high
Cut tagged releases
Cut tagged releases. Versioning lets an agent pin a known-good version.
- medium
Add GitHub topics to the repository
Add GitHub topics to the repository. Topics let agents and registries categorize your server by capability.
Sub-scores
Discoverability
Agents can only recommend tools they can find. llms.txt and open robots.txt are the fastest wins.
Missing
- ✗Repository has topics/tags (0)
Passing
- ✓Repository has a clear description (54)
- ✓Identifiable as an MCP server
- ✓README opens with a one-line summary
Installation
Config-file appearances are the closest thing to a real install count for MCP servers.
Missing
- ✗README shows an MCP client config block
- ✗Ships a package manifest
Passing
- ✓README has an install or run command
- ✓Transport or configuration is documented
Tool definitions
Structured markup lets agents extract facts reliably instead of guessing from prose.
Missing
- ✗Ships a server.json manifest
- ✗README enumerates the tools
- ✗Tools are described, not just named
Passing
- ✓README shows usage examples
Documentation
Thin or poorly-described content gives agents nothing to summarise or cite.
Missing
- ✗README states what the server is for
- ✗Versioned releases or a changelog
Passing
- ✓Substantive README (1200+ chars) (99828)
- ✓README is organized into sections (6)
Trust & adoption
Models pattern-match provenance signals before recommending — missing basics trigger silent skips.
Missing
- ✗Appears in public MCP config files (0)
- ✗Has tagged releases (none)
Passing
- ✓Open-source license (MIT)
- ✓Pushed in the last 90 days (21)
- ✓Multiple contributors (373)
- ✓25+ GitHub stars (4094)
- ✓Has tests or CI
- ✓Discussed on Hacker News or Reddit (12)
Generated llms.txt
Drop this at /llms.txt on your domain.
Embed badge
Paste this into your README to display your live score.
[](https://mcprank-green.vercel.app/r/github.com-wong2-awesome-mcp-servers-3e77e9)
Get notified when this changes
We re-audit periodically. We'll email you when this score moves.
Discovery Report · free
The audit tells you whether agents CAN pick this server. Want to know whether they actually DO?
The Discovery Report measures which queries agents route to this server vs its rivals across multiple AI model families. It picks the one intent where you have the most leverage and gives you a concrete change to ship this week. Free.