Skip to content
MCP server

Burnbound

Spending controls for agent payments: caps, allowed hosts and human approval for x402 APIs

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, API
Runs
Locally
Version
0.7.0
Listing updated
1 day ago

About Burnbound

Burnbound is a freemium MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

Burnbound sits between an agent and the money. Before an agent pays an x402 or MPP API, refunds a Stripe charge or spends on a Stripe Issuing card, the request is checked against rules a person set: per-payment and daily caps, allowed hosts, team budgets, custom rules and human approval above a threshold. It states that it never holds funds, wallet keys or the customer's Stripe secret key: refunds run in a gateway you host, card money stays in your Stripe balance and API payments are signed by a wallet you bring.

The local stdio package is @burnbound/mcp and needs an agent key (bb_agent_) from the dashboard. Its tools include fetch_paid, get_budget, propose_rule, list_payments, get_approval_status, search_paid_apis, diagnose_payment, stripe_refund, stripe_credit, shopify_refund and task mandates, where one approval covers a whole task. A decision webhook lets your own system deny or hold payments.

Plans in euros: Free at no cost, Team at 39 a month and Business from 299 a month, with a refund audit that replays past Stripe refunds against a policy.

Install

Run in a terminal

claude mcp add mcp --env BURNBOUND_KEY='<BURNBOUND_KEY>' -- npx -y @burnbound/mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@burnbound/mcp"
      ],
      "env": {
        "BURNBOUND_KEY": "<BURNBOUND_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@burnbound/mcp"
      ],
      "env": {
        "BURNBOUND_KEY": "<BURNBOUND_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@burnbound/mcp"
      ],
      "env": {
        "BURNBOUND_KEY": "<BURNBOUND_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@burnbound/mcp"
      ],
      "env": {
        "BURNBOUND_KEY": "<BURNBOUND_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@burnbound/mcp"
      ],
      "env": {
        "BURNBOUND_KEY": "<BURNBOUND_KEY>"
      }
    }
  }
}

Configuration

  • BURNBOUND_KEYAgent key (bb_agent_…) created in the Burnbound dashboard. Sent only to the Burnbound API.Required
  • BURNBOUND_APIBurnbound API base URL. https:// only (http:// only for loopback). Set it for a self-hosted or local API.
  • BURNBOUND_AGENT_IDOnly with an org key instead of an agent key: the agent the tools act for. Ignored with an agent key.
  • BURNBOUND_WALLET_PROFILELocal wallet profile for client-side signing (created with `npx -y @burnbound/mcp wallet init`). 1–32 of a-z, 0-9, _ and -.
  • BURNBOUND_HOMEDirectory for the local wallet file when the OS keychain is not used.
  • BURNBOUND_MAX_RESPONSE_BYTESfetch_paid response body cap in bytes (maximum 10485760). Longer bodies are truncated.
  • BURNBOUND_FETCH_TIMEOUT_MSfetch_paid deadline for the whole exchange with the URL, between 1000 and 120000 ms.
  • BURNBOUND_APP_URLOrigin of the Burnbound panel, for the approval link a held payment returns (and opens in clients with URL-mode elicitation). Default: the API origin when it is https. https:// only.
  • BURNBOUND_APPROVAL_WAIT_MSHow long fetch_paid waits for the human's decision once the approval page is opened from the chat, between 0 and 50000 ms. 0 returns pending_approval at once.
  • BURNBOUND_BASE_RPC_URLdiagnose_payment: Base RPC used to read the paying wallet's USDC balance. https:// only. Only the wallet address is sent to it.
  • BURNBOUND_BASE_SEPOLIA_RPC_URLdiagnose_payment: Base Sepolia RPC used to read the paying wallet's USDC balance. https:// only.

Tools this server provides (11)

Taken from the project documentation; the running server may differ.

fetch_paid
Fetch a URL and pay for it within policy
get_budget
Read remaining budget
propose_rule
Propose a spending rule
list_payments
List payments
get_approval_status
Check an approval's status
search_paid_apis
Search paid APIs
diagnose_payment
Diagnose why a payment failed
stripe_refund
Refund a Stripe charge under policy
stripe_credit
Issue a Stripe credit under policy
shopify_refund
Refund a Shopify order under policy
request_mandate
Ask for approval of a whole task

What it does

Spending caps
Per-payment and daily limits on agent spend.
Allowed hosts
Restricts which hosts a paid fetch may reach.
Human approval
Holds payments above a threshold for a person to approve.
Task mandates
Approve a whole task once instead of each payment.
Diagnose payments
diagnose_payment explains why a payment failed, including wallet balance.
Evidence pack
Exports decisions and approvals with a SHA-256 manifest for auditors.

Good for

  • Let an agent call paid APIs within a daily budget
  • Hold large refunds for approval
  • Check what a policy would have denied last week
  • Give a support agent bounded refund power
  • Export audit evidence for compliance

Pricing

Freemium

Free plan; Team 39 EUR/mo + VAT; Business from 299 EUR/mo

Prices change. Check burnbound.dev before you buy.

Burnbound FAQ

What does it cost?

Free for one person; Team is 39 euros a month plus VAT; Business starts at 299 euros a month.

Does Burnbound hold my money?

No, it says it never holds funds, wallet keys or your Stripe secret key.

What credential does the MCP need?

An agent key starting bb_agent_ created in the dashboard.

Is there a JavaScript SDK?

Not yet published on npm; use the MCP server today.

Is Burnbound free?

Burnbound has a free plan, with paid plans for more usage or features.

How do I add Burnbound to Claude Code?

Run this command in your terminal: claude mcp add mcp --env BURNBOUND_KEY='<BURNBOUND_KEY>' -- npx -y @burnbound/mcp

What are the best alternatives to Burnbound?

The closest alternatives to Burnbound are REA, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Agent Roast and Midplane.

Alternatives to Burnbound

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools
  5. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments