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
2. 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.

1. Install Phoenixd: phoenix.acinq.co/server
2. Get your HTTP password from the Phoenixd config

{
  "mcpServers": {
    "boltwork": {
      "command": "uvx",
      "args": ["boltwork-mcp"],
      "env": {
        "PHOENIXD_URL": "http://localhost:9740",
        "PHOENIXD_PASSWORD": "your-password-here"
      }
    }
  }
}

---

MCP config locations

---

Available tools

---

Payment flow

When your agent calls a paid tool:

1. boltwork-mcp calls the Boltwork API
2. Receives HTTP 402 with a Lightning invoice
3. Pays the invoice automatically using your configured wallet
4. Retries the request with the payment proof
5. Returns the result to your agent

Your agent never sees this — it just gets the result.

---

Links

• Boltwork API — live API
• Agent spec — full endpoint documentation
• L402 manifest — machine-readable service discovery
• Cracked Minds — by Cracked Minds