MCP 服务器

bunq Partner MCP

An MCP server that connects AI assistants to the bunq Partner API, enabling natural language management of partner onboarding, including provisioning users, KYC, accounts, payments, cards, and compliance.

README

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