Bunq MCP

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

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

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

3. (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.

4. 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.

5. 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 .

6. 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=

2. Entwicklungsserver starten

npm run dev

3. 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." }] }