Rhumb is an agent-native tool intelligence server for discovering, evaluating, and executing external services with trust scores, failure analysis, cost-aware routing, and credential management.
Discovery & Evaluation
find_tools— Semantic search for agent tools ranked by AN Score (0–10 quality rating)get_score— Detailed AN Score breakdown (execution quality, access readiness, autonomy support)get_alternatives— Ranked alternatives for any serviceget_failure_modes— Known failure patterns before integrationdiscover_capabilities— Browse 414 capabilities across 23 providers by domain or text
Execution & Routing
resolve_capability— Resolve a capability (e.g.email.send) to ranked, health-aware providers with costs and fallback chainsexecute_capability— Execute a capability via BYO, Rhumb-managed, or Agent Vault credentialsestimate_capability— Cost estimate before committing to executionrouting— Configure provider selection strategy: cheapest, fastest, highest_quality, or balanced
Credential Management
credential_ceremony— Step-by-step instructions for obtaining API credentialscheck_credentials— Check credential status across all three modes
Budget & Billing
budget— Set and enforce spending limits (hard/soft controls)spend— Spending breakdown by capability and providercheck_balance— Current prepaid credit balanceget_payment_url— Stripe checkout URL to top up creditsget_ledger— Recent billing ledger entries (debits, credits, auto-reloads)
Enables agents to discover, score, and execute Stripe capabilities with visibility into failure modes, execution quality, and cost-aware routing.
Rhumb
Agent-native tool intelligence. Discover, evaluate, and execute external tools — with trust scores, failure modes, cost-aware routing, and managed credentials.
🌐 rhumb.dev · ⚡ Quickstart · 💵 Pricing · 📊 Leaderboard · 📖 Methodology · 🔑 Trust
For agents: See
llms.txtfor machine-readable documentation andagent-capabilities.jsonfor structured capability metadata.
Start in 30 seconds
MCP (recommended)
npx rhumb-mcp@latestZero config. Discovery tools work immediately — no signup, no API key.
For execution, pass your Rhumb API key:
RHUMB_API_KEY=your_key npx rhumb-mcp@latestAPI (read-only, no auth)
curl "https://api.rhumb.dev/v1/services/stripe/score"All read endpoints are public.
What Rhumb does
Agents need external tools. Choosing the right one is hard — not because of feature lists, but because of:
auth and signup friction
provisioning reality vs. marketing claims
schema instability
failure recovery when no human is watching
hidden costs and rate limits
Rhumb makes those constraints visible before you commit.
Rhumb Index — Discover & Evaluate
695 scored services across 50+ domains. Each gets an AN Score (0–10) measuring execution quality, access readiness, and agent autonomy support.
find_services— search by capability, domain, or namean_score— full score breakdown with dimension-level detailget_alternatives— ranked alternatives for any serviceget_failure_modes— known failure patterns before you integrate
Rhumb Resolve — Execute
414 capabilities across 23 providers. Cost-aware routing picks the best provider for each call.
execute_capability— call a capability through Resolve with managed authresolve_capability— see ranked providers before executingestimate_capability— get cost estimate before committingBudget enforcement, credential management, and execution telemetry included
Three credential modes
Mode | How it works |
BYO | Bring your own API key — Rhumb routes, you authenticate |
Rhumb-managed | Rhumb holds the credential — zero setup for the agent |
Agent Vault | Your key, encrypted and stored — Rhumb injects at call time |
Payment paths
API key — sign up, get a key, prepaid credits
x402 / USDC — no signup, pay per call on-chain
MCP tools
rhumb-mcp exposes 17 tools:
Discovery
find_services— search servicesan_score— score breakdownget_alternatives— ranked alternativesget_failure_modes— failure patternsdiscover_capabilities— browse capability registryusage_telemetry— your usage analytics
Execution
resolve_capability— ranked providers for a capabilityexecute_capability— execute through Resolveestimate_capability— cost estimate before executioncredential_ceremony— set up credentialscheck_credentials— verify credential statusrouting— configure routing strategy
Billing
budget— set spend limitsspend— check current spendcheck_balance— prepaid balanceget_payment_url— top-up linkget_ledger— transaction history
API
Base URL: https://api.rhumb.dev/v1
Endpoint | Auth | Purpose |
| No | Score breakdown |
| No | Service profile + metadata |
| No | Known failure modes |
| No | Search services |
| No | Category rankings |
| No | Capability registry |
| No | Ranked providers |
| Yes | Execute a capability |
| Yes | Cost estimate |
| No | Provider health status |
| Yes | Your usage analytics |
| No | Machine-readable pricing |
Examples
See examples/ for runnable scripts:
Example | What it shows | Auth needed? |
Search → Score → Failure modes | No | |
Resolve → Estimate → Execute | Yes | |
Budget + cost-optimal routing | Yes | |
Repeatable Resolve → telemetry verification loop | Yes | |
MCP setup for Claude, Cursor, etc. | Optional |
# Try discovery right now (no auth needed)
pip install httpx && python examples/discover-and-evaluate.pyDocs
Agent Accessibility Guidelines — making web interfaces usable by AI agents
AN Score Methodology — scoring dimensions, weights, and rubrics
Architecture — scoring engine design
API Reference — endpoint details
Security Policy — vulnerability reporting and security architecture
Runbooks — operational procedures
Dogfood Loop — repeatable Resolve → telemetry validation harness
Repo structure
rhumb/
├── packages/
│ ├── api/ # Python API (Railway)
│ ├── astro-web/ # Public website (Vercel)
│ ├── mcp/ # MCP server (npm)
│ ├── cli/ # CLI tooling
│ └── shared/ # Shared types/constants
├── examples/ # Runnable examples
├── docs/ # Public documentation
├── scripts/ # Scoring + verification
├── artifacts/ # Score datasets
├── llms.txt # Machine-readable docs for agents
└── agent-capabilities.json # Structured capability manifestDevelopment
# API
cd packages/api && pip install -r requirements.txt && uvicorn app:app --reload
# MCP
cd packages/mcp && npm ci && npm run dev
# Web
cd packages/astro-web && npm ci && npm run devNode 24+ recommended (.nvmrc included).
Score disputes
Every score is disputable. If you believe a score is inaccurate:
Open a GitHub issue with evidence
Or email providers@supertrained.ai
Negative findings remain visible. Rhumb does not accept payment to change scores.
Links
Website: rhumb.dev
npm: rhumb-mcp
MCP Registry: Rhumb on MCP Registry
X: @pedrorhumb