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.

Install

pip install boltwork-mcp

# If using NWC (Nostr Wallet Connect):
pip install "boltwork-mcp[nwc]"

Or use directly with uvx — no install needed:

uvx boltwork-mcp

Setup

1. Get a Lightning wallet

You need a Lightning wallet that supports either:

Option A — NWC (recommended, easiest)

• Alby — browser extension, free, gives you an NWC connection string
• Mutiny Wallet — self-custodial mobile wallet

Option B — Phoenixd

• Phoenixd — self-hosted Lightning node, simple REST API

2. Add to your MCP config

Claude Desktop — edit ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Cursor — edit .cursor/mcp.json in your project:

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

Using Phoenixd instead of NWC:

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

3. Restart your AI and start using tools

That's it. Your agent now has access to all Boltwork tools and will pay invoices automatically when it uses them.

Available tools

Example prompts

Once configured, just talk to your AI naturally:

"Summarise this research paper: https://arxiv.org/pdf/2301.00000"

"Review the code at https://

... [View full README on GitHub](https://github.com/Squidboy30/boltwork-mcp#readme)