Rhumb MCP

Inteligência de ferramentas nativa para agentes — descubra, pontue e compare mais de 600 APIs em 16 ferramentas MCP. Descoberta sem cadastro, metodologia AN Score, dados de modos de falha e execução gerenciada.

GitHub
3

Documentação

Rhumb

npm version License: MIT MCP Registry

Index ranqueia. Resolve roteia. Rhumb é um gateway de agente para ferramentas externas: Index pontua e compara serviços; Resolve roteia chamadas de capacidades suportadas por trilhos de execução governados com recibos.

🌐 rhumb.dev · ⚡ Início rápido · 🧭 Resolve · 💵 Preços · 📊 Ranking · 📖 Metodologia · 🔑 Confiança

Para agentes: Consulte llms.txt para documentação legível por máquina e agent-capabilities.json para metadados estruturados de capacidades.

Comece em 30 segundos

MCP (recomendado)

npx -y --package rhumb-mcp@latest rhumb-mcp

Zero configuração. As ferramentas de descoberta funcionam imediatamente — sem cadastro, sem chave de API governada.

Para execução, passe sua chave de API governada:

RHUMB_API_KEY=your_key npx -y --package rhumb-mcp@latest rhumb-mcp

Obtenha uma chave de API governada →

API (somente leitura, sem autenticação)

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"

Todos os endpoints de leitura são públicos, incluindo verificações de prontidão do Resolve. Estimativa e execução exigem um caminho de pagamento autenticado.

O que o Rhumb faz

Use o Rhumb Index quando um agente precisar descobrir e avaliar serviços. Use o Rhumb Resolve quando a tarefa estiver em um caminho de capacidade suportado e você quiser execução governada com um recibo explícito.

Agentes precisam de ferramentas externas. Escolher a certa é difícil — não por causa das listas de recursos, mas por causa de:

  • atrito de autenticação e cadastro
  • realidade de provisionamento vs. alegações de marketing
  • instabilidade de esquema
  • recuperação de falhas quando nenhum humano está observando
  • custos ocultos e limites de taxa

O Rhumb torna essas restrições visíveis antes de você se comprometer.

Melhor adequação hoje

O Rhumb é mais forte hoje para pesquisa, extração, geração e enriquecimento específico.

Trate automação de negócios multi-sistema mais ampla como escopo futuro, não como a promessa atual de lançamento. Use capacidades da Camada 2 para trabalho real agora, e trate a Camada 3 como beta com um catálogo público intencionalmente esparso.

Rhumb Index — Descubra e Avalie

1.038 serviços pontuados em mais de 50 domínios. Cada um recebe uma Pontuação AN (0–10) que mede qualidade de execução, prontidão de acesso e suporte à autonomia do agente.

  • find_services — Pesquise Serviços indexados pelo que você precisa que eles façam
  • get_score — Obtenha o detalhamento completo da Pontuação AN para um Serviço: qualidade de execução, prontidão de acesso, nível de autonomia, rótulo de nível e atualização
  • get_alternatives — Encontre Serviços alternativos, classificados por Pontuação AN
  • get_failure_modes — Obtenha padrões de falha conhecidos, gravidade do impacto e soluções alternativas para um serviço
  • discover_capabilities — Navegue por Capacidades por domínio ou texto de pesquisa
  • resolve_capability — Dado um ID de Capacidade e, opcionalmente, um modo de credencial, retorna provedores classificados com status de saúde, custo por chamada, métodos de autenticação, padrões de endpoint, orientação de execução e campos de recuperação legíveis por máquina como recovery_hint.resolve_url, recovery_hint.credential_modes_url e, quando aplicável, recovery_hint.alternate_execute_hint ou recovery_hint.setup_handoff, além de recuperação de erros de digitação quando o ID de capacidade está incorreto

A amplitude da descoberta é maior que a cobertura atual de execução. O índice é mais amplo do que o Rhumb pode executar hoje.

Rhumb Resolve — Execute

415 definições de capacidades em 16 provedores chamáveis hoje. O Resolve escolhe o provedor suportado mais adequado para a chamada usando Pontuação AN, disponibilidade / estado do circuito, custo estimado, proxy de latência, modo de credencial e restrições de política explícitas.

  • execute_capability — Chame uma Capacidade através do Rhumb Resolve
  • resolve_capability — Dado um ID de Capacidade e, opcionalmente, um modo de credencial, retorna provedores classificados com status de saúde, custo por chamada, métodos de autenticação, padrões de endpoint, orientação de execução e campos de recuperação legíveis por máquina como recovery_hint.resolve_url, recovery_hint.credential_modes_url e, quando aplicável, recovery_hint.alternate_execute_hint ou recovery_hint.setup_handoff, além de recuperação de erros de digitação quando o ID de capacidade está incorreto
  • estimate_capability — Estime o trilho de execução ativo, custo e saúde antes de uma chamada de Capacidade; caminhos anônimos diretos de sistema de registro também preservam transferências de execute_readiness legíveis por máquina
  • get_receipt — Recupere um recibo de execução por ID
  • Aplicação de orçamento, gerenciamento de credenciais e telemetria de execução incluídos

Melhor adequação atual: pesquisa, extração, geração e enriquecimento específico. Trate automação geral de agentes de negócios e orquestração multi-sistema ampla como escopo futuro, não como a promessa atual de lançamento.

Mapa de visibilidade do repositório

SuperfíciePara que serveLimite honesto atual
Rhumb IndexDescoberta gratuita de serviços, consulta de Pontuação AN, alternativas e pesquisa de modos de falhaDescoberta ampla não é o mesmo que prontidão de execução
Rhumb ResolveExecução governada para capacidades suportadas com estimativas, recibos, orçamentos e telemetria18 provedores chamáveis em runtime hoje; melhor adequação é pesquisa, extração, geração e enriquecimento específico
Pacote MCPPonto de entrada nativo para agentes em Claude, Cursor e outros clientes MCPDescoberta funciona sem autenticação; execução precisa de chave governada, pré-pagamento de carteira ou x402 onde suportado
APIEndpoints públicos de leitura mais endpoints autenticados de execuçãoUse as respostas atuais da API como fonte de verdade para prontidão e cobertura chamável

Três caminhos de credenciais

CaminhoComo funciona
Gerenciado pelo RhumbO Rhumb guarda a credencial — zero configuração para o agente
BYOKTraga sua própria chave de API do provedor. O Rhumb roteia, você autentica
Cofre do AgenteSua chave, criptografada e armazenada — o Rhumb injeta no momento da chamada

Caminhos de pagamento

  • Chave de API governada — cadastre-se, obtenha uma chave, créditos pré-pagos
  • x402 / USDC — sem cadastro, pague por chamada on-chain

Modelo mental do Resolve

  • Serviço = fornecedor que o Rhumb avalia e compara
  • Capacidade = ação executável como email.send
  • Receita = fluxo de trabalho determinístico de múltiplas etapas sobre capacidades (beta, catálogo público esparso)
  • A Camada 2 é o caminho padrão — comece com chave de API governada ou pré-pagamento de carteira em X-Rhumb-Key, descubra um Serviço, escolha uma Capacidade, estime e depois execute
  • Comece com superpoderes gerenciados primeiro — traga BYOK ou Cofre do Agente apenas quando o fluxo de trabalho tocar seus próprios sistemas
  • Autenticação padrão para tráfego repetido = chave de API governada ou pré-pagamento de carteira em X-Rhumb-Key
  • Traga BYOK ou Cofre do Agente apenas quando o controle do provedor for o ponto central
  • Use x402 quando pagamento por chamada sem cadastro importar mais que throughput repetido

Mapa canônico de integração: https://rhumb.dev/docs#resolve-mental-model

Ferramentas MCP

rhumb-mcp expõe 21 ferramentas:

Descoberta

  • find_services — Pesquise Serviços indexados pelo que você precisa que eles façam
  • get_score — Obtenha o detalhamento completo da Pontuação AN para um Serviço: qualidade de execução, prontidão de acesso, nível de autonomia, rótulo de nível e atualização
  • get_alternatives — Encontre Serviços alternativos, classificados por Pontuação AN
  • get_failure_modes — Obtenha padrões de falha conhecidos, gravidade do impacto e soluções alternativas para um serviço
  • discover_capabilities — Navegue por Capacidades por domínio ou texto de pesquisa
  • resolve_capability — Dado um ID de Capacidade e, opcionalmente, um modo de credencial, retorna provedores classificados com status de saúde, custo por chamada, métodos de autenticação, padrões de endpoint, orientação de execução e campos de recuperação legíveis por máquina como recovery_hint.resolve_url, recovery_hint.credential_modes_url e, quando aplicável, recovery_hint.alternate_execute_hint ou recovery_hint.setup_handoff, além de recuperação de erros de digitação quando o ID de capacidade está incorreto

Execução

  • execute_capability — Chame uma Capacidade através do Rhumb Resolve
  • estimate_capability — Estime o trilho de execução ativo, custo e saúde antes de uma chamada de Capacidade; caminhos anônimos diretos de sistema de registro também preservam transferências de execute_readiness legíveis por máquina
  • credential_ceremony — Obtenha instruções passo a passo para obter credenciais de API para um Serviço
  • check_credentials — Inspecione a prontidão do modo de credencial ao vivo, globalmente ou para uma Capacidade específica
  • rhumb_list_recipes — Liste o catálogo atual publicado de receitas da Camada 3 do Rhumb
  • rhumb_get_recipe — Obtenha a definição publicada completa de uma receita do Rhumb, incluindo esquemas de entrada/saída e topologia de etapas
  • rhumb_recipe_execute — Execute uma receita publicada da Camada 3 do Rhumb assim que estiver ativa no catálogo público
  • get_receipt — Recupere um recibo de execução por ID

Cobrança

  • budget — Verifique ou defina seu limite de gastos por chamada
  • spend — Obtenha seu detalhamento de gastos para um período de cobrança: total gasto em USD, contagem de chamadas, custo médio por chamada, dividido por Capacidade e por provedor
  • check_balance — Verifique seu saldo atual de créditos Rhumb em USD
  • get_payment_url — Obtenha uma URL de checkout para adicionar créditos ao seu saldo Rhumb
  • get_ledger — Obtenha seu histórico de cobrança: cobranças (débitos), recargas (créditos) e eventos de recarga automática

Operações

  • routing — Obtenha ou defina como o Rhumb seleciona automaticamente provedores quando você não especifica um em execute_capability
  • usage_telemetry — Obtenha suas análises de execução — chamadas, latência, erros, custos e saúde do provedor para seu uso do Rhumb

A descoberta abrange 1.038 serviços pontuados, mas a execução governada atual abrange 16 provedores chamáveis.

Nota: As ferramentas de receitas da Camada 3 estão ativas, mas o catálogo público ainda pode estar vazio. Use rhumb_list_recipes ou visite /recipes antes de assumir que um fluxo de trabalho existe.

Melhor adequação atual: pesquisa, extração, geração e enriquecimento específico. Trate automação geral de agentes de negócios como escopo futuro, não como a promessa atual de lançamento.

API

URL base: https://api.rhumb.dev/v1

EndpointAutenticaçãoFinalidade
GET /services/{slug}/scoreNãoDetalhamento de pontuação
GET /services/{slug}NãoPerfil do serviço + metadados
GET /services/{slug}/failuresNãoModos de falha conhecidos
GET /search?q=...NãoPesquisar serviços
GET /leaderboard/{category}NãoRankings por categoria
GET /capabilitiesNãoRegistro de capacidades
GET /capabilities/{id}/resolveNãoProvedores classificados + campos explícitos de recovery_hint.*
POST /capabilities/{id}/executeSimExecutar uma capacidade
GET /capabilities/{id}/execute/estimateSimEstimativa de custo
GET /telemetry/provider-healthNãoStatus de saúde do provedor
GET /telemetry/usageSimSuas análises de uso
GET /pricingNãoPreços legíveis por máquina

Exemplos

Consulte examples/ para scripts executáveis:

ExemploO que mostraAutenticação necessária?
discover-and-evaluate.pyPesquisar → Pontuar → Modos de falhaNão
resolve-and-execute.pyResolve → transferência de recuperação legível por máquina → Estimar → ExecutarNão para resolve, sim para estimar/executar
budget-aware-routing.pyOrçamento + roteamento de custo idealSim
dogfood-telemetry-loop.pyLoop repetível de Resolve → verificação de telemetriaSim
mcp-quickstart.mdConfiguração MCP para Claude, Cursor, etc.Opcional
# 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 ainda mostrará os provedores classificados mais qualquer transferência de recuperação legível por máquina que o Rhumb já identificou. Defina RHUMB_API_KEY somente quando quiser continuar para estimativa e execução.

Documentação

Estrutura do repositório

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

Desenvolvimento

# 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+ recomendado (.nvmrc incluído).

Disputas de pontuação

Toda pontuação é contestável. Se você acredita que uma pontuação está imprecisa:

  1. Leia o guia público do provedor em rhumb.dev/providers
  2. Abra o modelo de disputa de pontuação no GitHub com evidências
  3. Ou envie um e-mail para providers@supertrained.ai para um caminho privado

Nosso objetivo é responder inicialmente em até 5 dias úteis. Achados negativos permanecem visíveis. A Rhumb não aceita pagamento para alterar pontuações.

Links

Licença

MIT