bolthub
The bolthub API marketplace, L402 gateways, and your other MCP servers, on one Lightning…
- 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/mcpAdd 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