Interbanking MCP server

interbanking-mcp

Servidor MCP para consultar tus cuentas de Interbanking (Argentina) desde un agente: saldos, saldos históricos y movimientos, en castellano y sin escribir código.

Es de solo lectura. No hay ninguna herramienta que mueva plata, y eso no es una convención sino una decisión de diseño: la función genérica del cliente —la que acepta cualquier método HTTP— queda deliberadamente afuera del servidor.

Instalación

No hace falta instalar nada: se descarga solo al arrancar.

Claude Code

claude mcp add interbanking \
  --env IB_CLIENT_ID=tu_client_id \
  --env IB_CLIENT_SECRET=tu_client_secret \
  --env IB_REDIRECT_URL=https://localhost \
  --env IB_CUSTOMER_ID=tu_customer_id \
  -- npx -y interbanking-mcp

Claude Desktop u otro cliente con archivo de configuración

{
  "mcpServers": {
    "interbanking": {
      "command": "npx",
      "args": ["-y", "interbanking-mcp"],
      "env": {
        "IB_CLIENT_ID": "tu_client_id",
        "IB_CLIENT_SECRET": "tu_client_secret",
        "IB_REDIRECT_URL": "https://localhost",
        "IB_CUSTOMER_ID": "tu_customer_id"
      }
    }
  }
}

Las credenciales salen del portal de desarrolladores de Interbanking. Cómo obtenerlas, paso a paso, está en interbanking-api-ejemplo.

Ojo con dónde quedan las credenciales. Ese archivo de configuración es texto plano

en tu disco. Antes de pegarlas ahí, leé [gestión de

tokens](https://github.com/rje1974/interbanking-api-ejemplo#gestión-de-tokens-y-credenciales).

Herramientas

Una vez configurado, se le habla en castellano:

• "¿Cuánto tengo en cada cuenta?"
• "Mostrame los movimientos de septiembre"
• "¿Cómo evolucionó el saldo del Galicia desde enero?"
• "¿Qué transferencias entraron la semana pasada?"

Sobre el volumen de datos

movimientos y saldoshistoricos devuelven un resumen por defecto: totales por cuenta y los 25 movimientos más recientes. Un rango de un año son miles de registros, y volcarlos enteros llena la ventana de contexto del agente sin que nadie gane nada. Para ver todo, pedirle "con detalle"*, y mejor sobre rangos cortos.

Qué hay abajo

Usa interbanking-client, que resuelve los quirks del portal: los parámetros del token van en la query string y no en el body, el header service tiene que incluir https://, customer-id va como query parameter, y movimientos usa una URL base distinta a saldos. Todos están documentados en interbanking-api-ejemplo.

Desarrollo

npm install
npm run check
npm test

Para probarlo a mano:

npx @modelcontextprotocol/inspector node server.js

Privacidad

Corre en tu máquina, con tus credenciales, y habla solo con el organismo. No recolecta nada ni manda nada a ningún lado. El detalle, en PRIVACY.md.

Soporte

Esto se publica tal cual está. Las consultas van por los issues del repo, sin plazo de respuesta: lo contesto cuando puedo. No hay soporte por correo ni por teléfono.

Las APIs de terceros cambian sin avisar y pueden romperlo. No es asesoramiento profesional — el uso es responsabilidad de quien lo usa.

Si te sirvió

⭐ Dejame una estrella en el repo o invitame un cafecito.

(O escribime y charlamos, también vale.)

Licencia

MIT