MCP server de Fallback
Commit 6 oct 2026Proporciona utilidades deterministas de recuperación y toma de decisiones para agentes autónomos, permitiéndoles diagnosticar fallos, reparar solicitudes y encontrar fuentes de datos.
También conocido como baronsigma/fallback-agent-tools, fallback-agent-tools
- Stars
- 0
- Herramientas
- 4
- Descargas, 30 días
- —
- Última versión
- 0.1.0-beta.1
- Último commit
- 6 oct 2026
- Licencia
- MIT
¿Qué es Fallback MCP?
Proporciona utilidades deterministas de recuperación y toma de decisiones para agentes autónomos, permitiéndoles diagnosticar fallos, reparar solicitudes y encontrar fuentes de datos. Expone 4 herramientas, como source_route, error_route, request_repair.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Fallback
Fallback ofrece un conjunto de utilidades deterministas diseñadas para ayudar a los agentes autónomos a navegar por fallos y puntos de decisión. En lugar de depender de costosos bucles de razonamiento cuando un agente se queda atascado, estas herramientas ofrecen funciones pequeñas y especializadas para diagnosticar errores o encontrar datos. El servicio está disponible como un endpoint MCP alojado o mediante una API HTTP, utilizando un modelo pay-per-call x402 V2 en la mainnet de Base con USDC canónico. No se requieren cuentas ni API keys, ya que los usuarios aprueban los pagos para cada llamada específica a una herramienta.
Los desarrolladores pueden utilizar herramientas específicas como source_route para encontrar formatos de datos legibles por máquina, error_route para clasificar solicitudes fallidas, request_repair para sugerir correcciones menores basadas en evidencia, y stop_search para determinar si una investigación más profunda merece el coste. El sistema está diseñado para la precisión, ofreciendo acciones delimitadas como encontrar una API o un conjunto de datos de un dominio específico. Cada llamada a una herramienta tiene límites definidos, como un máximo de 8 solicitudes HTTP directas y 12 segundos de tiempo de ejecución total por llamada.
Qué puedes hacer con él
- 1Localizar fuentes de datos legibles por máquinaUn agente puede identificar la mejor manera de acceder a un conjunto de datos específico en formato JSON o CSV de un editor conocido.
- 2Diagnosticar y recuperarse de fallos en las solicitudesCuando falla una API o una llamada a una herramienta, el agente puede clasificar el error para determinar la siguiente acción segura.
- 3Reparar solicitudes malformadasEl agente puede proponer cambios mínimos a una solicitud utilizando la evidencia disponible para hacerla válida.
- 4Optimizar el gasto en búsquedasUn agente puede decidir si continuar una búsqueda está justificado económicamente basándose en la evidencia actual.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Fallback MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar Fallback MCP en Claude Code
$ claude mcp add --transport http fallback-agent-tools https://fallback.factrail.online/mcpInstalar Fallback MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"fallback-agent-tools": {
"url": "https://fallback.factrail.online/mcp"
}
}
}Instalar Fallback MCP en VS Code
.vscode/mcp.json
{
"servers": {
"fallback-agent-tools": {
"type": "http",
"url": "https://fallback.factrail.online/mcp"
}
}
}Instalar Fallback MCP en VS Code CLI
$ code --add-mcp '{"name":"fallback-agent-tools","type":"http","url":"https://fallback.factrail.online/mcp"}'Instalar Fallback MCP en Codex
$ codex mcp add fallback-agent-tools --url https://fallback.factrail.online/mcpInstalar Fallback MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.fallback-agent-tools] url = "https://fallback.factrail.online/mcp"
Instalar Fallback MCP en Gemini CLI
$ gemini mcp add -s user --transport http fallback-agent-tools https://fallback.factrail.online/mcpInstalar Fallback MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"fallback-agent-tools": {
"url": "https://fallback.factrail.online/mcp",
"type": "http"
}
}
}Herramientas de Fallback MCP 4
Detectado desde el READMEsource_routeerror_routerequest_repairstop_search
| source_route | — | |
| error_route | — | |
| request_repair | — | |
| stop_search | — |
Verificaciones automáticas
Ejecutado 15 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblebaronsigma/fallback-agent-tools is public and reachablegithub.com/baronsigma/fallback-agent-tools ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-10-06github.com/baronsigma/fallback-agent-tools ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo4 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo tool named like delete, drop or execAprobado
- El endpoint remoto responde al handshake de MCPinitialize answered with protocol 2025-06-18 in 490 msAprobado
README
Ver en GitHubFallback
______ _ _
| ____| | | |
| |__ __ _ | | |__ __ _ ___| | __
| __|/ _` || | '_ \ / _` |/ __| |/ /
| | | (_| || | |_) | (_| | (__| <
|_| \__,_||_|_.__/ \__,_|\___|_|\_\
find the route forward
Fallback
Tiny paid recovery and decision utilities for autonomous agents.
When an agent gets stuck, Fallback helps it find the next safe move without wasting a large reasoning loop.
source_route Where should I look? ($0.02)
error_route Why did this fail? ($0.002)
request_repair Can I safely fix the request? ($0.005)
stop_search Is another search worth it? ($0.003)
Use Fallback
Pay-per-call tools that help AI agents find sources, diagnose failures, repair requests, and decide when to stop searching. Fallback gives autonomous agents small, deterministic utilities for the moments where automation gets stuck: finding the right source, diagnosing a failed request, repairing a request from available evidence, and deciding whether another search or paid retrieval is worth the cost.
Hosted service
MCP endpoint: https://fallback.factrail.online/mcp\
HTTP API base: https://fallback.factrail.online\
Payment: x402 V2 pay-per-call. Check each live challenge for network, asset, amount, and recipient.
Agent skill: skill.md
OpenAPI: openapi.json
Network: Base mainnet, canonical USDC
Release: v0.1.0-beta.1
Tools
source_route($0.02): Where should I look? Find likely authoritative or machine-readable sources.error_route($0.002): Why did my call fail? Classify a failed request and recommend a bounded next action.request_repair($0.005): Can I safely fix the request? Propose the smallest change supported by caller-supplied evidence.stop_search($0.003): Is further searching worth it? Decide whether more bounded search effort is justified by the evidence and remaining cost.
These tools do not replace agent reasoning, and stop_search never proves universal absence.
When an agent should use this
Use source_route when an agent knows what it needs and which publisher (a domain or start URL), but not how to get it in machine-readable form: an API, OpenAPI spec, bulk download, dataset or feed.
- Good fit: "Get the latest population dataset from Eurostat", "Find a JSON/CSV route for this agency's statistics", before the agent starts browsing page by page.
- Not a fit: general web research, answering a factual question, or verifying a fact (for source-backed facts, see FACTRAIL MCP).
How to read the result:
status: routes_found: try routes in order.scoreis a deterministic ranking, not a probability or confidence.status: no_suitable_route_found: nothing suitable within the checked scope (seechecked.direct_probes). This is not evidence that no route exists. The agent should look elsewhere (another host, the publisher's open-data portal), not conclude "there is no API".- Always read
limitations. It says, for example, whether external search was unavailable or candidate inspection was capped.
Limits per call: at most 8 direct HTTP requests, 12 s total, 1 MiB per response, and at most 1 external search request. No LLM inference. The hosted beta currently runs deterministic discovery only (no search provider configured).
Access: hosted MCP https://fallback.factrail.online/mcp (Streamable HTTP) or the HTTP tool routes, x402 pay-per-call (each challenge declares its payment network and amount; no account or API key). To try it without payment, self-host with PAYMENT_MODE=disabled (see Local development). Machine-readable summary: llms.txt. More detail: Using Fallback with agents.
Fallback is publicly launched. See the current launch and distribution status, product rename impact audit, discovery/distribution readiness audit, and telemetry and 30-day KPI definitions.
When to use error_route
Use it after an HTTP, API, MCP, or tool request fails when the safe next action is unclear. It classifies supplied evidence and returns bounded retry guidance. Do not use it when recovery is already obvious or the task needs deeper domain reasoning; it does not execute requests or invent undocumented fixes.
Requirements
- Current Node.js LTS (Node 24 at scaffold creation; supported engine is Node 22+)
- npm
Local development
npm install
cp .env.example .env
npm run generate
npm run dev
The server exposes /, /healthz, /readyz, /catalog.json, /openapi.json, /llms.txt, /llms-full.txt, /skill.md, /.well-known/x402.json, /.well-known/mcp/server-card.json, and the Streamable HTTP MCP endpoint at /mcp. Both HTTP and MCP dispatch through the shared runtime handler registry. PAYMENT_MODE=disabled supports local development; paid deployments must explicitly select test or production and provide complete x402 configuration.
Verification
npm test
npm run typecheck
npm run lint
npm run benchmark:source-route
npm run benchmark:error-route
npm run verify:catalog
npm run release:check
30-second start
Connect an x402-compatible agent to https://fallback.factrail.online/mcp, call the matching tool after a concrete failure or search decision, and approve only the network, token, recipient, and amount shown by its payment challenge. HTTP clients can use POST /v1/tools/{tool_id} on the hosted origin. See skill.md for examples and schemas.
Architecture
src/core/registry.ts is the one canonical tool registry. Every discovery surface and distribution artifact is derived from it. Each tool gets a directory under src/tools/ with a contract and handler; future tool tests and fixtures belong alongside the matching contract test/fixture directories. HTTP and MCP adapters must call the same tool handler. Payment middleware and marketplace integrations stay outside tool logic.
The service supports x402 V2 per-call payment without accounts or API keys. The server only receives payment at X402_PAY_TO; no receiving wallet private key is required. Paid startup fails closed if the required network, receiving address, facilitator URL, or production URL is missing or invalid. See deployment and payment setup.
Example
{
"goal": "Download the latest population dataset",
"start_url": "https://ec.europa.eu/eurostat/",
"preferred_formats": ["csv", "json"]
}
Call POST /v1/tools/source_route with a goal and either start_url or domain. The result is limited to the checked scope; a missing result does not mean that no route exists. Direct site discovery runs without external search credentials. If Tavily or Brave is configured and direct discovery is insufficient, the tool can make at most one search request.
See PRODUCT, ARCHITECTURE, TOOL_ADMISSION, DISTRIBUTION, and RELEASE.
Related: FACTRAIL MCP
Fallback comes from the same author and design rule as FACTRAIL MCP: agent tools should report what they checked, not only what they found. FACTRAIL answers "what is established about this fact, and from which source?" by returning evidence envelopes with support levels, unresolved fields and receipts ("unknown is better than invented"). Fallback answers "where can I get this data?" ("absence is not proof of nonexistence"). The two are independent services with no code dependency, and you can use either one alone.
Preguntas sobre Fallback MCP
¿Cómo agrego Fallback MCP a Claude Code?
Ejecuta claude mcp add --transport http fallback-agent-tools https://fallback.factrail.online/mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Fallback MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué herramientas proporciona Fallback MCP?
Expone 4 herramientas, incluidas source_route, error_route, request_repair, stop_search.
¿Qué puede hacer la herramienta source_route?
Ayuda a los agentes a encontrar fuentes probablemente autorizadas o legibles por máquina, como APIs, especificaciones OpenAPI o conjuntos de datos, cuando conocen al editor pero no la ruta de datos específica.
¿Cómo ayuda la herramienta error_route a un agente?
Clasifica el motivo por el cual falló una solicitud y recomienda una siguiente acción delimitada para ayudar al agente a recuperarse.
¿La herramienta stop_search demuestra que la información no existe?
No, la herramienta decide si seguir buscando merece el coste, pero nunca demuestra una ausencia universal.
¿Cómo se gestiona el pago de estas herramientas?
El servicio utiliza el modelo pay-per-call x402 V2, donde el agente aprueba la red, el activo, el importe y el destinatario que se muestran en un desafío de pago.