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:

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.