{"id":47712939,"url":"https://github.com/supertrained/rhumb","last_synced_at":"2026-04-02T18:41:42.040Z","repository":{"id":342181376,"uuid":"1173152761","full_name":"supertrained/rhumb","owner":"supertrained","description":"Agent-native tool intelligence — discover, evaluate, and execute 695+ services across 414 capabilities with trust scores, cost-aware routing, and three credential modes.","archived":false,"fork":false,"pushed_at":"2026-03-27T16:04:11.000Z","size":2816,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-27T17:48:03.148Z","etag":null,"topics":["agent-native","ai-agents","an-score","api-evaluation","api-scoring","developer-tools","mcp","tool-discovery"],"latest_commit_sha":null,"homepage":"https://rhumb.dev","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/supertrained.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-05T04:01:06.000Z","updated_at":"2026-03-27T16:04:15.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/supertrained/rhumb","commit_stats":null,"previous_names":["supertrained/rhumb"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/supertrained/rhumb","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supertrained%2Frhumb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supertrained%2Frhumb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supertrained%2Frhumb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supertrained%2Frhumb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/supertrained","download_url":"https://codeload.github.com/supertrained/rhumb/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supertrained%2Frhumb/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31313187,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-native","ai-agents","an-score","api-evaluation","api-scoring","developer-tools","mcp","tool-discovery"],"created_at":"2026-04-02T18:41:37.506Z","updated_at":"2026-04-02T18:41:42.032Z","avatar_url":"https://github.com/supertrained.png","language":"Python","funding_links":[],"categories":["CI/CD \u0026 DevOps Pipelines","🔎 Search","📦 Other"],"sub_categories":["🔗 Aggregators"],"readme":"# Rhumb\n\n[![npm version](https://img.shields.io/npm/v/rhumb-mcp)](https://www.npmjs.com/package/rhumb-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![MCP Registry](https://img.shields.io/badge/MCP-Registry-green)](https://registry.modelcontextprotocol.io)\n\n**Agent-native tool intelligence.** Discover, evaluate, and execute external tools — with trust scores, failure modes, cost-aware routing, and managed credentials.\n\n🌐 [rhumb.dev](https://rhumb.dev) · ⚡ [Quickstart](https://rhumb.dev/quickstart) · 💵 [Pricing](https://rhumb.dev/pricing) · 📊 [Leaderboard](https://rhumb.dev/leaderboard) · 📖 [Methodology](https://rhumb.dev/methodology) · 🔑 [Trust](https://rhumb.dev/trust)\n\n\u003e **For agents:** See [`llms.txt`](llms.txt) for machine-readable documentation and [`agent-capabilities.json`](agent-capabilities.json) for structured capability metadata.\n\n---\n\n## Start in 30 seconds\n\n### MCP (recommended)\n\n```bash\nnpx rhumb-mcp@latest\n```\n\nZero config. Discovery tools work immediately — no signup, no API key.\n\nFor execution, pass your Rhumb API key:\n\n```bash\nRHUMB_API_KEY=your_key npx rhumb-mcp@latest\n```\n\n[Get an API key →](https://rhumb.dev/auth/login)\n\n### API (read-only, no auth)\n\n```bash\ncurl \"https://api.rhumb.dev/v1/services/stripe/score\"\n```\n\nAll read endpoints are public.\n\n---\n\n## What Rhumb does\n\nAgents need external tools. Choosing the right one is hard — not because of feature lists, but because of:\n\n- auth and signup friction\n- provisioning reality vs. marketing claims\n- schema instability\n- failure recovery when no human is watching\n- hidden costs and rate limits\n\nRhumb makes those constraints visible before you commit.\n\n### Best fit today\n\nRhumb is strongest today for **research, extraction, generation, and narrow enrichment**.\n\nTreat 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.\n\n\u003c!-- GENERATED:README_PRODUCT_SURFACE_START --\u003e\n### Rhumb Index — Discover \u0026 Evaluate\n\n**1,038 scored services** across 50+ domains. Each gets an [AN Score](https://rhumb.dev/methodology) (0–10) measuring execution quality, access readiness, and agent autonomy support.\n\n- `find_services` — Search indexed Services by what you need them to do\n- `get_score` — Get the full AN Score breakdown for a Service: execution quality, access readiness, autonomy level, tier label, and freshness\n- `get_alternatives` — Find alternative Services, ranked by AN Score\n- `get_failure_modes` — Get known failure patterns, impact severity, and workarounds for a service\n- `discover_capabilities` — Browse Capabilities by domain or search text\n- `resolve_capability` — Given a Capability ID, returns ranked providers with health status, cost per call, auth methods, endpoint patterns, and fallback chains\n\n\u003e Discovery breadth is wider than current execution coverage. The index is broader than what Rhumb can execute today.\n\n### Rhumb Resolve — Execute\n\n**415 capability definitions** across **16 callable providers today**. Cost-aware routing picks the best provider where execution is actually live.\n\n- `execute_capability` — Call a Capability through Rhumb Resolve\n- `resolve_capability` — Given a Capability ID, returns ranked providers with health status, cost per call, auth methods, endpoint patterns, and fallback chains\n- `estimate_capability` — Get the cost of a Capability call WITHOUT making the call\n- `get_receipt` — Retrieve an execution receipt by ID\n- Budget enforcement, credential management, and execution telemetry included\n\n\u003e 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.\n\u003c!-- GENERATED:README_PRODUCT_SURFACE_END --\u003e\n\n### Three credential modes\n\n| Mode | How it works |\n|------|-------------|\n| **BYO** | Bring your own API key — Rhumb routes, you authenticate |\n| **Rhumb-managed** | Rhumb holds the credential — zero setup for the agent |\n| **Agent Vault** | Your key, encrypted and stored — Rhumb injects at call time |\n\n### Payment paths\n\n- **API key** — sign up, get a key, prepaid credits\n- **x402 / USDC** — no signup, pay per call on-chain\n\n### Resolve mental model\n\n- **Service** = vendor Rhumb evaluates and compares\n- **Capability** = executable action like `email.send`\n- **Recipe** = deterministic multi-step workflow on top of capabilities (beta, sparse public catalog)\n- **Layer 2 is the default path** — discover a Service, choose a Capability, estimate, then execute\n- **Default auth for repeat traffic** = governed API key or wallet-prefunded API key\n- **Use x402** when zero-signup per-call payment matters more than repeat throughput\n\nCanonical onboarding map: \u003chttps://rhumb.dev/docs#resolve-mental-model\u003e\n\n---\n\n## MCP tools\n\n\u003c!-- GENERATED:README_MCP_TOOLS_START --\u003e\n`rhumb-mcp` exposes **21 tools**:\n\n**Discovery**\n- `find_services` — Search indexed Services by what you need them to do\n- `get_score` — Get the full AN Score breakdown for a Service: execution quality, access readiness, autonomy level, tier label, and freshness\n- `get_alternatives` — Find alternative Services, ranked by AN Score\n- `get_failure_modes` — Get known failure patterns, impact severity, and workarounds for a service\n- `discover_capabilities` — Browse Capabilities by domain or search text\n- `resolve_capability` — Given a Capability ID, returns ranked providers with health status, cost per call, auth methods, endpoint patterns, and fallback chains\n\n**Execution**\n- `execute_capability` — Call a Capability through Rhumb Resolve\n- `estimate_capability` — Get the cost of a Capability call WITHOUT making the call\n- `credential_ceremony` — Get step-by-step instructions to obtain API credentials for a Service\n- `check_credentials` — Check what credential modes are available to you\n- `rhumb_list_recipes` — List the current published Rhumb Layer 3 recipe catalog\n- `rhumb_get_recipe` — Get the full published definition for a Rhumb recipe, including input/output schemas and step topology\n- `rhumb_recipe_execute` — Execute a published Rhumb Layer 3 recipe once one is live in the public catalog\n- `get_receipt` — Retrieve an execution receipt by ID\n\n**Billing**\n- `budget` — Check or set your call spending limit\n- `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\n- `check_balance` — Check your current Rhumb credit balance in USD\n- `get_payment_url` — Get a checkout URL to add credits to your Rhumb balance\n- `get_ledger` — Get your billing history: charges (debits), top-ups (credits), and auto-reload events\n\n**Operations**\n- `routing` — Get or set how Rhumb auto-selects providers when you don't specify one in execute_capability\n- `usage_telemetry` — Get your execution analytics — calls, latency, errors, costs, and provider health for your Rhumb usage\n\n\u003e Discovery spans 1,038 scored services, but current governed execution spans 16 callable providers.\n\n\u003e 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.\n\n\u003e Best current fit: research, extraction, generation, and narrow enrichment. Treat general business-agent automation as future scope, not the current launch promise.\n\u003c!-- GENERATED:README_MCP_TOOLS_END --\u003e\n\n---\n\n## API\n\nBase URL: `https://api.rhumb.dev/v1`\n\n| Endpoint | Auth | Purpose |\n|----------|------|---------|\n| `GET /services/{slug}/score` | No | Score breakdown |\n| `GET /services/{slug}` | No | Service profile + metadata |\n| `GET /services/{slug}/failures` | No | Known failure modes |\n| `GET /search?q=...` | No | Search services |\n| `GET /leaderboard/{category}` | No | Category rankings |\n| `GET /capabilities` | No | Capability registry |\n| `GET /capabilities/{id}/resolve` | No | Ranked providers |\n| `POST /capabilities/{id}/execute` | Yes | Execute a capability |\n| `GET /capabilities/{id}/execute/estimate` | Yes | Cost estimate |\n| `GET /telemetry/provider-health` | No | Provider health status |\n| `GET /telemetry/usage` | Yes | Your usage analytics |\n| `GET /pricing` | No | Machine-readable pricing |\n\n---\n\n## Examples\n\nSee [`examples/`](examples/) for runnable scripts:\n\n| Example | What it shows | Auth needed? |\n|---------|--------------|-------------|\n| [discover-and-evaluate.py](examples/discover-and-evaluate.py) | Search → Score → Failure modes | No |\n| [resolve-and-execute.py](examples/resolve-and-execute.py) | Resolve → Estimate → Execute | Yes |\n| [budget-aware-routing.py](examples/budget-aware-routing.py) | Budget + cost-optimal routing | Yes |\n| [dogfood-telemetry-loop.py](examples/dogfood-telemetry-loop.py) | Repeatable Resolve → telemetry verification loop | Yes |\n| [mcp-quickstart.md](examples/mcp-quickstart.md) | MCP setup for Claude, Cursor, etc. | Optional |\n\n```bash\n# Try discovery right now (no auth needed)\npip install httpx \u0026\u0026 python examples/discover-and-evaluate.py\n```\n\n---\n\n## Docs\n\n- [Agent Accessibility Guidelines](docs/AGENT-ACCESSIBILITY-GUIDELINES.md) — making web interfaces usable by AI agents\n- [AN Score Methodology](docs/AN-SCORE-V2-SPEC.md) — scoring dimensions, weights, and rubrics\n- [Architecture](docs/ARCHITECTURE.md) — scoring engine design\n- [API Reference](docs/API.md) — endpoint details\n- [Security Policy](SECURITY.md) — vulnerability reporting and security architecture\n- [Runbooks](docs/runbooks/) — operational procedures\n- [Dogfood Loop](docs/DOGFOOD-LOOP.md) — repeatable Resolve → telemetry validation harness\n\n---\n\n## Repo structure\n\n```\nrhumb/\n├── packages/\n│   ├── api/         # Python API (Railway)\n│   ├── astro-web/   # Public website (Vercel)\n│   ├── mcp/         # MCP server (npm)\n│   ├── cli/         # CLI tooling\n│   └── shared/      # Shared types/constants\n├── examples/        # Runnable examples\n├── docs/            # Public documentation\n├── scripts/         # Scoring + verification\n├── artifacts/       # Score datasets\n├── llms.txt         # Machine-readable docs for agents\n└── agent-capabilities.json  # Structured capability manifest\n```\n\n---\n\n## Development\n\n```bash\n# API\ncd packages/api \u0026\u0026 pip install -r requirements.txt \u0026\u0026 uvicorn app:app --reload\n\n# MCP\ncd packages/mcp \u0026\u0026 npm ci \u0026\u0026 npm run dev\n\n# Web\ncd packages/astro-web \u0026\u0026 npm ci \u0026\u0026 npm run dev\n```\n\nNode 24+ recommended (`.nvmrc` included).\n\n---\n\n## Score disputes\n\nEvery score is disputable. If you believe a score is inaccurate:\n\n1. [Open a GitHub issue](https://github.com/supertrained/rhumb/issues/new) with evidence\n2. Or email [providers@supertrained.ai](mailto:providers@supertrained.ai)\n\nNegative findings remain visible. Rhumb does not accept payment to change scores.\n\n---\n\n## Links\n\n- **Website:** [rhumb.dev](https://rhumb.dev)\n- **npm:** [rhumb-mcp](https://www.npmjs.com/package/rhumb-mcp)\n- **MCP Registry:** [Rhumb on MCP Registry](https://registry.modelcontextprotocol.io)\n- **X:** [@pedrorhumb](https://x.com/pedrorhumb)\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsupertrained%2Frhumb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsupertrained%2Frhumb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsupertrained%2Frhumb/lists"}