# bolthub

> bolthub is an open-source MCP server. The bolthub API marketplace, L402 gateways, and your other MCP servers, on one Lightning budget. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Website:** https://docs.bolthub.ai/docs/sdks/mcp
- **Repository:** https://github.com/signaltech-org/bolthub-sdk/tree/HEAD/packages/mcp
- **MCP Registry name:** ai.bolthub/mcp
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

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

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