Boltwork MCP server

mcp-name: io.github.Squidboy30/boltwork-mcp

boltwork-mcp

MCP server for Boltwork — AI services that pay for themselves via Bitcoin Lightning.

Give your AI agent PDF summarisation, code review, translation, web extraction, document comparison, and persistent memory — all paid autonomously in sats. No API keys. No subscriptions. No accounts.

What this is

Boltwork is a pay-per-call AI services API that uses the L402 protocol — your agent makes a request, receives a Lightning invoice, pays it automatically, and gets the result back. No human involved.

This package wraps Boltwork as an MCP server so any MCP-compatible AI (Claude, Cursor, Windsurf, etc.) can use it as a tool — with payments handled transparently in the background.

Try it immediately — no wallet required

Two tools work right now with zero setup:

{
  "mcpServers": {
    "boltwork": {
      "command": "uvx",
      "args": ["boltwork-mcp"],
      "env": {}
    }
  }
}

Then ask your AI:

"Use trial_review_code to review this: def add(a, b): return a + b"
"Use trial_summarise to summarise this: <paste any text>"

Real AI results instantly. No Lightning wallet. No setup. Rate limited to 5 calls/hour.

Install

pip install boltwork-mcp

# If using NWC (Alby, Mutiny, Coinos, etc.):
pip install "boltwork-mcp[nwc]"

Or use directly with uvx — no install needed:

uvx boltwork-mcp

Setup — pick a wallet

Four wallet backends are supported. Pick whichever fits your setup:

Option A — NWC / Nostr Wallet Connect (easiest)

Works with Alby, Mutiny Wallet, Coinos, Primal, Cashu.me, and any NWC-compatible wallet.

1. Get a connection string:

• Alby — go to nwc.getalby.com, create a budget, copy the string
• Mutiny — Settings → Connections → Add connection
• Coinos — coinos.io → Settings → Nostr Wallet Connect

1. Add to your MCP config:

{
  "mcpServers": {
    "boltwork": {
      "command": "uvx",
      "args": ["boltwork-mcp"],
      "env": {
        "NWC_CONNECTION_STRING": "nostr+walletconnect://your-string-here"
      }
    }
  }
}

Requires: pip install "boltwork-mcp[nwc]"

Option B — LNbits

Works with lnbits.com or any self-hosted LNbits instance. Popular with BTCPay Server users and home node operators.

1. Create a wallet at lnbits.com or your instance
2. Go to API info → copy your Invoice/read key

{
  "mcpServers": {
    "boltwork": {
      "command": "uvx",
      "args": ["boltwork-mcp"],
      "env": {
        "LNBITS_URL": "https://lnbits.com",
        "LNBITS_API_KEY": "your-invoice-key-here"
      }
    }
  }
}

For self-hosted: set LNBITS_URL to your instance URL (e.g. https://lnbits.yourdomain.com).

Option C — Strike

Works with a Strike account. Custodial, simple API key setup. Good for US users or anyone who already uses Strike.

1. Create an account at strike.me
2. Go to dashboard.strike.me/developers/api-keys → create an API key

{
  "mcpServers": {
    "boltwork": {
      "command": "uvx",
      "args": ["boltwork-mcp"],
      "env": {
        "STRIKE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Option D — Phoenixd

Works with Phoenixd — ACINQ's self-hosted Lightning node. Simple REST API, no channel management.

Shortened. The full README is on GitHub.