mcpField
B
Burnbound

Burnbound

Local
burnbound.devFinance
Visit website

About Burnbound

Let your AI agent pay x402 APIs within daily caps, allowed hosts and human approval

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "dev-burnbound": {
      "command": "npx",
      "args": [
        "-y",
        "@burnbound/mcp"
      ],
      "env": {
        "BURNBOUND_KEY": "<BURNBOUND_KEY>",
        "BURNBOUND_API": "<BURNBOUND_API>",
        "BURNBOUND_AGENT_ID": "<BURNBOUND_AGENT_ID>",
        "BURNBOUND_WALLET_PROFILE": "<BURNBOUND_WALLET_PROFILE>",
        "BURNBOUND_HOME": "<BURNBOUND_HOME>",
        "BURNBOUND_MAX_RESPONSE_BYTES": "<BURNBOUND_MAX_RESPONSE_BYTES>",
        "BURNBOUND_FETCH_TIMEOUT_MS": "<BURNBOUND_FETCH_TIMEOUT_MS>",
        "BURNBOUND_APP_URL": "<BURNBOUND_APP_URL>",
        "BURNBOUND_APPROVAL_WAIT_MS": "<BURNBOUND_APPROVAL_WAIT_MS>",
        "BURNBOUND_BASE_RPC_URL": "<BURNBOUND_BASE_RPC_URL>",
        "BURNBOUND_BASE_SEPOLIA_RPC_URL": "<BURNBOUND_BASE_SEPOLIA_RPC_URL>"
      }
    }
  }
}
Run commandnpx -y @burnbound/mcp
Environment variables to set
BURNBOUND_KEYSecretAgent key (bb_agent_…) created in the Burnbound dashboard. Sent only to the Burnbound API.
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.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@burnbound/mcp0.7.0

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

The maintainer has not added details yet. Check the README in the repository.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.