FiatDock

Banco no custodial USDC <-> para agentes de IA: cotizaciones gratuitas, $0.05 por sesión vía x402, comisión del 1% detallada; solo fondos propios (PT + UE/EEE, no Reino Unido), mayores de 18 años.

GitHub
1
Prueba este MCPPatrocinado

Documentación

fiatdock-mcp

Un marketplace donde los agentes de IA descubren servicios MCP y los compran a otros agentes por llamada, en USDC. El pago se realiza mediante x402 directamente a la billetera del vendedor — sin cuentas, sin claves API, sin suscripciones, y FiatDock nunca retiene el dinero. Solo se te cobra si el vendedor realmente responde: la liquidación ocurre DESPUÉS de la entrega, nunca antes. Una llamada que no recibe respuesta no te cuesta nada — pero una respuesta que simplemente no te gusta sigue siendo una llamada entregada, y se paga. Los vendedores publican gratis, y la comisión de pasarela de FiatDock está actualmente exenta para todos los vendedores — ellos conservan el 100% de cada llamada pagada (la tarifa estándar es del 1%).

También se incluye: retirar el USDC de un agente a una cuenta bancaria real — su propietario recibe el dinero en su propia cuenta bancaria, en cualquiera de 18 monedas, con conversión, KYC y custodia gestionadas por un socio de pago con licencia (Mt Pelerin) y FiatDock sin tocar los fondos. Tiene un mínimo de aproximadamente 50 CHF, solo un paso que solo un humano puede completar, y estado del pedido que puedes consultar. Además, datos de primera parte en cadena de Base y verificación de seguridad de tokens.

Configuración — dos pasos

# 1. Give the agent a payment wallet (the step everyone skips — without it every paid
#    tool stops at an HTTP 402 "payment required" challenge and NOTHING works past free):
#    create a FRESH wallet, fund it with a few USDC on Base, and export its key:
export AGENT_PRIVATE_KEY=0x...   # dedicated low-balance wallet — never your main key

# 2. Run the server — 22 MCP tools over stdio, paid calls settle automatically:
npx -y fiatdock-mcp

¿Aún no tienes billetera? Todo lo marcado como gratis a continuación sigue funcionando — comienza con get_quote y token_price, añade la billetera cuando quieras las herramientas de pago.

4 herramientas de rampa (USDC ↔ tu propio banco) + 13 herramientas de datos (cripto + inteligencia en cadena, un lector de páginas web, una verificación de correo) + 5 herramientas de marketplace (descubre y llama a servicios MCP de otros agentes — y busca y paga CUALQUIER endpoint x402 en el índice público) — todo sin custodia. Toma solo el grupo que necesites con FIATDOCK_TOOLS:

HerramientaCostoQué hace
get_quotegratisTasa en vivo + el monto exacto recibido, neto de todas las tarifas del proveedor (incl. la comisión de servicio del 1%)
create_offramp_session$0.01 USDC vía x402USDC del agente → cuenta bancaria del propietario; devuelve un checkoutUrl de un solo uso
create_onramp_session$0.01 USDC vía x402Fiat del propietario → USDC a la billetera del agente (dirección bloqueada)
get_order_statusgratisRastrear un pedido por partnerOrderId
token_pricegratisPrecio/liquidez/volumen/cambio en tiempo real para cualquier token EVM por dirección de contrato (DexScreener), o precio spot de un símbolo importante
token_safety$0.01 USDC vía x402Veredicto de seguridad en cadena (honeypot / impuesto / privilegio del propietario / concentración de tenedores) safe|caution|danger (GoPlus + DexScreener); no se cobra si los datos no están disponibles
stablecoin_intel$0.002 USDC vía x402Suministro de stablecoin, desviación de $1.00 del peg y desglose por cadena incl. Base (DefiLlama); no se cobra si los datos no están disponibles
gas_price$0.001 USDC vía x402Precio del gas en Base (wei + gwei)
block_number$0.001 USDC vía x402Altura del último bloque en Base + marca de tiempo
eth_balance$0.001 USDC vía x402Saldo de ETH de cualquier dirección en Base
usdc_balance$0.001 USDC vía x402Saldo de USDC de cualquier dirección en Base
token_metadata$0.002 USDC vía x402Nombre / símbolo / decimales / suministro total de ERC-20 en Base
tx_status$0.001 USDC vía x402Tx de Base: éxito o fallo, bloque, confirmaciones, gas, de/a
address_intel$0.005 USDC vía x402Enriquecer cualquier dirección de Base — EOA/contrato/ERC-20, nonce, saldo de ETH+USDC, veredicto de seguridad sin clave (phishing / sancionado / mezclador)
token_report$0.05 USDC vía x402Informe ERC-20 completo en UNA llamada: precio + liquidez + volumen y el veredicto de seguridad completo
web_read$0.002 USDC vía x402Cualquier página web pública como texto limpio — título, descripción, canónico, cuerpo legible, primeros 50 enlaces, recuento de palabras; una página que no se puede leer no se cobra
email_check$0.001 USDC vía x402¿Vale la pena enviar un correo a esta dirección? Sintaxis, DNS (MX, luego A/AAAA), listas de desechables / roles / proveedores gratuitos, una sugerencia de error tipográfico, un formulario normalizado, un veredicto de riesgo con razones — sin sonda SMTP
search_servicesgratisBuscar en el marketplace de servicios MCP de FiatDock — coincide con los nombres de herramientas de cada servidor listado, no solo su descripción. Devuelve los 20 mejores listados por defecto (limit, máx. 50); truncated/total te indican cuando hay más
get_servicegratisDetalle completo de un listado + cómo llamarlo
call_servicepor listado (x402)Invocar un servicio listado. Las llamadas pagadas se liquidan directamente al vendedor en el/los pago(s) x402 que el 402 lista — un pago a precio completo mientras la comisión de FiatDock esté exenta (como lo está actualmente para todos los vendedores), de lo contrario la parte del vendedor más el 1% de FiatDock — sin custodia. Paga automáticamente desde AGENT_PRIVATE_KEY, o pasa tu propio payment firmado — ver abajo
search_x402gratisBuscar en el índice público x402 — cada endpoint de pago por llamada que lista (~15,000 de cientos de hosts), ordenado por relevancia y luego por llamadas pagadas en 30 días. Cada fila: URL, precio indexado, red, el propio payTo del endpoint, llamadas/pagadores en 30 días
call_x402por endpoint (pagado a ese endpoint)Pagar cualquier endpoint x402 listado en el índice directamente desde AGENT_PRIVATE_KEY al payTo del endpoint — FiatDock no cobra tarifa y nunca lo toca. Requiere maxPriceUsd (o FIATDOCK_MAX_PRICE_USD): un 402 de terceros es la única declaración de precio, así que sin límite no se firma nada y el precio regresa. O pasa tu propio payment firmado
  • Endpoint remoto (sin instalación): https://fiatdock.com/mcp — HTTP Streamable, sin estado, con CORS habilitado. No contiene claves, por lo que las herramientas de pago responden con el desafío 402 de x402 — y puedes completar la compra desde allí firmándolo tú mismo (abajo).

Comprar con tu propia billetera

AGENT_PRIVATE_KEY es el camino fácil, pero es una billetera elegida en el momento de la instalación. Si tu agente tiene su propio firmante — Coinbase AgentKit, un servidor MCP de billetera, cualquier cosa — compra en dos llamadas en cualquiera de los transportes:

1. call_service({id, args})            -> 402: { paymentRequired, howToPay }
2. sign every entry in paymentRequired.accepts, base64 the x402 payload
3. call_service({id, args, payment})   -> the seller's response

Envía el mismo id y args en la segunda llamada — la solicitud cotizada en el 402 es la solicitud que se paga. Un payment proporcionado por el llamador tiene prioridad sobre AGENT_PRIVATE_KEY (y omite FIATDOCK_MAX_PRICE_USD, que existe para limitar el gasto automático, no el tuyo). Un 402 no cobra nada — es el precio, no una factura, por lo que reintentar siempre es seguro.

  • Registro oficial de MCP: com.fiatdock/fiatdock-mcp
  • ¿Sin MCP? GET https://fiatdock.com/tools.json — las mismas herramientas como esquemas de llamada de funciones de OpenAI/Gemini mapeadas a la API REST simple.
  • Configuración por cliente (Claude Desktop/Code, Cursor, VS Code, Windsurf, Gemini CLI, OpenAI Agents SDK, LangChain, CrewAI): docs/INTEGRATIONS.md · ejemplos ejecutables: docs/examples/

Cumplimiento (vinculante): los usuarios deben ser mayores de 18 años, en Portugal o países admitidos de la UE/EEE (no disponible en el Reino Unido ni en países restringidos). Regla de cuenta propia: la billetera que envía cripto y la cuenta bancaria que recibe fiat deben pertenecer a la misma persona — el propietario del agente. Sin fondos de terceros, sin agregación, sin transferencias de persona a persona. Las criptomonedas son volátiles; las cotizaciones son indicativas; nada aquí es asesoramiento de inversión. Términos · Privacidad · Advertencia de riesgo

Entorno

VariableRequeridaPropósito
FIATDOCK_URLno (predeterminado https://fiatdock.com)URL base de la API de FiatDock
FIATDOCK_TOOLSno (predeterminado all)Instala solo los grupos de herramientas que necesites, para que el resto no ocupe el contexto de tu agente. Ver abajo.
AGENT_PRIVATE_KEYsolo para herramientas de pagoClave de la billetera del agente utilizada para pagar automáticamente la tarifa x402 — $0.001–$0.05 según la herramienta, más lo que cobre un vendedor del marketplace por call_service. Sin ella, las cinco herramientas gratuitas siguen funcionando y las herramientas de pago devuelven el desafío 402 en lugar de comprar. Usa una billetera dedicada de bajo saldo; nunca tu clave principal.
FIATDOCK_MAX_PRICE_USDno (predeterminado: sin límite)Protección contra precios engañosos para call_service: rechaza pagar si el cargo x402 total de una llamada de pasarela de pago supera esta cantidad en USD. Se puede anular por llamada mediante el argumento maxPriceUsd.

Cualquier endpoint x402 — search_x402 / call_x402

La misma billetera compra más allá del catálogo de FiatDock. search_x402 busca en el índice público x402 (~15,000 endpoints con precio, ordenados por llamadas pagadas en 30 días); call_x402 lee el 402 propio del endpoint, lo verifica contra maxPriceUsd, firma ese requisito y paga el payTo del endpoint directamente — sin relé, sin pasarela, sin tarifa de FiatDock. El límite es requerido aquí (a diferencia de call_service, cuya pasarela fija el precio de un listado que FiatDock ha verificado): un 402 de terceros es la única declaración de precio, así que sin maxPriceUsd y sin FIATDOCK_MAX_PRICE_USD la herramienta no firma nada y devuelve el precio para tu próxima llamada.

search_x402({q: "web search", maxPriceUsd: 0.01})            -> results[] with url, priceUsd, payTo, calls30d
call_x402({url, body: {query: "…"}, maxPriceUsd: 0.01})      -> { ok, status, paid, settlement, result }

Elige tus herramientas — FIATDOCK_TOOLS

Las 22 herramientas se instalan por defecto. Una lista de herramientas es lo primero que lee un modelo, así que si solo viniste por una cosa, toma solo esa:

GrupoHerramientasPara
ramp4Cotizaciones, sesiones USDC↔banco, estado de pedidos
data13Precio/seguridad/informe de tokens, gas, saldos, estado de tx, inteligencia de direcciones, lector de páginas web, verificación de correo
marketplace5Encuentra, inspecciona y paga por servicios MCP de otros agentes — y busca/paga cualquier endpoint en el índice público x402
FIATDOCK_TOOLS=ramp                # just the cash-out surface (4 tools)
FIATDOCK_TOOLS=ramp,marketplace    # cash out + buy from other agents (9 tools)
# unset, or "all"                  # everything (22 tools)

Un valor no reconocido sirve todas las herramientas en lugar de ninguna — un error tipográfico nunca debería dejarte con un servidor vacío. Desactivar marketplace también retira el recurso fiatdock://catalog, para que nada relacionado con el marketplace entre en tu contexto.

Recursos

fiatdock://fees · fiatdock://coverage · fiatdock://catalog — el catálogo del marketplace en vivo (nombre, precio por llamada, categoría, recuento de herramientas y una muestra de nombres de herramientas), para que tu agente sepa qué está a la venta sin gastar una llamada de herramienta para preguntar.

Claude Desktop / Cursor / Windsurf / Gemini CLI

Los cuatro leen la misma forma mcpServers (archivo: claude_desktop_config.json, ~/.cursor/mcp.json, ~/.codeium/windsurf/mcp_config.json, ~/.gemini/settings.json):

{
  "mcpServers": {
    "fiatdock": {
      "command": "npx",
      "args": ["-y", "fiatdock-mcp"],
      "env": { "AGENT_PRIVATE_KEY": "0x..." }
    }
  }
}

Claude Code

claude mcp add fiatdock -e AGENT_PRIVATE_KEY=0x... -- npx -y fiatdock-mcp
# or remote, no install (free tools + x402 challenges):
claude mcp add --transport http fiatdock https://fiatdock.com/mcp

VS Code (modo agente de Copilot)

.vscode/mcp.json:

{
  "servers": {
    "fiatdock": { "type": "stdio", "command": "npx", "args": ["-y", "fiatdock-mcp"], "env": { "AGENT_PRIVATE_KEY": "0x..." } }
  }
}

OpenAI Agents SDK / LangChain / CrewAI

Los tres consumen servidores MCP de forma nativa — apúntalos a npx -y fiatdock-mcp (stdio) o https://fiatdock.com/mcp (HTTP Streamable):

# OpenAI Agents SDK
from agents.mcp import MCPServerStdio
async with MCPServerStdio(params={"command": "npx", "args": ["-y", "fiatdock-mcp"],
                                  "env": {"AGENT_PRIVATE_KEY": "0x..."}}) as fiatdock: ...

# LangChain (langchain-mcp-adapters)
from langchain_mcp_adapters.client import MultiServerMCPClient
client = MultiServerMCPClient({"fiatdock": {"transport": "streamable_http", "url": "https://fiatdock.com/mcp"}})

# CrewAI (crewai-tools)
from crewai_tools import MCPServerAdapter
tools = MCPServerAdapter({"url": "https://fiatdock.com/mcp", "transport": "streamable-http"})

Cómo fluye un off-ramp típico

  1. get_quote (gratis) — el agente verifica la tasa y el desglose completo de tarifas.
  2. create_offramp_session — paga $0.01 en USDC automáticamente vía x402, recibe checkoutUrl + partnerOrderId.
  3. El agente reenvía checkoutUrl a su propietario humano (válido ~2 horas). El propietario proporciona al proveedor un número de teléfono y un correo electrónico; los documentos de identidad solo se necesitan por encima de ~CHF 999 por 30 días móviles — sin cuenta, sin contraseña.
  4. get_order_status (o un callback firmado) confirma COMPLETED.

Seguridad

¿Encontraste una vulnerabilidad? Por favor, repórtala de forma privada a osama@fiatdock.com — ver SECURITY.md. Nunca abras un issue público para informes de seguridad.

Licencia

MIT