Rhumb

Name: Rhumb
Author: supertrained

@supertrained

Rhumb について

Discover, evaluate, and execute external tools — with trust scores, failure modes, cost-aware routing, and managed credentials.

基本情報

カテゴリ

その他

トランスポート

stdio

公開者

supertrained

投稿者

supertrained

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "rhumb": {
      "command": "npx",
      "args": [
        "rhumb-mcp@latest"
      ]
    }
  }
}

ツール

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 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.

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 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.

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.

Given a Capability ID, returns ranked providers with health status, cost per call, auth methods, endpoint patterns, and fallback chains. This is the core routing decision: 'I need email.send — which provider should I use?' Call this before execute_capability to understand your options.

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 byo (BYOK). Other explicit modes: rhumb_managed — zero-config through Rhumb Resolve when available; byo — 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 see which modes are available.

Get the cost of a Capability call WITHOUT making the call. 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 byo (BYOK). Always call this before execute_capability for cost-sensitive workflows — no charge for estimates.

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 what credential modes are available to you. Shows: (1) which Capabilities have Rhumb Resolve credentials (ready to call immediately), (2) which Services have ceremony guides (self-provision in minutes), and (3) BYOK status. Start here when you're new to Rhumb or unsure what you can call.

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.

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.

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.

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 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 your billing history: charges (debits), top-ups (credits), and auto-reload events. Each entry shows amount, balance after, description, and timestamp. Most recent first.

概要

What is Rhumb?

Rhumb is an MCP server for agent-native tool intelligence. It discovers, evaluates, and executes external tools — with trust scores, failure modes, cost-aware routing, and managed credentials. It is designed for AI agents that need to find and call external services reliably.

How to use Rhumb?

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.

Key features of Rhumb

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

Use cases of Rhumb

Discover and evaluate external tools before integration by searching services and reviewing score breakdowns
Execute capabilities through Rhumb Resolve with managed authentication and cost estimation
Optimize spending by setting budgets and letting Rhumb route to the most cost-effective provider
Monitor usage and provider health via telemetry endpoints
Dispute service scores by opening a GitHub issue with evidence

FAQ from Rhumb

Do I need an API key to use Rhumb?

No. Discovery tools work immediately with no signup or API key. Only execution endpoints require a Rhumb API key.

How do I start using Rhumb?

Run npx rhumb-mcp@latest in your MCP-compatible client. Execution features require setting the RHUMB_API_KEY environment variable. You can get a key at rhumb.dev/auth/login.

Are all API endpoints public?

No. Read endpoints such as score, search, leaderboard, and pricing are public. Execution endpoints like POST /capabilities/{id}/execute require authentication.

What payment methods are supported?

You can use an API key with prepaid credits, or pay per call on-chain using x402/USDC without signing up.

Can I dispute a service score?

Yes. Open a GitHub issue with evidence or email [email protected]. Rhumb does not accept payment to change scores.

「その他」の他のコンテンツ

Awesome Mcp Servers

punkpeye

A collection of MCP servers.

90.5K

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K