bunq Partner MCP

An MCP (Model Context Protocol) server that connects AI assistants like Claude to the bunq Partner API. Once set up, you can drive the entire partner onboarding flow — provisioning users, KYC, accounts, payments, cards, and compliance — through natural language conversation.

What you can do

After connecting, you can ask Claude things like:

• "Provision a new user with email jan@example.nl and phone +31612345678"
• "Check the status of provision 4521"
• "Create a EUR bank account for user 8823"
• "Make a payment of €50 from account 12 to IBAN NL91ABNA0417164300"
• "Show me all open compliance inquiries for user 9002"
• "Register a webhook for mutations on user 8823 pointing to https://myapp.com/webhooks"

Claude handles the full auth lifecycle, request signing, token management, and status polling automatically.

Prerequisites

• Node.js 20+
• A bunq Partner API key (provided by bunq)
• Claude Desktop with a Pro or Team subscription

Setup

1. Clone and build

git clone https://github.com/bunq/partner-mcp.git
cd partner-mcp
npm install
npm run build

2. Add to Claude Desktop

Edit your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "bunq-partner": {
      "command": "node",
      "args": ["/absolute/path/to/partner-mcp/dist/index.js"],
      "env": {
        "BUNQ_API_KEY": "your_partner_api_key_here",
        "BUNQ_ENV": "sandbox"
      }
    }
  }
}

Replace /absolute/path/to/partner-mcp with the actual path where you cloned the repo.

3. Restart Claude Desktop

Quit and reopen Claude Desktop. You should see the bunq tools available.

4. Verify the connection

Ask Claude: "Check my bunq session info" — it should respond with your authenticated user ID and environment.

Environments

BUNQ_ENV	Base URL
sandbox (default)	https://partner-api.sandbox.bunq.com
production	https://api.partner.bunq.com

Always test in sandbox first. Sandbox API keys contain a sandbox_ prefix.

Updating

When a new version is released:

cd partner-mcp
git pull
npm install
npm run build

Then restart Claude Desktop.

Available tools (41)

See docs/ for the full documentation, or browse by chapter:

• Chapter 0 — API Context (auth, session, signing)
• Chapter 1 — OAuth
• Chapter 2 — User Provision
• Chapter 3 — Onboarding & KYC
• Chapter 4 — Webhooks
• Chapter 5 — Monetary Accounts
• Chapter 6 — Payments
• Chapter 7 — Cards
• Chapter 8 — Compliance

Project structure

partner-mcp/
├── src/
│   ├── index.ts          # MCP server entry point (stdio transport)
│   ├── bunq-client.ts    # HTTP client + auth lifecycle
│   ├── tools.ts          # Tool definitions (MCP schemas)
│   └── handler.ts        # Tool → API call mapping
├── docs/                 # Documentation (synced to GitBook)
├── scripts/
│   └── UPDATE.md         # Script to update MCP + docs from GitLab MRs
├── package.json
└── tsconfig.json

Support

• 📚 Full documentation
• 🐛 Open an issue
• 💬 bunq Together