io.github.supertrained/rhumb-mcp
NPM · RHUMB-MCP · SCANNED AUG 3
Agent gateway for Index discovery, AN Score evaluation, and Resolve governed execution
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →
Supply Chain Security86
- No malware found by supply-chain analysis.Pass
- Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.Partial
- No install/post-install scripts declared.Pass
- Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency45
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 83 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability71
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 2190 tokens (~136/item across 16 items; 16 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management23
- Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
npm · rhumb-mcp
claude mcp add supertrained-rhumb-mcp -- npx -y rhumb-mcp
codex mcp add supertrained-rhumb-mcp -- npx -y rhumb-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"supertrained-rhumb-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"rhumb-mcp"
],
"enabled": true
}
}
} openclaw mcp add supertrained-rhumb-mcp --command npx --arg -y --arg rhumb-mcp
mcp_servers:
supertrained-rhumb-mcp:
command: "npx"
args: ["-y", "rhumb-mcp"] {
"mcpServers": {
"supertrained-rhumb-mcp": {
"command": "npx",
"args": [
"-y",
"rhumb-mcp"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 2 Aug 26 +47
- Provenance: unverified → fail ▼ security
- Known CVEs: unverified → partial ▲ security
- Install scripts: unverified → pass ▲ security
- Malware scan: unverified → pass ▲ security
- Security disclosure: fail → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- MCP protocol: unverified → pass ▲ functional
- Maintenance: unverified → pass ▲ functional
- Stability: unverified → 0.20 ▲ functional
- Dependency health: unverified → partial ▲ functional
- License: unverified → pass ▲ functional
- Schema quality: unverified → excellent ▲ functional
- Licence: MIT functional
- 1 Aug 26 −7
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 31 Jul 26 +2
- Malware scan: pass → unverified ▼ security
- Dependency health: partial → unverified ▼ functional
- Tool coverage: unverified → 100 ▲ functional
- 30 Jul 26 −20
- Tool coverage: 100 → unverified ▼ functional
- Dependency health: unverified → partial ▲ functional
- 28 Jul 26 +21
- Tool coverage: unverified → 100 ▲ functional
- First check of Tool coverage: 100 functional
- First check of Schema quality: unverified functional
- First check of Schema quality: fail functional
- First check of Schema quality: fail functional
- 27 Jul 26 24
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Analysed npm/[email protected]
Provenance none
Ecosystem: npm · Outcome: none
Dependencies 94 packages
94 packages in the resolved dependency tree · 94 deprecated · 29 stale.
The dependency tree was only partially resolved, so these counts may be incomplete.
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
budget ~167
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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | — | 'get' (check current budget) or 'set' (create/update). Default: 'get' |
| budget_usd | number | — | Budget cap in USD. Required when action='set'. Example: 10.00 for $10/month. |
| hard_limit | boolean | — | true = reject calls over budget with HTTP 402. false = warn but allow. Default: true |
| period | string | — | 'daily', 'weekly', 'monthly', or 'total'. Default: 'monthly'. Resets at period boundary. |
No output schema declared.
No examples provided.
check_balance ~40
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.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
check_credentials ~114
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.
| Name | Type | Req | Description |
|---|---|---|---|
| capability | string | — | Check a specific Capability (e.g. 'email.send'). Omit to see all modes and managed Capabilities. Start here to understand what you can call and how. |
No output schema declared.
No examples provided.
credential_ceremony ~116
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.
| Name | Type | Req | Description |
|---|---|---|---|
| service | string | — | Service slug (e.g. 'openai', 'stripe', 'resend'). Returns step-by-step signup instructions, expected token format, and verification endpoint. Omit to list all services with available ceremonies. |
No output schema declared.
No examples provided.
discover_capabilities ~175
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.
| Name | Type | Req | Description |
|---|---|---|---|
| domain | string | — | Filter by domain: 'email', 'payment', 'ai', 'communication', 'data', 'storage', 'search', etc. Omit for all domains. |
| limit | number | — | Max results (default 20). Returns capability IDs you can pass to resolve_capability. |
| search | string | — | Free-text search across capability names and descriptions. Examples: 'send message', 'charge card', 'scrape website' |
No output schema declared.
No examples provided.
estimate_capability ~199
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.
| Name | Type | Req | Description |
|---|---|---|---|
| capability_id | string | yes | Capability to estimate (e.g. 'email.send'). Call this BEFORE execute_capability to know the cost in advance. |
| credential_mode | string | — | 'auto' (default: use Rhumb Resolve when an active managed config exists, otherwise fall back to byo), 'rhumb_managed', 'byo' (BYOK), or 'agent_vault'. Affects pricing — rhumb_managed includes a 20% m… |
| provider | string | — | Specific provider slug. Omit to estimate for the auto-selected provider based on your routing strategy. |
No output schema declared.
No examples provided.
execute_capability ~507
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.
| Name | Type | Req | Description |
|---|---|---|---|
| agent_token | string | — | Your API token for byo/agent_vault mode. For agent_vault: obtain via credential_ceremony first. Never stored by Rhumb — used for this single call only. |
| body | object | — | Request body in the provider's native format. See provider docs or resolve_capability for expected structure. |
| capability_id | string | yes | Capability to call (e.g. 'email.send', 'payment.charge'). Get IDs from discover_capabilities or resolve_capability. |
| credential_mode | string | — | 'auto' (default: use Rhumb Resolve when an active managed config exists, otherwise fall back to byo), 'rhumb_managed' (Rhumb Resolve zero-config call path), 'byo' (BYOK via agent_token — requires met… |
| idempotency_key | string | — | UUID for safe retry — if this request was already processed, returns the cached result instead of re-calling the provider. Required to enable automatic fallback to backup providers on failure. |
| method | string | — | HTTP method (GET, POST, PUT, PATCH, DELETE). Required for byo (BYOK) and agent_vault modes. Not needed for rhumb_managed. |
| params | object | — | URL query parameters as key-value pairs |
| path | string | — | Provider API path (e.g. '/v3/mail/send'). Get the pattern from resolve_capability. Required for byo (BYOK)/agent_vault. Not needed for rhumb_managed. |
| provider | string | — | Specific provider slug (e.g. 'resend', 'stripe'). Omit to let Rhumb auto-select the best healthy provider based on your routing strategy. |
No output schema declared.
No examples provided.
find_services ~129
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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | number | — | Max results (default 10). Each result includes a slug you can pass to get_score, get_alternatives, or get_failure_modes. |
| query | string | yes | What you need the Service to do, in natural language. Examples: 'send email', 'process payments', 'generate images', 'web scraping' |
No output schema declared.
No examples provided.
get_alternatives ~70
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.
| Name | Type | Req | Description |
|---|---|---|---|
| slug | string | yes | Service slug from find_services results (e.g. 'stripe'). Returns other Services in the same category, ranked by AN Score. |
No output schema declared.
No examples provided.
get_failure_modes ~74
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.
| Name | Type | Req | Description |
|---|---|---|---|
| slug | string | yes | Service slug from find_services results (e.g. 'stripe'). Returns known failure patterns, impact severity, and workarounds. |
No output schema declared.
No examples provided.
get_ledger ~84
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.
| Name | Type | Req | Description |
|---|---|---|---|
| event_type | string | — | Filter: debit, credit_added, auto_reload_triggered |
| limit | number | — | Number of entries (default 20, max 100) |
No output schema declared.
No examples provided.
get_payment_url ~62
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.
| Name | Type | Req | Description |
|---|---|---|---|
| amount_usd | number | yes | Amount to add in USD (min $5, max $5000) |
No output schema declared.
No examples provided.
get_score ~74
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.
| Name | Type | Req | Description |
|---|---|---|---|
| slug | string | yes | Service identifier from find_services results (e.g. 'stripe', 'sendgrid', 'openai', 'twilio') |
No output schema declared.
No examples provided.
resolve_capability ~103
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.
| Name | Type | Req | Description |
|---|---|---|---|
| capability | string | yes | Capability ID from discover_capabilities (e.g. 'email.send', 'payment.charge'). Returns ranked providers with costs, health status, and fallback chains. |
No output schema declared.
No examples provided.
routing ~196
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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | — | 'get' (check current strategy) or 'set' (update). Default: 'get' |
| max_cost_per_call_usd | number | — | Hard ceiling on per-call cost. Calls that would exceed this are rejected with 402. |
| quality_floor | number | — | Minimum AN Score (0-10). Providers below this are excluded from auto-selection. Default: 6.0 |
| strategy | string | — | 'cheapest' (lowest cost above quality floor), 'fastest' (healthiest circuits, lowest latency), 'highest_quality' (highest AN Score), or 'balanced' (weighted mix of all three). Default: 'balanced' |
No output schema declared.
No examples provided.
spend ~80
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.
| Name | Type | Req | Description |
|---|---|---|---|
| period | string | — | Billing period as YYYY-MM (e.g. '2026-03'). Defaults to current month. Returns per-capability and per-provider spend breakdown. |
No output schema declared.
No examples provided.