API

Score MCP tool definitions programmatically. Send JSON, get scores with specific fix suggestions.

Score tools

POST https://mcp.toolrank.dev/api/score

Request body

{
  "tools": [
    {
      "name": "search_web",
      "description": "Searches the web for current information.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": { "type": "string", "description": "Search query" }
        },
        "required": ["query"]
      }
    }
  ]
}

Response

{
  "score": 88.5,
  "level": "Dominant",
  "percentile": 36,
  "tools": [
    {
      "name": "search_web",
      "score": 88.5,
      "level": "Dominant",
      "dimensions": {
        "findability": 23,
        "clarity": 28,
        "precision": 22,
        "efficiency": 15
      },
      "issues": [
        {
          "dim": "clarity",
          "sev": "warning",
          "msg": "No usage context",
          "fix": "Add 'Use this when...'",
          "impact": 5
        }
      ]
    }
  ],
  "version": "1.0.0"
}

cURL example

curl -X POST https://mcp.toolrank.dev/api/score \
  -H "Content-Type: application/json" \
  -d '{"tools": [{"name": "my_tool", "description": "Does something"}]}'

OG Image

Generate scorecard SVGs for social sharing.

GET https://mcp.toolrank.dev/og/{server}.svg?score=95&level=Dominant

Returns an SVG scorecard image. Use as og:image for social media previews.

Embed widget

Add a ToolRank scorecard to any page with one script tag.

<script src="https://mcp.toolrank.dev/embed.js"
  data-server="brave"
  data-score="95"
  data-level="Dominant">
</script>

Renders a compact scorecard linking to the server's detail page.

Ecosystem stats

Real-time ecosystem statistics. Use these numbers in your articles and reports — they update daily.

GET https://mcp.toolrank.dev/api/stats

Returns JSON with total scanned, scored, average score, distribution, and citation text.

Stats badge

Embeddable SVG badges for articles and docs:

![MCP servers scored](https://mcp.toolrank.dev/api/stats/badge?stat=scored)
![Average score](https://mcp.toolrank.dev/api/stats/badge?stat=avg)
![Invisible to agents](https://mcp.toolrank.dev/api/stats/badge?stat=invisible)

Rate limits

Free: 100 requests/hour per IP

Pro: 1,000 requests/month (with API key)

Team: 10,000 requests/month

Other endpoints

MCP Server: POST https://mcp.toolrank.dev/mcp — JSON-RPC for MCP clients (Claude Code, Cursor)

Badge: GET https://badge.toolrank.dev/{server}.svg — Dynamic score badge

npx: npx @toolrank/mcp-server — Local MCP server

Score version: v1.0.0 · Open source scoring engine