Skip to main content
Glama
deenesjakoruzh
WilcoKruijer

Bunq MCP

by WilcoKruijer
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

Bunq MCP

Ein Model Context Protocol-Server für Bunq (niederländische Neobank).

Screenshot

Verfügbare Tools

Dieser MCP-Server bietet die folgenden Tools für die Interaktion mit Bunq:

  1. bunqAccounts - Holen Sie sich Ihre Bunq-Konten mit Details wie Kontotyp, Kontostand und ID

  2. getTransactions - Transaktionen (Zahlungen) für ein bestimmtes Konto anzeigen

  3. getRequestInquiries - Erhalten Sie Geldanfragen, die Sie von einem bestimmten Konto gesendet haben

  4. createPaymentRequest – Erstellen Sie eine Zahlungsanforderung, um Geld auf Ihr Konto zu erhalten

  5. getPaymentAutoAllocates – Automatische Zahlungszuweisungseinstellungen für ein Konto abrufen

  6. getTopCounterparties - Erhalten Sie eine Liste eindeutiger Gegenparteien basierend auf den letzten Transaktionen

  7. createDraftPayment – Erstellen Sie Zahlungsentwürfe mit optionaler Planung (erfordert vor der Ausführung eine Überprüfung/Genehmigung in der App)

  8. createPayment - Erstellen Sie Echtgeldzahlungen (sofortige Überweisungen). Nur bei Verwendung eines API-Schlüssels verfügbar (nicht OAuth).

Auf diese Tools kann über jeden mit diesem Server verbundenen MCP-Client zugegriffen werden.

Related MCP server: MCP Blockchain Query Server

Authentifizierung

Dieser Server unterstützt zwei Authentifizierungsmodi: OAuth und API-Schlüssel . Weitere Informationen finden Sie in der Bunq-Dokumentation .

Das Erstellen eines API-Schlüssels oder OAuth-Clients erfolgt über die Bunq-App:

  1. Drücken Sie Ihr Gesicht oben links

  2. Drücken Sie das Zahnrad oben rechts

  3. Gehen Sie unter „Entwickler“ entweder zu „OAuth“ oder „API-Schlüssel“.

  4. Wenn Sie OAuth verwenden, legen Sie die Umleitungs-URL wie folgt fest:

    http://localhost:8788/callback

(Ändern Sie den Port bei Bedarf.)

Beim Starten des Servers können Sie entweder die Umgebungsvariablen BUNQ_CLIENT_ID und BUNQ_CLIENT_SECRET oder die Umgebungsvariable BUNQ_API_KEY festlegen. Alternativ können Sie die Client-ID und den geheimen oder API-Schlüssel als Befehlszeilenargumente übergeben: --bunq-client-id <id> --bunq-client-secret <secret> oder --bunq-api-key <key> .

Hinweis: Wenn Sie tatsächliche Zahlungen in Echtgeld ohne Scheck erstellen möchten, müssen Sie einen API-Schlüssel verwenden.

Installation und Verwendung

  1. Installieren Sie die CLI-Tools bunq-mcp und mcp-remote :

npm install -g bunq-mcp mcp-remote

  1. Erstellen Sie in der Bunq-App einen OAuth-Client oder API-Schlüssel (siehe oben).

  2. (Optional) Generieren Sie ein neues öffentliches/privates Schlüsselpaar:

bunq-mcp --generate-keys

Beachten Sie, dass openssl installiert und im Pfad verfügbar ist. Wenn Sie diesen Schritt überspringen, werden die bereits vorhandenen Schlüssel in ./src/keys/ verwendet. Die erstellten Schlüssel überschreiben die bereits vorhandenen Schlüssel und werden im globalen Verzeichnis node_modules gespeichert.

  1. Starten Sie den MCP-Server in einem beliebigen Terminal:

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

Client-ID und Geheimnis können auch mit den Umgebungsvariablen BUNQ_CLIENT_ID und BUNQ_CLIENT_SECRET festgelegt werden.

  1. Fügen Sie in Ihrem bevorzugten Editor oder einem anderen MCP-Client (z. B. Claude Desktop) Folgendes hinzu:

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

Passen Sie den Port gegebenenfalls erneut an. mcp-remote wird verwendet, da dieses Paket den SSE-Transport nutzt, obwohl die meisten Clients dies nicht unterstützen. Weitere Informationen finden Sie unter mcp-remote .

  1. Sobald der MCP-Server gestartet ist, sollte mcp-remote Ihren Browser öffnen, um den OAuth-Flow zu starten.

Sie sollten nun in der Lage sein, eine Frage zu stellen, wie zum Beispiel:

  • Wie hoch ist mein aktuelles Bunq-Guthaben?

  • Wer sind meine Top 5 Gegenparteien?

  • Was war meine letzte Transaktion?

Fehlerbehebung

  • Wenn es ein Problem mit dem OAuth-Flow gibt, können Sie versuchen, das von mcp-remote erstellte Verzeichnis in Ihrem Home-Verzeichnis zu löschen: rm -rf ~/.mcp-auth .

Befehlszeilenschnittstelle (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)

Entwicklung

  1. Erstellen Sie im Stammverzeichnis eine Datei .dev.vars mit folgendem Inhalt:

# 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=

  1. Entwicklungsserver starten

npm run dev

  1. Einrichten der MCP-Konfiguration

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

Einschränkungen

  • Es ist nicht möglich, Zahlungen über den OAuth-Flow zu erstellen. Es können nur Zahlungsentwürfe erstellt werden.

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

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/WilcoKruijer/bunq-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server