bolthub MCP Server
by signaltech-orgai.bolthub/mcpv0.7.2
The bolthub API marketplace, L402 gateways, and your other MCP servers, on one Lightning budget.
context tax
queued
security
queued
cold start
queued
freshness
Maintained3mo ago
Install bolthub MCP server
Install in Claude Code
claude mcp add signaltech-org -e LND_MACAROON='<lnd-macaroon>' -e NWC_URI='<nwc-uri>' -e LNBITS_ADMIN_KEY='<lnbits-admin-key>' -e PHOENIXD_PASSWORD='<phoenixd-password>' -e BOLTHUB_ACCOUNT_TOKEN='<bolthub-account-token>' -- npx -y @bolthub/mcpInstall in Cursor
{
"mcpServers": {
"signaltech-org": {
"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 (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"signaltech-org": {
"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>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"signaltech-org": {
"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 .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"signaltech-org": {
"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.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| LND_REST_HOST | — | — | LND 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_MACAROON | — | yes | Hex-encoded macaroon for LND (use a pay-scoped macaroon in production). Required with LND_REST_HOST. |
| NWC_URI | — | yes | Nostr Wallet Connect string — easiest setup, works with CoinOS, Alby Hub, Zeus, and more. Alternative to LND. |
| LNBITS_URL | — | — | LNbits instance URL (pair with LNBITS_ADMIN_KEY). Alternative wallet. |
| LNBITS_ADMIN_KEY | — | yes | Admin API key for LNbits. Required with LNBITS_URL. |
| PHOENIXD_URL | — | — | Phoenixd HTTP API URL (pair with PHOENIXD_PASSWORD). Alternative wallet. |
| PHOENIXD_PASSWORD | — | yes | HTTP password for Phoenixd. Required with PHOENIXD_URL. |
| BUDGET_SATS | — | — | Maximum 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_TOKEN | — | yes | Account 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. |
Freshness
Maintained — last maintenance signal 3mo ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-07-25 · 3mo ago · GitHub
Latest release
2026-06-20 · 4mo ago · GitHub · v0.2.0
Package published
no data · npm/PyPI
Registry entry updated
2026-07-25 · 3mo ago · official registry · v0.7.2
FAQ
›How do I install the bolthub MCP server in Claude Code?
Run: claude mcp add signaltech-org -e LND_MACAROON='<lnd-macaroon>' -e NWC_URI='<nwc-uri>' -e LNBITS_ADMIN_KEY='<lnbits-admin-key>' -e PHOENIXD_PASSWORD='<phoenixd-password>' -e BOLTHUB_ACCOUNT_TOKEN='<bolthub-account-token>' -- npx -y @bolthub/mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does bolthub require an API key?
Yes. It expects LND_MACAROON, NWC_URI, LNBITS_ADMIN_KEY, PHOENIXD_PASSWORD, BOLTHUB_ACCOUNT_TOKEN, of which 5 are secrets.
›Can I use bolthub as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is bolthub in the official MCP registry?
Yes, as ai.bolthub/mcp.