Documentation

API Documentation

Access AN Scores, failure modes, and leaderboards programmatically. No authentication required.

Base URL: https://api.rhumb.dev/v1

REST API

GET /v1/services

List all scored services

Request 
curl https://api.rhumb.dev/v1/services
Response 
[
  {
    "slug": "stripe",
    "name": "Stripe",
    "category": "payments",
    "aggregate_recommendation_score": 8.09,
    "tier": "L4",
    "tier_label": "Native"
  },
  ...
]
GET /v1/services/{slug}/score

Full score breakdown for a service

Request 
curl https://api.rhumb.dev/v1/services/stripe/score
Response 
{
  "slug": "stripe",
  "name": "Stripe",
  "aggregate_recommendation_score": 8.09,
  "execution_score": 9.0,
  "access_readiness_score": 6.6,
  "tier": "L4",
  "tier_label": "Native",
  "explanation": "Scores 8.1/10 overall...",
  "failure_modes": [
    {
      "title": "Restricted key scope confusion",
      "severity": "high",
      "agent_impact": "...",
      "workaround": "..."
    }
  ],
  "calculated_at": "2026-03-11T..."
}
GET /v1/services/{slug}/failures

Active failure modes for a service

Request 
curl https://api.rhumb.dev/v1/services/stripe/failures
Response 
[
  {
    "title": "Restricted key scope confusion",
    "description": "...",
    "severity": "high",
    "frequency": "common",
    "agent_impact": "Agent creates key with insufficient scope...",
    "workaround": "Always request full scope list first...",
    "category": "authentication"
  }
]
GET /v1/leaderboard/{category}

Ranked services by category

Request 
curl https://api.rhumb.dev/v1/leaderboard/payments
Response 
[
  {
    "slug": "stripe",
    "name": "Stripe",
    "aggregate_recommendation_score": 8.09,
    "tier": "L4",
    "rank": 1
  },
  {
    "slug": "lemon-squeezy",
    "name": "Lemon Squeezy",
    "aggregate_recommendation_score": 6.56,
    "tier": "L3",
    "rank": 2
  },
  ...
]
GET /v1/search?q={query}

Search services by name, category, or description

Request 
curl "https://api.rhumb.dev/v1/search?q=payment"
Response 
[
  {
    "slug": "stripe",
    "name": "Stripe",
    "category": "payments",
    "aggregate_recommendation_score": 8.09
  },
  ...
]

MCP Server

Rhumb provides an MCP server that agents can use directly via the Model Context Protocol.

Install & run 
RHUMB_API_BASE_URL="https://api.rhumb.dev/v1" npx rhumb-mcp

Available tools

find_tools

Search for agent-native tools by use case

find_tools("payment processing")
get_score

Get the full AN Score breakdown for a specific service

get_score("stripe")
get_alternatives

Find alternatives to a service in the same category

get_alternatives("paypal")
get_failure_modes

Get known failure modes and workarounds for a service

get_failure_modes("stripe")

Notes

  • • No auth required — all endpoints are currently open. API keys and rate limiting are coming soon.
  • • JSON responses — all endpoints return JSON with Content-Type: application/json .
  • • Categories — payments, email, search, auth, database, ai, cms, analytics, monitoring, communication
  • • llms.txt — for agent discovery, see rhumb.dev/llms.txt