Rhumb MCP

Inteligencia de herramientas nativa para agentes: descubre, puntúa y compara más de 600 API en 16 herramientas MCP. Descubrimiento sin registro, metodología AN Score, datos de modos de fallo y ejecución gestionada.

GitHub

Prueba este MCPPatrocinado

Documentación

Rhumb

Índice de rankings. Resolución de rutas. Rhumb es una puerta de enlace para agentes hacia herramientas externas: Index puntúa y compara servicios; Resolve enruta llamadas de capacidades compatibles a través de rieles de ejecución gobernados con recibos.

🌐 rhumb.dev · ⚡ Inicio rápido · 🧭 Resolve · 💵 Precios · 📊 Clasificación · 📖 Metodología · 🔑 Confianza

Para agentes: Consulta llms.txt para documentación legible por máquina y agent-capabilities.json para metadatos estructurados de capacidades.

Empieza en 30 segundos

MCP (recomendado)

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

Configuración cero. Las herramientas de descubrimiento funcionan de inmediato: sin registro, sin clave API gobernada.

Para ejecución, pasa tu clave API gobernada:

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

Obtén una clave API gobernada →

API (solo lectura, sin autenticación)

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 los endpoints de lectura son públicos, incluidos los chequeos de preparación de Resolve. Estimar y ejecutar requieren una ruta de pago autenticada.

Qué hace Rhumb

Usa Rhumb Index cuando un agente necesite descubrir y evaluar servicios. Usa Rhumb Resolve cuando la tarea esté en una ruta de capacidad compatible y quieras ejecución gobernada con un recibo explícito.

Los agentes necesitan herramientas externas. Elegir la correcta es difícil, no por las listas de funciones, sino por:

fricción de autenticación y registro
realidad del aprovisionamiento frente a las afirmaciones de marketing
inestabilidad de esquemas
recuperación de fallos cuando ningún humano está supervisando
costos ocultos y límites de tasa

Rhumb hace visibles esas restricciones antes de que te comprometas.

Mejor ajuste hoy

Rhumb es más fuerte hoy para investigación, extracción, generación y enriquecimiento específico.

Trata la automatización empresarial multi-sistema más amplia como alcance futuro, no como la promesa invocable actual. Usa las capacidades de la Capa 2 para trabajo real ahora, y trata la Capa 3 como beta con un catálogo público intencionalmente reducido.

Rhumb Index — Descubre y Evalúa

999 servicios puntuados en 149 dominios de capacidades. Cada uno recibe una Puntuación AN (0–10) que mide calidad de ejecución, preparación de acceso y soporte de autonomía del agente.

find_services — Busca servicios indexados por lo que necesitas que hagan
get_score — Obtén el desglose completo de la Puntuación AN de un servicio: calidad de ejecución, preparación de acceso, nivel de autonomía, etiqueta de nivel y frescura
get_alternatives — Encuentra servicios alternativos, clasificados por Puntuación AN
get_failure_modes — Obtén patrones de fallo conocidos, severidad del impacto y soluciones alternativas para un servicio
discover_capabilities — Explora capacidades por dominio o texto de búsqueda
resolve_capability — Dado un ID de capacidad y, opcionalmente, un modo de credencial, devuelve proveedores clasificados con estado de salud, costo por llamada, métodos de autenticación, patrones de endpoint, guía de ejecución y campos de recuperación legibles por máquina como recovery_hint.resolve_url, recovery_hint.credential_modes_url y, cuando corresponda, recovery_hint.alternate_execute_hint o recovery_hint.setup_handoff, además de recuperación por errores tipográficos cuando el ID de capacidad es incorrecto

La amplitud del descubrimiento es mayor que la cobertura de ejecución actual. El índice es más amplio de lo que Rhumb puede ejecutar hoy.

Rhumb Resolve — Ejecuta

435 definiciones de capacidades en 28 proveedores invocables hoy. Resolve elige el proveedor compatible con mejor ajuste para la llamada usando Puntuación AN, disponibilidad/estado del circuito, costo estimado, proxy de latencia, modo de credencial y restricciones de política explícitas.

execute_capability — Llama a una capacidad a través de Rhumb Resolve
resolve_capability — Dado un ID de capacidad y, opcionalmente, un modo de credencial, devuelve proveedores clasificados con estado de salud, costo por llamada, métodos de autenticación, patrones de endpoint, guía de ejecución y campos de recuperación legibles por máquina como recovery_hint.resolve_url, recovery_hint.credential_modes_url y, cuando corresponda, recovery_hint.alternate_execute_hint o recovery_hint.setup_handoff, además de recuperación por errores tipográficos cuando el ID de capacidad es incorrecto
estimate_capability — Estima el riel de ejecución activo, el costo y la salud antes de una llamada de capacidad; las rutas anónimas directas del sistema de registro también preservan traspasos de execute_readiness legibles por máquina
get_receipt — Recupera un recibo de ejecución por ID
Aplicación de presupuesto, gestión de credenciales y telemetría de ejecución incluidas

Mejor ajuste actual: investigación, extracción, generación y enriquecimiento específico. Trata la automatización general de agentes empresariales y la orquestación multi-sistema amplia como alcance futuro, no como la promesa invocable actual.

Mapa de visibilidad del repositorio

Superficie	Para qué sirve	Límite honesto actual
Rhumb Index	Descubrimiento gratuito de servicios, consulta de Puntuación AN, alternativas e investigación de modos de fallo	El descubrimiento amplio no es lo mismo que la preparación para ejecución
Rhumb Resolve	Ejecución gobernada para capacidades compatibles con estimaciones, recibos, presupuestos y telemetría	28 proveedores invocables en tiempo de ejecución hoy; el mejor ajuste es investigación, extracción, generación y enriquecimiento específico
Paquete MCP	Punto de entrada nativo para agentes en Claude, Cursor y otros clientes MCP	El descubrimiento funciona sin autenticación; la ejecución necesita una clave gobernada, prepago de cartera o x402 donde sea compatible
API	Endpoints públicos de lectura más endpoints de ejecución autenticados	Usa las respuestas actuales de la API como fuente de verdad para preparación y cobertura invocable

Tres rutas de credenciales

Ruta	Cómo funciona
Gestionada por Rhumb	Rhumb guarda la credencial: configuración cero para el agente
BYOK	Trae tu propia clave API del proveedor. Rhumb enruta, tú autenticas
Bóveda de agente	Tu clave, cifrada y almacenada: Rhumb la inyecta en el momento de la llamada

Rutas de pago

Clave API gobernada — regístrate, obtén una clave, créditos prepagados
x402 / USDC — sin registro, paga por llamada en cadena

Modelo mental de Resolve

Servicio = proveedor que Rhumb evalúa y compara
Capacidad = acción ejecutable como email.send
Receta = flujo de trabajo determinista de varios pasos sobre capacidades (beta, catálogo público reducido)
La Capa 2 es la ruta predeterminada — empieza con clave API gobernada o prepago de cartera en X-Rhumb-Key, descubre un servicio, elige una capacidad, estima y luego ejecuta
Empieza primero con superpoderes gestionados — trae BYOK o Bóveda de agente solo cuando el flujo de trabajo toque tus propios sistemas
Autenticación predeterminada para tráfico repetido = clave API gobernada o prepago de cartera en X-Rhumb-Key
Trae BYOK o Bóveda de agente solo cuando el control del proveedor sea el punto
Usa x402 cuando el pago por llamada sin registro importe más que el rendimiento repetido

Mapa canónico de incorporación: https://rhumb.dev/docs#resolve-mental-model

Herramientas MCP

rhumb-mcp expone 21 herramientas:

Descubrimiento

find_services — Busca servicios indexados por lo que necesitas que hagan
get_score — Obtén el desglose completo de la Puntuación AN de un servicio: calidad de ejecución, preparación de acceso, nivel de autonomía, etiqueta de nivel y frescura
get_alternatives — Encuentra servicios alternativos, clasificados por Puntuación AN
get_failure_modes — Obtén patrones de fallo conocidos, severidad del impacto y soluciones alternativas para un servicio
discover_capabilities — Explora capacidades por dominio o texto de búsqueda
resolve_capability — Dado un ID de capacidad y, opcionalmente, un modo de credencial, devuelve proveedores clasificados con estado de salud, costo por llamada, métodos de autenticación, patrones de endpoint, guía de ejecución y campos de recuperación legibles por máquina como recovery_hint.resolve_url, recovery_hint.credential_modes_url y, cuando corresponda, recovery_hint.alternate_execute_hint o recovery_hint.setup_handoff, además de recuperación por errores tipográficos cuando el ID de capacidad es incorrecto

Ejecución

execute_capability — Llama a una capacidad a través de Rhumb Resolve
estimate_capability — Estima el riel de ejecución activo, el costo y la salud antes de una llamada de capacidad; las rutas anónimas directas del sistema de registro también preservan traspasos de execute_readiness legibles por máquina
credential_ceremony — Obtén instrucciones paso a paso para obtener credenciales API de un servicio
check_credentials — Inspecciona la preparación del modo de credencial en vivo, globalmente o para una capacidad específica
rhumb_list_recipes — Lista el catálogo actual publicado de recetas de la Capa 3 de Rhumb
rhumb_get_recipe — Obtén la definición publicada completa de una receta de Rhumb, incluidos esquemas de entrada/salida y topología de pasos
rhumb_recipe_execute — Ejecuta una receta publicada de la Capa 3 de Rhumb una vez que esté activa en el catálogo público
get_receipt — Recupera un recibo de ejecución por ID

Facturación

budget — Consulta o establece tu límite de gasto por llamadas
spend — Obtén tu desglose de gastos para un período de facturación: total en USD gastado, número de llamadas, costo promedio por llamada, desglosado por capacidad y por proveedor
check_balance — Consulta tu saldo actual de créditos de Rhumb en USD
get_payment_url — Obtén una URL de pago para añadir créditos a tu saldo de Rhumb
get_ledger — Obtén tu historial de facturación: cargos (débitos), recargas (créditos) y eventos de recarga automática

Operaciones

routing — Obtén o establece cómo Rhumb selecciona automáticamente proveedores cuando no especificas uno en execute_capability
usage_telemetry — Obtén tus analíticas de ejecución: llamadas, latencia, errores, costos y salud del proveedor para tu uso de Rhumb

El descubrimiento abarca 999 servicios puntuados, pero la ejecución gobernada actual abarca 28 proveedores invocables.

Nota: Las herramientas de recetas de la Capa 3 están activas, pero el catálogo público aún puede estar vacío. Usa rhumb_list_recipes o visita /recipes antes de asumir que existe un flujo de trabajo.

Mejor ajuste actual: investigación, extracción, generación y enriquecimiento específico. Trata la automatización general de agentes empresariales como alcance futuro, no como la promesa invocable actual.

API

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

Endpoint	Autenticación	Propósito
`GET /services/{slug}/score`	No	Desglose de puntuación
`GET /services/{slug}`	No	Perfil del servicio + metadatos
`GET /services/{slug}/failures`	No	Modos de fallo conocidos
`GET /search?q=...`	No	Buscar servicios
`GET /leaderboard/{category}`	No	Clasificaciones por categoría
`GET /capabilities`	No	Registro de capacidades
`GET /capabilities/{id}/resolve`	No	Proveedores clasificados + campos explícitos de `recovery_hint.*`
`POST /capabilities/{id}/execute`	Sí	Ejecutar una capacidad
`GET /capabilities/{id}/execute/estimate`	Sí	Estimación de costo
`GET /telemetry/provider-health`	No	Estado de salud del proveedor
`GET /telemetry/usage`	Sí	Tus analíticas de uso
`GET /pricing`	No	Precios legibles por máquina

Ejemplos

Consulta examples/ para scripts ejecutables:

Ejemplo	Qué muestra	¿Necesita autenticación?
discover-and-evaluate.py	Buscar → Puntuar → Modos de fallo	No
resolve-and-execute.py	Resolve → traspaso de recuperación legible por máquina → Estimar → Ejecutar	No para resolve, sí para estimar/ejecutar
budget-aware-routing.py	Presupuesto + enrutamiento óptimo por costo	Sí
dogfood-telemetry-loop.py	Bucle repetible de Resolve → verificación de telemetría	Sí
mcp-quickstart.md	Configuración de 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 aún mostrará los proveedores clasificados más cualquier traspaso de recuperación legible por máquina que Rhumb ya haya identificado. Establece RHUMB_API_KEY solo cuando quieras continuar hacia estimación y ejecución.

Documentación

Pautas de accesibilidad para agentes — cómo hacer que las interfaces web sean utilizables por agentes de IA
Metodología de Puntuación AN — dimensiones de puntuación, pesos y rúbricas
Arquitectura — diseño del motor de puntuación
Referencia de API — detalles de endpoints
Límite del repositorio — qué permanece público aquí frente a lo que vive en el espacio de trabajo operativo privado
Política de seguridad — reporte de vulnerabilidades y arquitectura de seguridad

Estructura del repositorio

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

Desarrollo

# 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 incluido).

Disputas de puntuación

Toda puntuación es discutible. Si crees que una puntuación es inexacta:

Lee la guía pública del proveedor en rhumb.dev/providers
Abre la plantilla de GitHub para disputas de puntuación con evidencia
O envía un correo a providers@supertrained.ai para una vía privada

Nuestro objetivo es responder inicialmente dentro de 5 días hábiles. Los hallazgos negativos permanecen visibles. Rhumb no acepta pagos para cambiar puntuaciones.

Enlaces

Sitio web: rhumb.dev
npm: rhumb-mcp
Registro MCP: Rhumb en el Registro MCP
X: @pedrorhumb

Licencia

MIT