MCP server
Connect Cursor, Claude, or any MCP client to https://mcp.bruce.money.
Auth
Merchant tools accept a short-lived bat_ token from OAuth consent or a long-lived bk_live_ key. Send it as Authorization: Bearer … or X-Api-Key.
Agent spend tools (bruce_pay, bruce_get_balance, bruce_create_escrow, mandates, and approval requests) need a delegated bk_agent_live_… key, or a bat_ token that includes the agent scopes. The API still enforces those scopes and the session signer.
Tools
The full hosted catalog — checkout, invoices, offerings, escrow, verification, and webhooks — is the tool catalog. Checkout is bruce_checkout_create.
Agent-specific tools on the same server:
bruce_get_balancebruce_list_transactionsbruce_paybruce_request_payment_approval— queues a payment the owner approves in the Bruce appbruce_create_escrowbruce_get_payment_statusbruce_list_mandates
Connect in one line
Delegated agent spend (Cursor, Claude Desktop, and others):
{"mcpServers":{"bruce":{"url":"https://mcp.bruce.money/mcp","headers":{"Authorization":"Bearer bk_agent_live_…"}}}}
Merchant tools with a short-lived OAuth token. Pick scopes on the consent screen first:
{"mcpServers":{"bruce":{"url":"https://mcp.bruce.money/mcp","headers":{"Authorization":"Bearer bat_…"}}}}
Expanded:
{
"mcpServers": {
"bruce": {
"url": "https://mcp.bruce.money/mcp",
"headers": {
"Authorization": "Bearer bk_agent_live_…"
}
}
}
}
The MCP Worker is a thin proxy - all spend still goes through the Agent API policy engine. Merchant calls go through the same /api/v1 auth, scopes, and audit as the Public API.
This server spends a person's balance through a delegated key. To give an agent its own wallet instead, use the local agent MCP (npx -y @bruce/agent-mcp). Agent-native accounts compares the two.