Quickstart

First call in 30 seconds

No signup required. Copy a command, get a response. Read endpoints are free and open.

1

Try the API

All read endpoints are free, no key required. Pick your language:

curl

curl "https://api.rhumb.dev/v1/services/stripe/score"

JavaScript

const res = await fetch("https://api.rhumb.dev/v1/services/stripe/score");
const { data } = await res.json();
console.log(data.overall_score); // 8.1

Python

import requests
data = requests.get("https://api.rhumb.dev/v1/services/stripe/score").json()["data"]
print(data["overall_score"])  # 8.1
Response (abbreviated): 
{
  "data": {
    "slug": "stripe",
    "overall_score": 8.1,
    "tier": "L4 Native",
    "execution_score": 8.4,
    "access_readiness_score": 7.3,
    "failure_count": 2,
    "review_count": 47
  }
}
2

Explore what's available

Search by need

curl "https://api.rhumb.dev/v1/search?q=send+email"

Browse by category

curl "https://api.rhumb.dev/v1/leaderboard/payments"

Service profile + alternatives

curl "https://api.rhumb.dev/v1/services/stripe"

Check failure modes

curl "https://api.rhumb.dev/v1/services/stripe/failures"
3

Execute capabilities

To actually do things through APIs (send emails, create records, charge cards), you need one of:

API Key

Sign up, get a key, pass it as X-Rhumb-Key

Best for: developers

x402 Payment

No signup. Pay per call with USDC. The payment is the authentication.

Best for: autonomous agents

Your Own Key

Pass your service API key directly. BYOK = full control.

Best for: teams, enterprise

Execute via API key

curl -X POST "https://api.rhumb.dev/v1/capabilities/email.send/execute" \
  -H "X-Rhumb-Key: rhumb_live_..." \
  -H "Content-Type: application/json" \
  -d '{"to": "user@example.com", "subject": "Hello", "body": "Hi from Rhumb"}'

Execute via x402 (zero signup)

# Step 1: Get payment requirements
curl -X POST "https://api.rhumb.dev/v1/capabilities/email.send/execute"
# Returns 402 with payment details (amount, USDC address, network)

# Step 2: Pay on-chain, then include tx proof
curl -X POST "https://api.rhumb.dev/v1/capabilities/email.send/execute" \
  -H "X-Payment: {tx_hash}" \
  -H "Content-Type: application/json" \
  -d '{"to": "user@example.com", "subject": "Hello"}'
4

Connect via MCP

If your agent supports MCP, connect directly:

Install

npx rhumb-mcp

Claude Desktop config

{
  "mcpServers": {
    "rhumb": {
      "command": "npx",
      "args": ["rhumb-mcp"],
      "env": {
        "RHUMB_API_KEY": "rhumb_live_..."
      }
    }
  }
}

16 tools available: find_tools, get_score, get_alternatives, get_failure_modes, execute_capability, and more. Full MCP guide →

Keep going

API Reference All endpoints, parameters, responses Credential Security BYOK, managed, x402 — which is right for you Tool Comparisons 9 head-to-head comparisons with live data