Burnbound MCP

Burnbound is a spending control plane for AI agents that allows agents to pay x402 APIs, process Stripe refunds, and manage Stripe Issuing cards within daily caps, allowed hosts, and human approval thresholds. It provides tools for fetching paid content, checking budgets, proposing rules, and managing approvals without holding funds or secret keys.

Package and access

Local package with source-attributed installation metadata. Koskamo does not execute packages during review.

Vendor evidenceLocal stdioSource reviewed; not executedOperated by Burnbound

Vendor documentation

What you can do with it

Pay x402 and MPP APIs within daily caps
Process Stripe refunds through an action gateway
Check agent budgets and payment status
Manage human approval for payments above thresholds

Source and maintenance

Vendor evidenceRegistry 0.7.0

mcp-registry: dev.burnbound/mcp@0.7.0 Project website

Packages and installation

Source-provided package data. Koskamo has not executed or live-probed this package.

@burnbound/mcp 0.7.0

npmnpx

@burnbound/mcp package definition

{
  "version": "0.7.0",
  "transport": "stdio",
  "identifier": "@burnbound/mcp",
  "runtimeHint": "npx",
  "registryType": "npm",
  "registryBaseUrl": "https://registry.npmjs.org",
  "environmentVariables": [
    {
      "name": "BURNBOUND_KEY",
      "format": "string",
      "isRequired": true,
      "description": "Agent key (bb_agent_…) created in the Burnbound dashboard. Sent only to the Burnbound API."
    },
    {
      "name": "BURNBOUND_API",
      "format": "string",
      "default": "https://app.burnbound.dev",
      "description": "Burnbound API base URL. https:// only (http:// only for loopback). Set it for a self-hosted or local API."
    },
    {
      "name": "BURNBOUND_AGENT_ID",
      "format": "string",
      "description": "Only with an org key instead of an agent key: the agent the tools act for. Ignored with an agent key."
    },
    {
      "name": "BURNBOUND_WALLET_PROFILE",
      "format": "string",
      "default": "default",
      "description": "Local wallet profile for client-side signing (created with `npx -y @burnbound/mcp wallet init`). 1–32 of a-z, 0-9, _ and -."
    },
    {
      "name": "BURNBOUND_HOME",
      "format": "filepath",
      "default": "~/.burnbound",
      "description": "Directory for the local wallet file when the OS keychain is not used."
    },
    {
      "name": "BURNBOUND_MAX_RESPONSE_BYTES",
      "format": "number",
      "default": "1048576",
      "description": "fetch_paid response body cap in bytes (maximum 10485760). Longer bodies are truncated."
    },
    {
      "name": "BURNBOUND_FETCH_TIMEOUT_MS",
      "format": "number",
      "default": "30000",
      "description": "fetch_paid deadline for the whole exchange with the URL, between 1000 and 120000 ms."
    },
    {
      "name": "BURNBOUND_APP_URL",
      "format": "string",
      "description": "Origin 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."
    },
    {
      "name": "BURNBOUND_APPROVAL_WAIT_MS",
      "format": "number",
      "default": "40000",
      "description": "How 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."
    },
    {
      "name": "BURNBOUND_BASE_RPC_URL",
      "format": "string",
      "default": "https://mainnet.base.org",
      "description": "diagnose_payment: Base RPC used to read the paying wallet's USDC balance. https:// only. Only the wallet address is sent to it."
    },
    {
      "name": "BURNBOUND_BASE_SEPOLIA_RPC_URL",
      "format": "string",
      "default": "https://sepolia.base.org",
      "description": "diagnose_payment: Base Sepolia RPC used to read the paying wallet's USDC balance. https:// only."
    }
  ]
}

Tools

Reported by the attributed source; not independently observed by Koskamo.

No tool definitions available.

Connect from your client

Each snippet configures the same source-provided package; replace placeholders before use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Cursor

Merge this local stdio configuration, replace every placeholder environment value, and restart Cursor. Koskamo has not executed this package.

Cursor configuration

{
  "mcpServers": {
    "burnbound-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@burnbound/mcp@0.7.0"
      ],
      "env": {
        "BURNBOUND_KEY": "<YOUR_BURNBOUND_KEY>",
        "BURNBOUND_API": "<YOUR_BURNBOUND_API>",
        "BURNBOUND_AGENT_ID": "<YOUR_BURNBOUND_AGENT_ID>",
        "BURNBOUND_WALLET_PROFILE": "<YOUR_BURNBOUND_WALLET_PROFILE>",
        "BURNBOUND_HOME": "<YOUR_BURNBOUND_HOME>",
        "BURNBOUND_MAX_RESPONSE_BYTES": "<YOUR_BURNBOUND_MAX_RESPONSE_BYTES>",
        "BURNBOUND_FETCH_TIMEOUT_MS": "<YOUR_BURNBOUND_FETCH_TIMEOUT_MS>",
        "BURNBOUND_APP_URL": "<YOUR_BURNBOUND_APP_URL>",
        "BURNBOUND_APPROVAL_WAIT_MS": "<YOUR_BURNBOUND_APPROVAL_WAIT_MS>",
        "BURNBOUND_BASE_RPC_URL": "<YOUR_BURNBOUND_BASE_RPC_URL>",
        "BURNBOUND_BASE_SEPOLIA_RPC_URL": "<YOUR_BURNBOUND_BASE_SEPOLIA_RPC_URL>"
      }
    }
  }
}

Cline

Merge this local stdio configuration, replace every placeholder environment value, and restart Cline. Koskamo has not executed this package.

Cline configuration

{
  "mcpServers": {
    "burnbound-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@burnbound/mcp@0.7.0"
      ],
      "env": {
        "BURNBOUND_KEY": "<YOUR_BURNBOUND_KEY>",
        "BURNBOUND_API": "<YOUR_BURNBOUND_API>",
        "BURNBOUND_AGENT_ID": "<YOUR_BURNBOUND_AGENT_ID>",
        "BURNBOUND_WALLET_PROFILE": "<YOUR_BURNBOUND_WALLET_PROFILE>",
        "BURNBOUND_HOME": "<YOUR_BURNBOUND_HOME>",
        "BURNBOUND_MAX_RESPONSE_BYTES": "<YOUR_BURNBOUND_MAX_RESPONSE_BYTES>",
        "BURNBOUND_FETCH_TIMEOUT_MS": "<YOUR_BURNBOUND_FETCH_TIMEOUT_MS>",
        "BURNBOUND_APP_URL": "<YOUR_BURNBOUND_APP_URL>",
        "BURNBOUND_APPROVAL_WAIT_MS": "<YOUR_BURNBOUND_APPROVAL_WAIT_MS>",
        "BURNBOUND_BASE_RPC_URL": "<YOUR_BURNBOUND_BASE_RPC_URL>",
        "BURNBOUND_BASE_SEPOLIA_RPC_URL": "<YOUR_BURNBOUND_BASE_SEPOLIA_RPC_URL>"
      }
    }
  }
}

VS Code

Merge this local stdio configuration, replace every placeholder environment value, and restart VS Code. Koskamo has not executed this package.

VS Code configuration

{
  "servers": {
    "burnbound-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@burnbound/mcp@0.7.0"
      ],
      "env": {
        "BURNBOUND_KEY": "<YOUR_BURNBOUND_KEY>",
        "BURNBOUND_API": "<YOUR_BURNBOUND_API>",
        "BURNBOUND_AGENT_ID": "<YOUR_BURNBOUND_AGENT_ID>",
        "BURNBOUND_WALLET_PROFILE": "<YOUR_BURNBOUND_WALLET_PROFILE>",
        "BURNBOUND_HOME": "<YOUR_BURNBOUND_HOME>",
        "BURNBOUND_MAX_RESPONSE_BYTES": "<YOUR_BURNBOUND_MAX_RESPONSE_BYTES>",
        "BURNBOUND_FETCH_TIMEOUT_MS": "<YOUR_BURNBOUND_FETCH_TIMEOUT_MS>",
        "BURNBOUND_APP_URL": "<YOUR_BURNBOUND_APP_URL>",
        "BURNBOUND_APPROVAL_WAIT_MS": "<YOUR_BURNBOUND_APPROVAL_WAIT_MS>",
        "BURNBOUND_BASE_RPC_URL": "<YOUR_BURNBOUND_BASE_RPC_URL>",
        "BURNBOUND_BASE_SEPOLIA_RPC_URL": "<YOUR_BURNBOUND_BASE_SEPOLIA_RPC_URL>"
      }
    }
  }
}

Claude Desktop

Merge this local stdio configuration, replace every placeholder environment value, and restart Claude Desktop. Koskamo has not executed this package.

Claude Desktop configuration

{
  "mcpServers": {
    "burnbound-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@burnbound/mcp@0.7.0"
      ],
      "env": {
        "BURNBOUND_KEY": "<YOUR_BURNBOUND_KEY>",
        "BURNBOUND_API": "<YOUR_BURNBOUND_API>",
        "BURNBOUND_AGENT_ID": "<YOUR_BURNBOUND_AGENT_ID>",
        "BURNBOUND_WALLET_PROFILE": "<YOUR_BURNBOUND_WALLET_PROFILE>",
        "BURNBOUND_HOME": "<YOUR_BURNBOUND_HOME>",
        "BURNBOUND_MAX_RESPONSE_BYTES": "<YOUR_BURNBOUND_MAX_RESPONSE_BYTES>",
        "BURNBOUND_FETCH_TIMEOUT_MS": "<YOUR_BURNBOUND_FETCH_TIMEOUT_MS>",
        "BURNBOUND_APP_URL": "<YOUR_BURNBOUND_APP_URL>",
        "BURNBOUND_APPROVAL_WAIT_MS": "<YOUR_BURNBOUND_APPROVAL_WAIT_MS>",
        "BURNBOUND_BASE_RPC_URL": "<YOUR_BURNBOUND_BASE_RPC_URL>",
        "BURNBOUND_BASE_SEPOLIA_RPC_URL": "<YOUR_BURNBOUND_BASE_SEPOLIA_RPC_URL>"
      }
    }
  }
}

Let your agent find its tools

Find servers like Burnbound MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows

See all 358