FinCobra MCP — checkout de criptomonedas para Claude, Cursor y Codex

Model Context Protocol (MCP) server para el checkout de criptomonedas y pagos de FinCobra. Crea facturas alojadas para BTC, USDT y USDC (los activos de liquidación provienen de los métodos de pago del panel; los importes están en USD). Funciona con Claude Code, Cursor y Codex. El acceso a Watchlist es de solo lectura. Aún no está en npm — instala desde GitHub.

Documentación: FinCobra Checkout MCP

fincobra-mcp 0.1.0 aún no está publicado en npm. Hasta entonces, instala desde GitHub:

npx -y github:dexstandard/fincobra-mcp

Fija una versión de origen con npx -y github:dexstandard/fincobra-mcp#v0.1.0. Requiere Node.js 20+.

• Checkout: crea una factura de pago alojada y lee su estado

• Watchlist: lista de fuentes de solo lectura y desglose manual del patrimonio neto

Esto no es una plataforma de pagos ni una API de escritura de Watchlist.

Herramientas (v0)

Checkout

No existe la herramienta list_invoices. Las claves de API de Checkout no pueden listar facturas.

Los importes de las facturas están en USD. Los activos de liquidación provienen de los métodos de pago del panel:

Watchlist (solo lectura)

Watchlist no tiene clave de API pública. La autenticación es la cookie session de Identity que usa la aplicación web de Watchlist.

Los bancos, el efectivo y las propiedades son entradas manuales de producto, no fuentes en vivo de bancos ni de títulos. Los saldos en vivo de cripto en USD se calculan en la interfaz de Watchlist y no están en la API de listado. El servidor no inventa un total de cryptoUsd.

Las herramientas de Watchlist no añaden wallets, no editan bancos, no cambian la facturación ni exportan impuestos.

Related MCP server: Infini Payment MCP Server

Entorno

Configura Checkout, Watchlist o ambos. Las herramientas de un área que falte devuelven un error de configuración.

Orígenes de desarrollo: https://dev.fincobra.com y https://watch.dev.fincobra.com.

Cursor

Añade a .cursor/mcp.json (proyecto) o a ~/.cursor/mcp.json (usuario):

{
  "mcpServers": {
    "fincobra": {
      "command": "npx",
      "args": ["-y", "github:dexstandard/fincobra-mcp"],
      "env": {
        "FINCOBRA_CHECKOUT_API_KEY": "fc_live_...",
        "FINCOBRA_CHECKOUT_BASE_URL": "https://fincobra.com",
        "FINCOBRA_WATCHLIST_SESSION_TOKEN": "<session-cookie-value>",
        "FINCOBRA_WATCHLIST_BASE_URL": "https://watch.fincobra.com"
      }
    }
  }
}

Claude Code

claude mcp add fincobra \
  --env FINCOBRA_CHECKOUT_API_KEY=fc_live_... \
  --env FINCOBRA_WATCHLIST_SESSION_TOKEN=<session-cookie-value> \
  -- npx -y github:dexstandard/fincobra-mcp

O añade el mismo objeto mcpServers a .mcp.json / ~/.claude.json.

Codex

codex mcp add fincobra \
  --env FINCOBRA_CHECKOUT_API_KEY=fc_live_... \
  --env FINCOBRA_WATCHLIST_SESSION_TOKEN=<session-cookie-value> \
  -- npx -y github:dexstandard/fincobra-mcp

O en ~/.codex/config.toml:

[mcp_servers.fincobra]
command = "npx"
args = ["-y", "github:dexstandard/fincobra-mcp"]

[mcp_servers.fincobra.env]
FINCOBRA_CHECKOUT_API_KEY = "fc_live_..."
FINCOBRA_WATCHLIST_SESSION_TOKEN = "<session-cookie-value>"

Ejecutar localmente

npm install
FINCOBRA_CHECKOUT_API_KEY=fc_live_... \
FINCOBRA_WATCHLIST_SESSION_TOKEN=... \
npm start

El proceso se comunica mediante MCP a través de stdio. No escribas registros de la aplicación en stdout.

Prueba de humo

FINCOBRA_CHECKOUT_API_KEY=fc_live_... \
FINCOBRA_WATCHLIST_SESSION_TOKEN=... \
npm run smoke

Las pruebas unitarias simulan las APIs y no necesitan credenciales:

npm test

Autenticación

Copia la cookie session de Watchlist desde un navegador con sesión iniciada (DevTools → Application → Cookies). Mantén las claves y los tokens de sesión en el entorno del servidor MCP, no en el chat.

API

Checkout:

• POST /api/checkout/invoices

• GET /api/checkout/invoices/:id

• Autenticación: X-Api-Key

Watchlist:

• GET /api/watchlist/wallets

• GET /api/watchlist/exchanges

• GET /api/watchlist/manual-assets

• GET /api/watchlist/fx-rates

• Autenticación: Cookie: session=...

Envía al pagador a paymentUrl. Trata confirmed y paid_out_of_band como pagados. Trata payment_detected como pendiente a menos que aceptes pagos cripto no confirmados.

Licencia

MIT