Bunq MCP

Un servidor de protocolo de contexto modelo para Bunq (neobanco holandés).

Herramientas disponibles

Este servidor MCP proporciona las siguientes herramientas para interactuar con Bunq:

1. Cuentas Bunq : obtén tus cuentas Bunq con detalles como tipo de cuenta, saldo e ID

2. getTransactions - Ver transacciones (pagos) de una cuenta específica

3. getRequestInquiries : recibe las solicitudes de dinero que has enviado desde una cuenta específica

4. createPaymentRequest - Crea una solicitud de pago para recibir dinero en tu cuenta

5. getPaymentAutoAllocates : obtener la configuración de asignación automática de pagos para una cuenta

6. getTopCounterparties : obtenga una lista de contrapartes personales únicas según transacciones recientes

7. createDraftPayment : crea borradores de pagos con programación opcional (requiere revisión/aprobación en la aplicación antes de la ejecución)

8. createPayment : Crea pagos con dinero real (transferencias inmediatas). Solo disponible al usar una clave API (no OAuth).

Se puede acceder a estas herramientas a través de cualquier cliente MCP conectado a este servidor.

Related MCP server: MCP Blockchain Query Server

Autenticación

Este servidor admite dos modos de autenticación: OAuth y API Key . Consulte la documentación de Bunq para obtener más información.

La creación de una clave API o un cliente OAuth se realiza a través de la aplicación Bunq:

1. Presiona tu cara en la parte superior izquierda

2. Presione el engranaje en la parte superior derecha

3. En “Desarrolladores”, vaya a “OAuth” o “Claves API”.

4. Si usa OAuth, configure la URL de redireccionamiento de la siguiente manera:

   http://localhost:8788/callback

(Modifique el puerto si es necesario).

Al iniciar el servidor, puede configurar las variables de entorno BUNQ_CLIENT_ID y BUNQ_CLIENT_SECRET , o la variable de entorno BUNQ_API_KEY . También puede pasar el ID de cliente y el secreto o la clave API como argumentos de la línea de comandos: --bunq-client-id <id> --bunq-client-secret <secret> o --bunq-api-key <key> .

Nota: Si desea crear pagos reales con dinero real que no sean giros bancarios, deberá utilizar una clave API.

Instalación y uso

1. Instale las herramientas CLI bunq-mcp y mcp-remote :

npm install -g bunq-mcp mcp-remote

2. En la aplicación Bunq, cree un cliente OAuth o una clave API (ver arriba).

3. (Opcional) Generar un nuevo par de claves pública/privada:

bunq-mcp --generate-keys

Tenga en cuenta que esto supone que openssl está instalado y disponible en PATH. Si decide omitir este paso, se usarán las claves preexistentes en ./src/keys/ . Las claves creadas anularán las claves preexistentes y se almacenarán en el directorio global node_modules .

4. Inicie el servidor MCP en cualquier terminal:

bunq-mcp --mcp --bunq-client-id <client-id> --bunq-client-secret <client-secret>

El ID del cliente y el secreto también se pueden configurar mediante las variables de entorno BUNQ_CLIENT_ID y BUNQ_CLIENT_SECRET .

5. En su editor favorito u otro cliente MCP (como Claude Desktop), agregue lo siguiente:

{
  "mcpServers": {
    "bunq-mcp": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:8788/sse"]
    }
  }
}

Nuevamente, modifique el puerto si es necesario. Se usa mcp-remote porque este paquete usa el transporte SSE, aunque la mayoría de los clientes no lo admiten. Consulte mcp-remote para obtener más información.

6. Tan pronto como se inicie el servidor MCP, mcp-remote debería abrir su navegador para iniciar el flujo OAuth.

Ahora deberías poder hacer una pregunta, como por ejemplo:

• ¿Cuál es mi saldo actual de Bunq?

• ¿Cuáles son mis 5 contrapartes principales?

• ¿Cuál fue mi última transacción?

Solución de problemas

• Si hay algún problema con el flujo de OAuth, puedes intentar eliminar el directorio creado por mcp-remote en tu directorio de inicio: rm -rf ~/.mcp-auth .

CLI

Usage: bunq-mcp [options]

Options:
  --help              Show help
  --version           Show version
  --generate-keys     Generate private and public key pair for Bunq installation
  --mcp               Start MCP server
  --host <host>       Host (for MCP server)
  --port <port>       Port (for MCP server)
  --bunq-client-id <id>         Bunq client ID (alternative to BUNQ_CLIENT_ID env var)
  --bunq-client-secret <secret> Bunq client secret (alternative to BUNQ_CLIENT_SECRET env var)
  --bunq-api-key <key>          Bunq API key (alternative to BUNQ_API_KEY env var)

Desarrollo

1. Cree un archivo .dev.vars en el directorio raíz con el siguiente contenido:

# When set to 1 the public/private key pair in this repo is used.
IS_DEVELOPMENT=1

# Create OAuth client in the Bunq app
BUNQ_CLIENT_ID=
BUNQ_CLIENT_SECRET=

2. Iniciar el servidor de desarrollo

npm run dev

3. Configurar la configuración de MCP

{
  "mcpServers": {
    "bunq-mcp": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:8788/sse"]
    }
  }
}

Limitaciones

• No es posible crear pagos mediante el flujo OAuth. Solo se pueden crear pagos en borrador.

{ "Error": [{ "error_description": "Not enough permissions to create payment." }] }