Skip to content
MCP server

bolthub

The bolthub API marketplace, L402 gateways, and your other MCP servers, on one Lightning…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.7.2
Listing updated
4 days ago

About bolthub

bolthub is an open-source MCP server. It runs locally on your machine and is started by your AI client.

The bolthub API marketplace, L402 gateways, and your other MCP servers, on one Lightning budget.

Install

Run in a terminal

claude mcp add mcp --env LND_MACAROON='<LND_MACAROON>' --env NWC_URI='<NWC_URI>' --env LNBITS_ADMIN_KEY='<LNBITS_ADMIN_KEY>' --env PHOENIXD_PASSWORD='<PHOENIXD_PASSWORD>' --env BOLTHUB_ACCOUNT_TOKEN='<BOLTHUB_ACCOUNT_TOKEN>' -- npx -y @bolthub/mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@bolthub/mcp"
      ],
      "env": {
        "LND_MACAROON": "<LND_MACAROON>",
        "NWC_URI": "<NWC_URI>",
        "LNBITS_ADMIN_KEY": "<LNBITS_ADMIN_KEY>",
        "PHOENIXD_PASSWORD": "<PHOENIXD_PASSWORD>",
        "BOLTHUB_ACCOUNT_TOKEN": "<BOLTHUB_ACCOUNT_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@bolthub/mcp"
      ],
      "env": {
        "LND_MACAROON": "<LND_MACAROON>",
        "NWC_URI": "<NWC_URI>",
        "LNBITS_ADMIN_KEY": "<LNBITS_ADMIN_KEY>",
        "PHOENIXD_PASSWORD": "<PHOENIXD_PASSWORD>",
        "BOLTHUB_ACCOUNT_TOKEN": "<BOLTHUB_ACCOUNT_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@bolthub/mcp"
      ],
      "env": {
        "LND_MACAROON": "<LND_MACAROON>",
        "NWC_URI": "<NWC_URI>",
        "LNBITS_ADMIN_KEY": "<LNBITS_ADMIN_KEY>",
        "PHOENIXD_PASSWORD": "<PHOENIXD_PASSWORD>",
        "BOLTHUB_ACCOUNT_TOKEN": "<BOLTHUB_ACCOUNT_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@bolthub/mcp"
      ],
      "env": {
        "LND_MACAROON": "<LND_MACAROON>",
        "NWC_URI": "<NWC_URI>",
        "LNBITS_ADMIN_KEY": "<LNBITS_ADMIN_KEY>",
        "PHOENIXD_PASSWORD": "<PHOENIXD_PASSWORD>",
        "BOLTHUB_ACCOUNT_TOKEN": "<BOLTHUB_ACCOUNT_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@bolthub/mcp"
      ],
      "env": {
        "LND_MACAROON": "<LND_MACAROON>",
        "NWC_URI": "<NWC_URI>",
        "LNBITS_ADMIN_KEY": "<LNBITS_ADMIN_KEY>",
        "PHOENIXD_PASSWORD": "<PHOENIXD_PASSWORD>",
        "BOLTHUB_ACCOUNT_TOKEN": "<BOLTHUB_ACCOUNT_TOKEN>"
      }
    }
  }
}

Configuration

  • LND_REST_HOSTLND REST API URL (recommended wallet; pair with LND_MACAROON). A wallet is optional — without one, free tools and marketplace search still work; paid calls return their payment challenge.
  • LND_MACAROONHex-encoded macaroon for LND (use a pay-scoped macaroon in production). Required with LND_REST_HOST.
  • NWC_URINostr Wallet Connect string — easiest setup, works with CoinOS, Alby Hub, Zeus, and more. Alternative to LND.
  • LNBITS_URLLNbits instance URL (pair with LNBITS_ADMIN_KEY). Alternative wallet.
  • LNBITS_ADMIN_KEYAdmin API key for LNbits. Required with LNBITS_URL.
  • PHOENIXD_URLPhoenixd HTTP API URL (pair with PHOENIXD_PASSWORD). Alternative wallet.
  • PHOENIXD_PASSWORDHTTP password for Phoenixd. Required with PHOENIXD_URL.
  • BUDGET_SATSMaximum sats the server may spend per session (process lifetime), across ALL sources. Unset = unlimited; 0 = free tools only. The config file's budget.sat takes precedence.
  • BOLTHUB_ACCOUNT_TOKENAccount token for tools that act on YOUR bolthub account (workspace, listing, audit, earnings, and node tools). Optional even for those: the connect_account tool pairs via the browser instead. Never needed to discover, call, or pay for APIs — buying is account-less.

Pricing

Open source

Prices change. Check docs.bolthub.ai before you buy.

bolthub FAQ

Is bolthub free?

Yes. bolthub is open source, so you can use and self-host it for free.

How do I add bolthub to Claude Code?

Run this command in your terminal: claude mcp add mcp --env LND_MACAROON='<LND_MACAROON>' --env NWC_URI='<NWC_URI>' --env LNBITS_ADMIN_KEY='<LNBITS_ADMIN_KEY>' --env PHOENIXD_PASSWORD='<PHOENIXD_PASSWORD>' --env BOLTHUB_ACCOUNT_TOKEN='<BOLTHUB_ACCOUNT_TOKEN>' -- npx -y @bolthub/mcp