# Burnbound

> Burnbound is a freemium MCP server for finance and payments. Spending controls for agent payments: caps, allowed hosts and human approval for x402 APIs. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://burnbound.dev/docs
- **MCP Registry name:** dev.burnbound/mcp
- **Categories:** finance and payments, security
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [Tinplate Edge AI Safety, Security & EU Compliance](https://ai-powered.com/mcp/tinplate-edge-ai-safety-security-and-eu-compliance): Tinplate Edge AI Safety, Security & EU Compliance is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/burnbound
