# supertrained/rhumb [Health: Active] **Category:** πŸ”— Aggregators **Repository:** https://github.com/supertrained/rhumb **GitHub Stars:** 3 **Views:** 1 **Installs:** 0 **Upvotes:** 0 **Directory Page:** https://allmcps.com/mcp/supertrained-rhumb ## Description Agent-native tool intelligence across 1,000+ scored services. 21 MCP tools: discover services, check AN Scores, compare alternatives, resolve capabilities to ranked providers, execute through 3 credential modes (managed, BYOK, agent vault), track costs with receipts, and inspect failure modes. Zero-signup option via x402 micropayments. ## Tools Capabilities this server exposes over MCP: - **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, reco… - **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 ## Claude Desktop Quick Installation Install path detected from listing signals. Uses `npx` (confidence: high): ```json "mcpServers": { "rhumb": { "command": "npx", "args": ["-y","--package"] } } ``` ## Documentation & README # Rhumb [![npm version](https://img.shields.io/npm/v/rhumb-mcp)](https://www.npmjs.com/package/rhumb-mcp) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE) [![MCP Registry](https://img.shields.io/badge/MCP-Registry-green)](https://registry.modelcontextprotocol.io/v0/servers?search=rhumb) **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](https://rhumb.dev) Β· ⚑ [Quickstart](https://rhumb.dev/quickstart) Β· 🧭 [Resolve](https://rhumb.dev/resolve) Β· πŸ’΅ [Pricing](https://rhumb.dev/pricing) Β· πŸ“Š [Leaderboard](https://rhumb.dev/leaderboard) Β· πŸ“– [Methodology](https://rhumb.dev/methodology) Β· πŸ”‘ [Trust](https://rhumb.dev/trust) > **For agents:** See [`llms.txt`](https://github.com/supertrained/rhumb/blob/HEAD/llms.txt) for machine-readable documentation and [`agent-capabilities.json`](https://github.com/supertrained/rhumb/blob/HEAD/agent-capabilities.json) for structured capability metadata. --- ## Start in 30 seconds ### MCP (recommended) ```bash 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: ```bash RHUMB_API_KEY=your_key npx -y --package rhumb-mcp@latest rhumb-mcp ``` [Get a governed API key β†’](https://rhumb.dev/auth/login) ### API (read-only, no auth) ```bash 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. --- ## What Rhumb does 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. ### Best fit today Rhumb is strongest today for **research, extraction, generation, and narrow enrichment**. Treat broader multi-system business automation as future scope, not the current callable promise. Use Layer 2 capabilities for real work now, and treat Layer 3 as beta with an intentionally sparse public catalog. ### Rhumb Index β€” Discover & Evaluate **999 scored services** across 149 capability domains. Each gets an [AN Score](https://rhumb.dev/methodology) (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. ### Rhumb Resolve β€” Execute **435 capability definitions** across **28 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 callable promise. ### Repository visibility map | Surface | What it is for | Current honest boundary | |---------|----------------|-------------------------| | **Rhumb Index** | Free service discovery, AN Score lookup, alternatives, and failure-mode research | Broad discovery is not the same as execution readiness | | **Rhumb Resolve** | Governed execution for supported capabilities with estimates, receipts, budgets, and telemetry | 28 runtime-callable providers today; best fit is research, extraction, generation, and narrow enrichment | | **MCP package** | Agent-native entry point for Claude, Cursor, and other MCP clients | Discovery works without auth; execution needs a governed key, wallet-prefund, or x402 where supported | | **API** | Public read endpoints plus authenticated execution endpoints | Use current API responses as source of truth for readiness and callable coverage | ### Three credential paths | Path | How it works | |------|-------------| | **Rhumb-managed** | Rhumb holds the credential β€” zero setup for the agent | | **BYOK** | Bring your own provider API key. Rhumb routes, you authenticate | | **Agent Vault** | Your key, encrypted and stored β€” Rhumb injects at call time | ### Payment paths - **Governed API key** β€” sign up, get a key, prepaid credits - **x402 / USDC** β€” no signup, pay per call on-chain ### Resolve mental model - **Service** = vendor Rhumb evaluates and compares - **Capability** = executable action like `email.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 on `X-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 on `X-Rhumb-Key` - **Bring BYOK or Agent Vault** only when provider control is the point - **Use x402** when zero-signup per-call payment matters more than repeat throughput Canonical onboarding map: --- ## MCP tools `rhumb-mcp` exposes **21 tools**: **Discovery** - `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 **Execution** - `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 **Billing** - `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 **Operations** - `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 999 scored services, but current governed execution spans 28 callable providers. > Note: Layer 3 recipe tooling is live, but the public catalog can still be empty. Use `rhumb_list_recipes` or visit `/recipes` before assuming a workflow exists. > Best current fit: research, extraction, generation, and narrow enrichment. Treat general business-agent automation as future scope, not the current callable promise. --- ## API Base URL: `https://api.rhumb.dev/v1` | Endpoint | Auth | Purpose | |----------|------|---------| | `GET /services/{slug}/score` | No | Score breakdown | | `GET /services/{slug}` | No | Service profile + metadata | | `GET /services/{slug}/failures` | No | Known failure modes | | `GET /search?q=...` | No | Search services | | `GET /leaderboard/{category}` | No | Category rankings | | `GET /capabilities` | No | Capability registry | | `GET /capabilities/{id}/resolve` | No | Ranked providers + explicit `recovery_hint.*` fields | | `POST /capabilities/{id}/execute` | Yes | Execute a capability | | `GET /capabilities/{id}/execute/estimate` | Yes | Cost estimate | | `GET /telemetry/provider-health` | No | Provider health status | | `GET /telemetry/usage` | Yes | Your usage analytics | | `GET /pricing` | No | Machine-readable pricing | --- ## Examples See [`examples/`](https://github.com/supertrained/rhumb/blob/HEAD/examples/) for runnable scripts: | Example | What it shows | Auth needed? | |---------|--------------|-------------| | [discover-and-evaluate.py](https://github.com/supertrained/rhumb/blob/HEAD/examples/discover-and-evaluate.py) | Search β†’ Score β†’ Failure modes | No | | [resolve-and-execute.py](https://github.com/supertrained/rhumb/blob/HEAD/examples/resolve-and-execute.py) | Resolve β†’ machine-readable recovery handoff β†’ Estimate β†’ Execute | No for resolve, yes for estimate/execute | | [budget-aware-routing.py](https://github.com/supertrained/rhumb/blob/HEAD/examples/budget-aware-routing.py) | Budget + cost-optimal routing | Yes | | [dogfood-telemetry-loop.py](https://github.com/supertrained/rhumb/blob/HEAD/examples/dogfood-telemetry-loop.py) | Repeatable Resolve β†’ telemetry verification loop | Yes | | [mcp-quickstart.md](https://github.com/supertrained/rhumb/blob/HEAD/examples/mcp-quickstart.md) | MCP setup for Claude, Cursor, etc. | Optional | ```bash # 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.py` will still show the ranked providers plus any machine-readable recovery handoff Rhumb already identified. Set `RHUMB_API_KEY` only when you want to continue into estimate and execute. --- ## Docs - [Agent Accessibility Guidelines](https://github.com/supertrained/rhumb/blob/HEAD/docs/AGENT-ACCESSIBILITY-GUIDELINES.md) β€” making web interfaces usable by AI agents - [AN Score Methodology](https://github.com/supertrained/rhumb/blob/HEAD/docs/AN-SCORE-V2-SPEC.md) β€” scoring dimensions, weights, and rubrics - [Architecture](https://github.com/supertrained/rhumb/blob/HEAD/docs/ARCHITECTURE.md) β€” scoring engine design - [API Reference](https://github.com/supertrained/rhumb/blob/HEAD/docs/API.md) β€” endpoint details - [Repo Boundary](https://github.com/supertrained/rhumb/blob/HEAD/docs/REPO-BOUNDARY.md) β€” what stays public here vs. what lives in the private ops workspace - [Security Policy](https://github.com/supertrained/rhumb/blob/HEAD/SECURITY.md) β€” vulnerability reporting and security architecture --- ## 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 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 ``` --- ## Development ```bash # 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 (`.nvmrc` included). --- ## Score disputes Every score is disputable. If you believe a score is inaccurate: 1. Read the public provider guide at [rhumb.dev/providers](https://rhumb.dev/providers) 2. [Open the score-dispute GitHub template](https://github.com/supertrained/rhumb/issues/new?template=score-dispute.md) with evidence 3. Or email [providers@supertrained.ai](mailto:providers@supertrained.ai?subject=Score%20Dispute) for a private path We target an initial response within 5 business days. Negative findings remain visible. Rhumb does not accept payment to change scores. --- ## Links - **Website:** [rhumb.dev](https://rhumb.dev) - **npm:** [rhumb-mcp](https://www.npmjs.com/package/rhumb-mcp) - **MCP Registry:** [Rhumb on MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=rhumb) - **X:** [@pedrorhumb](https://x.com/pedrorhumb) ## License [MIT](https://github.com/supertrained/rhumb/blob/HEAD/LICENSE)