Rhumb
About
Agent-native tool intelligence — discover, score, and compare 600+ APIs across 16 MCP tools. Zero-signup discovery, AN Score methodology, failure mode data, and managed execution.
Details
- Author
- supertrained
- Downloads
- 154
- Categories
- Search, API, Other
Jump to
- 17 MCP tools covering discovery, execution, and billing
- 695 scored services with AN Score (0–10) across 50+ domains
- 414 executable capabilities across 23 providers
- Three credential modes: BYO, Rhumb-managed, Agent Vault
- Payment via API key (prepaid credits) or x402/USDC (on-chain)
- Cost-aware routing with budget enforcement and execution telemetry
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
RhumbCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Run npx rhumb-mcp@latest with zero configuration. Discovery tools work immediately with no signup or API key. For execution, pass your Rhumb API key via the RHUMB_API_KEY environment variable. Public read endpoints are also available via the API at https://api.rhumb.dev/v1 with no authentication.
find_services
Search indexed Services by what you need them to do. Returns ranked Services with AN Scores. Use this when you know the problem but not which Service to call. For Capability-level search (e.g. 'email.send'), use discover_capabilities instead.
get_score
Get the full AN Score breakdown for a Service: execution quality, access readiness, autonomy level, tier label, and freshness. Use after find_services to evaluate a specific Service.
get_alternatives
Find alternative Services, ranked by AN Score. Use when a Service doesn't meet your needs or you want to compare options in the same category.
get_failure_modes
Get known failure patterns, impact severity, and workarounds for a service. Use BEFORE integrating to write defensive code, or AFTER hitting an error to diagnose it.
discover_capabilities
Browse Capabilities by domain or search text. A Capability is an action (e.g. 'email.send', 'payment.charge') that multiple providers can fulfill. Use this when you know WHAT you need to do but not which Service does it. Returns Capability IDs for resolve_capability. Different from find_services: find_services searches Services, this searches Capabilities.
resolve_capability
Given a Capability ID, and optionally a credential mode, returns ranked providers with health status, cost per call, auth methods, endpoint patterns, execute guidance, and machine-readable recovery fields like recovery_hint.resolve_url, recovery_hint.credential_modes_url, and, when applicable, recovery_hint.alternate_execute_hint or recovery_hint.setup_handoff, plus typo recovery when the capability ID is wrong. If the capability ID is wrong, returns a capability search URL plus suggested capabilities instead of a blank dead end. This is the core routing decision: 'I need email.send, and maybe a specific credential mode, which provider or recovery handoff should I use?' Call this before execute_capability to understand your options.
execute_capability
Call a Capability through Rhumb Resolve. Typical workflow: discover_capabilities → resolve_capability → estimate_capability → execute_capability. Default credential mode is auto: Rhumb uses Rhumb Resolve when an active managed config exists, otherwise falls back to byok. Legacy 'byo' is still accepted as an input alias. Other explicit modes: rhumb_managed — zero-config through Rhumb Resolve when available; byok — BYOK via agent_token + method + path; agent_vault — use a key from credential_ceremony via agent_token + method + path. Alternative: pass x_payment for a per-call USDC payment with no account needed. Use check_credentials to inspect live readiness globally or for a specific Capability before choosing a rail.
estimate_capability
Estimate the active execution rail, cost, and health before a Capability call; anonymous direct system-of-record paths also preserve machine-readable execute_readiness handoffs. Returns cost in USD, circuit health, and endpoint pattern. Default credential mode is auto: Rhumb uses Rhumb Resolve when an active managed config exists, otherwise falls back to byok. Legacy 'byo' is still accepted as an input alias. Always call this before execute_capability for cost-sensitive workflows — no charge for estimates.
credential_ceremony
Get step-by-step instructions to obtain API credentials for a Service. Returns signup steps, expected token format (prefix, pattern), verification endpoint, estimated time, and whether human intervention is needed. Use before calling in agent_vault mode. Call without params to list all Services with available ceremonies.
check_credentials
Inspect live credential-mode readiness, globally or for a specific Capability. Call without params to see which BYOK bridges or direct bundles are already configured and which Capabilities are ready now through Rhumb-managed rails. Pass a Capability to inspect provider-level mode status, configured readiness, and ceremony availability for that specific path.
budget
Check or set your call spending limit. Budgets are enforced BEFORE a call — you get HTTP 402 (not a surprise bill) when you'd exceed your limit. Call with no params to check current budget and remaining balance.
spend
Get your spending breakdown for a billing period: total USD spent, call count, average cost per call, broken down by Capability and by provider. Use to audit costs or optimize routing.
routing
Get or set how Rhumb auto-selects providers when you don't specify one in execute_capability. Controls the tradeoff between cost, speed, and quality. Also sets a quality floor (minimum AN Score) and optional per-call cost ceiling.
usage_telemetry
Get your execution analytics — calls, latency, errors, costs, and provider health for your Rhumb usage.
check_balance
Check your current Rhumb credit balance in USD. Also shows whether auto-reload is enabled. If balance is low, use get_payment_url to top up.
get_payment_url
Get a checkout URL to add credits to your Rhumb balance. Present this URL to a human to complete payment. Credits are available immediately after payment.
get_ledger
Get your billing history: charges (debits), top-ups (credits), and auto-reload events. Each entry shows amount, balance after, description, and timestamp. Most recent first.
rhumb_list_recipes
List the current published Rhumb Layer 3 recipe catalog. Use this to check what is actually live before assuming a deterministic multi-step workflow exists; the public catalog can be empty while Layer 3 remains in beta.
rhumb_get_recipe
Get the full published definition for a Rhumb recipe, including input/output schemas and step topology. Call this only after rhumb_list_recipes confirms the recipe is currently in the public catalog.
rhumb_recipe_execute
Execute a published Rhumb Layer 3 recipe once one is live in the public catalog. Rhumb runs the multi-step workflow through the existing Layer 2 capability rail, applies recipe safety controls, and returns per-step results plus a recipe-level receipt chain hash.
get_receipt
Retrieve an execution receipt by ID. Every Resolve v2 execution produces an immutable, chain-hashed receipt containing: provider used, cost breakdown, latency, routing explanation, and integrity hash. Use this to audit, debug, or verify any past execution. The receipt_id is returned in every execute_capability response when v2 policy parameters are used.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"rhumb": {
"rhumb": {
"command": "npx",
"args": [
"rhumb-mcp@latest"
]
}
}
}
}McpServers
{
"rhumb": {
"command": "npx",
"args": [
"rhumb-mcp@latest"
]
}
}Index ranks. Resolve routes.Rhumb is an agent gateway for external tools: Index scores and compares services; Resolve routes supported capability calls through governed execution rails with receipts.
🌐rhumb.dev· ⚡Quickstart· 🧭Resolve· 💵Pricing· 📊Leaderboard· 📖Methodology· 🔑Trust
For agents:Seellms.txtfor machine-readable documentation andagent-capabilities.jsonfor structured capability metadata.
npx -y --package rhumb-mcp@latest rhumb-mcp
Zero config. Discovery tools work immediately — no signup, no governed API key.
For execution, pass your governed API key:
RHUMB_API_KEY=your_key npx -y --package rhumb-mcp@latest rhumb-mcp
curl "https://api.rhumb.dev/v1/services/stripe/score" # See supported execution routes before you execute curl "https://api.rhumb.dev/v1/capabilities/email.send/resolve"
All read endpoints are public, including Resolve readiness checks. Estimate and execute require an authenticated payment path.
Use Rhumb Index when an agent needs to discover and evaluate services. Use Rhumb Resolve when the task is on a supported capability path and you want governed execution with an explicit receipt.
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 is strongest today forresearch, extraction, generation, and narrow enrichment.
Treat broader multi-system business automation as future scope, not the current launch promise. Use Layer 2 capabilities for real work now, and treat Layer 3 as beta with an intentionally sparse public catalog.
1,038 scored servicesacross 50+ domains. Each gets anAN Score(0–10) measuring execution quality, access readiness, and agent autonomy support.
- find_services— Search indexed Services by what you need them to do
- get_score— Get the full AN Score breakdown for a Service: execution quality, access readiness, autonomy level, tier label, and freshness
- get_alternatives— Find alternative Services, ranked by AN Score
- get_failure_modes— Get known failure patterns, impact severity, and workarounds for a service
- discover_capabilities— Browse Capabilities by domain or search text
- resolve_capability— Given a Capability ID, and optionally a credential mode, returns ranked providers with health status, cost per call, auth methods, endpoint patterns, execute guidance, and machine-readable recovery fields like recovery_hint.resolve_url, recovery_hint.credential_modes_url, and, when applicable, recovery_hint.alternate_execute_hint or recovery_hint.setup_handoff, plus typo recovery when the capability ID is wrong
Discovery breadth is wider than current execution coverage. The index is broader than what Rhumb can execute today.
415 capability definitionsacross16 callable providers today. Resolve chooses the best-fit supported provider for the call using AN Score, availability / circuit state, estimated cost, latency proxy, credential mode, and explicit policy constraints.
- execute_capability— Call a Capability through Rhumb Resolve
- resolve_capability— Given a Capability ID, and optionally a credential mode, returns ranked providers with health status, cost per call, auth methods, endpoint patterns, execute guidance, and machine-readable recovery fields like recovery_hint.resolve_url, recovery_hint.credential_modes_url, and, when applicable, recovery_hint.alternate_execute_hint or recovery_hint.setup_handoff, plus typo recovery when the capability ID is wrong
- estimate_capability— Estimate the active execution rail, cost, and health before a Capability call; anonymous direct system-of-record paths also preserve machine-readable execute_readiness handoffs
- get_receipt— Retrieve an execution receipt by ID
- Budget enforcement, credential management, and execution telemetry included
Best current fit: research, extraction, generation, and narrow enrichment. Treat general business-agent automation and broad multi-system orchestration as future scope, not the current launch promise.
- Governed API key— sign up, get a key, prepaid credits
- x402 / USDC— no signup, pay per call on-chain
- Service= vendor Rhumb evaluates and compares
- Capability= executable action likeemail.send
- Recipe= deterministic multi-step workflow on top of capabilities (beta, sparse public catalog)
- Layer 2 is the default path— start with governed API key or wallet-prefund onX-Rhumb-Key, discover a Service, choose a Capability, estimate, then execute
- Start with managed superpowers first— bring BYOK or Agent Vault only when the workflow touches your own systems
- Default auth for repeat traffic= governed API key or wallet-prefund onX-Rhumb-Key
- Bring BYOK or Agent Vaultonly when provider control is the point
- Use x402when zero-signup per-call payment matters more than repeat throughput
Canonical onboarding map:https://rhumb.dev/docs#resolve-mental-model
- find_services— Search indexed Services by what you need them to do
- get_score— Get the full AN Score breakdown for a Service: execution quality, access readiness, autonomy level, tier label, and freshness
- get_alternatives— Find alternative Services, ranked by AN Score
- get_failure_modes— Get known failure patterns, impact severity, and workarounds for a service
- discover_capabilities— Browse Capabilities by domain or search text
- resolve_capability— Given a Capability ID, and optionally a credential mode, returns ranked providers with health status, cost per call, auth methods, endpoint patterns, execute guidance, and machine-readable recovery fields like recovery_hint.resolve_url, recovery_hint.credential_modes_url, and, when applicable, recovery_hint.alternate_execute_hint or recovery_hint.setup_handoff, plus typo recovery when the capability ID is wrong
- execute_capability— Call a Capability through Rhumb Resolve
- estimate_capability— Estimate the active execution rail, cost, and health before a Capability call; anonymous direct system-of-record paths also preserve machine-readable execute_readiness handoffs
- credential_ceremony— Get step-by-step instructions to obtain API credentials for a Service
- check_credentials— Inspect live credential-mode readiness, globally or for a specific Capability
- rhumb_list_recipes— List the current published Rhumb Layer 3 recipe catalog
- rhumb_get_recipe— Get the full published definition for a Rhumb recipe, including input/output schemas and step topology
- rhumb_recipe_execute— Execute a published Rhumb Layer 3 recipe once one is live in the public catalog
- get_receipt— Retrieve an execution receipt by ID
- budget— Check or set your call spending limit
- spend— Get your spending breakdown for a billing period: total USD spent, call count, average cost per call, broken down by Capability and by provider
- check_balance— Check your current Rhumb credit balance in USD
- get_payment_url— Get a checkout URL to add credits to your Rhumb balance
- get_ledger— Get your billing history: charges (debits), top-ups (credits), and auto-reload events
- routing— Get or set how Rhumb auto-selects providers when you don't specify one in execute_capability
- usage_telemetry— Get your execution analytics — calls, latency, errors, costs, and provider health for your Rhumb usage
Discovery spans 1,038 scored services, but current governed execution spans 16 callable providers.
Note: Layer 3 recipe tooling is live, but the public catalog can still be empty. Userhumb_list_recipesor visit/recipesbefore assuming a workflow exists.
Best current fit: research, extraction, generation, and narrow enrichment. Treat general business-agent automation as future scope, not the current launch promise.
# Try discovery right now (no auth needed) pip install httpx && python examples/discover-and-evaluate.py # Try the resolve walkthrough right now (no auth needed for resolve) python examples/resolve-and-execute.py
resolve-and-execute.pywill still show the ranked providers plus any machine-readable recovery handoff Rhumb already identified. SetRHUMB_API_KEYonly when you want to continue into estimate and execute.
- 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
- Repo Boundary— what stays public here vs. what lives in the private ops workspace
- Security Policy— vulnerability reporting and security architecture
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 only ├── scripts/ # Product tooling + verification scripts ├── artifacts/ # Curated public datasets only (raw proof outputs stay local/private) ├── llms.txt # Machine-readable docs for agents └── agent-capabilities.json # Structured capability manifest
# 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 dev
Node 24+ recommended (.nvmrcincluded).
Every score is disputable. If you believe a score is inaccurate:
- Read the public provider guide atrhumb.dev/providers
- Open the score-dispute GitHub templatewith evidence
- Or emailproviders@supertrained.aifor a private path
We target an initial response within 5 business days. Negative findings remain visible. Rhumb does not accept payment to change scores.
- Website:rhumb.dev
- npm:rhumb-mcp
- MCP Registry:Rhumb on MCP Registry
- X:@pedrorhumb
Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.
An MCP server using the AviationStack API to fetch real-time flight data including airline flights, airport schedules, future flights and aircraft types.
Free business data API and MCP server. Find restaurants, cafes, hotels, shops and 37+ business categories in any city worldwide. Uses OpenStreetMap data. No API key required. REST API + MCP Streamable HTTP endpoint.
CLI and MCP server for the UK Companies House API — company search, profiles, officers, filings, ownership, and due diligence
Search and retrieve brewery data worldwide using the Open Brewery DB API.
Access person, company, school, location, job title, and skill data using the People Data Labs API.
Search and analyze nonprofit organizations' Form 990 data using ProPublica's Nonprofit Explorer API.
VIN Decoder, Vehicle Market Value, OCR VIN Scanner and other API services for the automotive industry.
MarketCheck automotive data: search US/UK listings, predict prices, decode VINs, market history.
Rakuten API integration for product search, hotel and travel booking, and recipe lookup across Japan's largest e-commerce platform.
Search product catalogs across thousands of Central European e-shops. Semantic search, keyword matching, GTIN/EAN lookup — via REST API or MCP. ~2,500 e-shops | ~8.5M products | 7 countries (CZ, SK, PL, HU, RO, DE, AT)
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
