ToolRank
Score and optimize MCP tool definitions for AI agent discovery. Analyzes Findability, Clarity, Precision, and Efficiency.
ToolRank
The PageRank for AI agent tools.
Score, optimize, and monitor how AI agents discover and select your MCP tools.
We scanned 4,162 MCP servers. Here's what we found.
| Metric | Value |
|---|---|
| Registered servers | 4,162 |
| With tool definitions | 1,122 (27%) |
| Invisible to agents | 3,040 (73%) |
| Average score | 84.7/100 |
| Selection advantage | 3.6x for optimized tools |
73% of MCP servers are invisible to AI agents. They have no tool definitions, no descriptions, no schema. When an agent searches for tools, these servers don't exist.
Sources: arXiv 2602.14878, arXiv 2602.18914
What is ATO?
ATO (Agent Tool Optimization) is to the agent economy what SEO was to the search economy.
| SEO | LLMO | ATO | |
|---|---|---|---|
| Target | Search engines | LLM responses | Agent tool selection |
| Trigger | Human searches | Human asks AI | Agent acts autonomously |
| Result | A click | A mention | A transaction |
LLMO is Stage 1 of ATO — necessary but not sufficient.
Quick Start
Score in browser
toolrank.dev/score — paste your tool JSON or enter your Smithery server name.
Score via CLI
npx @toolrank/mcp-server
Score in Python
from toolrank_score import score_server, format_report
result = score_server("my-server", tools)
print(format_report(result))
ToolRank Score
0-100 metric across four dimensions:
| Dimension | Weight | What it measures |
|---|---|---|
| Findability | 25% | Can agents discover you? |
| Clarity | 35% | Can agents understand you? |
| Precision | 25% | Is your schema precise? |
| Efficiency | 15% | Are you token-efficient? |
Maturity Levels
| Level | Score | Meaning |
|---|---|---|
| Dominant | 85-100 | Agents prefer your tool |
| Preferred | 70-84 | Agents can use your tool well |
| Selectable | 50-69 | Agents might use your tool |
| Visible | 25-49 | Agents see you but rarely select |
| Absent | 0-24 | Agents can't find you |
Before and After
- "name": "get",
- "description": "gets data from the api"
+ "name": "search_repositories",
+ "description": "Searches for GitHub repositories matching a query.
+ Useful for finding open-source projects or checking if a repo exists.
+ Returns name, description, stars, language, and URL.",
+ "inputSchema": {
+ "type": "object",
+ "properties": {
+ "query": { "type": "string", "description": "Search query" },
+ "sort": { "type": "string", "enum": ["stars", "forks", "updated"] }
+ },
+ "required": ["query"]
+ }
Score: 52 → 96. Five minutes of work. 3.6x selection advantage.
Architecture
toolrank/
├── packages/
│ ├── scoring/ # Level A engine (Python, zero-cost)
│ │ ├── toolrank_score.py # 14 checks across 4 dimensions
│ │ ├── level_c_score.py # Claude AI scoring (Pro)
│ │ └── weights.json # Auto-calibrated weights
│ ├── scanner/ # Ecosystem scanner
│ │ ├── scanner_v3.py # Weekly full / daily diff
│ │ ├── calibrate.py # Weight auto-adjustment
│ │ └── auto_blog.py # Daily article generation
│ ├── web/ # Astro site (toolrank.dev)
│ ├── mcp-server/ # ToolRank MCP Server
│ └── badge-worker/ # Dynamic badge SVG (CF Workers)
└── .github/workflows/ # Automated pipelines
Ecosystem Rankings
Updated weekly. Full ranking →
| Rank | Server | Score |
|---|---|---|
| 1 | microsoft/learn_mcp | 96.5 |
| 2 | docfork/docfork | 96.5 |
| 3 | brave | 94.7 |
| 4 | LinkupPlatform/linkup-mcp-server | 93.5 |
| 5 | smithery-ai/national-weather-service | 93.3 |
Add Badge to Your README
[](https://toolrank.dev/ranking)
Contributing
ToolRank is open source. The scoring logic is fully transparent and auditable.
- Report issues: GitHub Issues
- Scoring methodology: packages/scoring/toolrank_score.py
- Governance: GOVERNANCE.md · CHANGELOG.md
- ATO Framework: toolrank.dev/framework
⭐ Star this repo if you find ToolRank useful — it helps others discover it.
License
MIT
toolrank.dev · Built by @imhiroki
If SEO is about being found by search engines, ATO is about being used by AI agents.
관련 서버
Scout Monitoring MCP
스폰서Put performance and error data directly in the hands of your AI assistant.
Alpha Vantage MCP Server
스폰서Access financial market data: realtime & historical stock, ETF, options, forex, crypto, commodities, fundamentals, technical indicators, & more
WinAiDbg MCP
AI-powered Windows crash dump analysis platform that provides structured access to Microsoft debugging tools through the Model Context Protocol, making complex crash investigation accessible to AI systems
即梦AI多模态MCP
A multimodal generation service using Volcengine Jimeng AI for image generation, video generation, and image-to-video conversion.
Test MCP Server
A sample MCP server implemented in Node.js for development and testing purposes.
Roslyn MCP Server
A C# MCP server using Microsoft's Roslyn compiler for code analysis and navigation in C# codebases.
Metal MCP Server
Search Metal Framework documentation and generate code.
Reloaderoo
A local MCP server for developers that mirrors your in-development MCP server, allowing seamless restarts and tool updates so you can build, test, and iterate on your MCP server within the same AI session without interruption.
Svelte Documentation
Remote server (SSE/Streamable) for the latest Svelte and SvelteKit documentation
Remote MCP Server (Authless)
An example of a remote MCP server without authentication, deployable on Cloudflare Workers.
xMCP Server
A streamable HTTP MCP server that proxies requests to stdio MCP servers within a container, providing a consistent command environment.
DevCycle
Turn your favourite AI tool into a feature management assistant. DevCycle's MCP works with your favourite coding assistant so you can create and monitor feature flags using natural language right in your workflow.