Burnbound MCP Server
dev.burnbound/mcpv0.3.3
Let your AI agent pay x402 APIs within daily caps, allowed hosts and human approval.
context tax
queued
security
queued
cold start
queued
freshness
Active4d ago
Install Burnbound MCP server
Install in Claude Code
claude mcp add burnbound -e BURNBOUND_KEY='<burnbound-key>' -- npx -y @burnbound/mcpInstall in Cursor
{
"mcpServers": {
"burnbound": {
"command": "npx",
"args": [
"-y",
"@burnbound/mcp"
],
"env": {
"BURNBOUND_KEY": "<burnbound-key>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"burnbound": {
"command": "npx",
"args": [
"-y",
"@burnbound/mcp"
],
"env": {
"BURNBOUND_KEY": "<burnbound-key>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"burnbound": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@burnbound/mcp"
],
"env": {
"BURNBOUND_KEY": "<burnbound-key>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"burnbound": {
"command": "npx",
"args": [
"-y",
"@burnbound/mcp"
],
"env": {
"BURNBOUND_KEY": "<burnbound-key>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| BURNBOUND_KEY | yes | yes | Agent key (bb_agent_…) created in the Burnbound dashboard. Sent only to the Burnbound API. |
| BURNBOUND_API | — | — | Burnbound API base URL. https:// only (http:// only for loopback). Set it for a self-hosted or local API. |
| BURNBOUND_AGENT_ID | — | — | Only with an org key instead of an agent key: the agent the tools act for. Ignored with an agent key. |
| BURNBOUND_WALLET_PROFILE | — | — | Local wallet profile for client-side signing (created with `npx -y @burnbound/mcp wallet init`). 1–32 of a-z, 0-9, _ and -. |
| BURNBOUND_HOME | — | — | Directory for the local wallet file when the OS keychain is not used. |
| BURNBOUND_MAX_RESPONSE_BYTES | — | — | fetch_paid response body cap in bytes (maximum 10485760). Longer bodies are truncated. |
| BURNBOUND_FETCH_TIMEOUT_MS | — | — | fetch_paid deadline for the whole exchange with the URL, between 1000 and 120000 ms. |
Freshness
Active — last maintenance signal 4d ago. The newest of the signals below sets the band.
Last commit (default branch)
no data · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-10-06 · 4d ago · official registry · v0.3.3
FAQ
›How do I install the Burnbound MCP server in Claude Code?
Run: claude mcp add burnbound -e BURNBOUND_KEY='<burnbound-key>' -- npx -y @burnbound/mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Burnbound require an API key?
Yes. It expects BURNBOUND_KEY, of which 1 is a secret.
›Can I use Burnbound as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Burnbound in the official MCP registry?
Yes, as dev.burnbound/mcp.