interbanking

interbanking-mcp

Proyecto independiente y no oficial. No tiene vinculación con Interbanking S.A. ni está avalado por esa empresa. "Interbanking" es una marca registrada de su titular y se menciona solo para indicar con qué API funciona.

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.

Herramientas

Herramienta	Qué hace
listar_cuentas	Las cuentas disponibles con banco, tipo, moneda y número
saldos	Saldos actuales: contable y operativo. Rango opcional de hasta 64 días
saldos_historicos	Saldos día por día en rangos largos; parte el rango solo
movimientos	Movimientos de todas las cuentas, con totales de créditos y débitos

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 saldos_historicos 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