Bunq MCP

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.

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 :

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:

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:

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:

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

Desarrollo

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

2. Iniciar el servidor de desarrollo

3. Configurar la configuración de MCP

Limitaciones

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