Boltwork

io.github.Squidboy30Published by GitHub account Squidboy30v0.1.12Updated Oct 27, 2026

AI services via Bitcoin Lightning — PDF summarisation, code review, translation and more.

VerifiedSTDIODesktop onlyFiles & StorageFinanceAI & ML

Overview

AI-generated overview

Wraps the Boltwork pay-per-call AI services API so an assistant can summarise, review, translate and extract documents, paying each call in Bitcoin sats over…

What you can do
  • Summarise text, PDFs from a URL and web pages
  • Review code from pasted text or a GitHub/GitLab URL, and explain code in plain English
  • Extract structured data and tables from PDFs, translate text or documents, and diff two PDFs
  • Store, retrieve and delete persistent agent memory keys
  • Chain several services together in a single workflow call
  • Two free trial tools (text summary and code review) work without a wallet, rate limited to 5 calls per hour
When to use it
Useful when you want document summarisation, code review, translation or PDF extraction inside an assistant without signing up for API keys or subscriptions, and are willing to fund calls with a Lightning wallet. The free trial tools let you test the service before configuring a wallet.
Requirements
Runs locally as a Python package (pip install boltwork-mcp, or uvx boltwork-mcp); the NWC wallet option needs the nwc extra. A Lightning wallet backend is required for paid tools: NWC_CONNECTION_STRING, or LNbits URL and API key, or a Strike API key, or PHOENIXD_URL plus PHOENIXD_PASSWORD. Network access to the Boltwork API and the wallet service is needed.
Before you install
Paid tools spend real Bitcoin sats automatically, with no confirmation step: listed prices range from 5 sats for memory retrieval to 2000 sats for a code review, and run_workflow costs 1000 sats. Wallet credentials such as NWC_CONNECTION_STRING, LNBITS_API_KEY, STRIKE_API_KEY and PHOENIXD_PASSWORD grant spending access and should be scoped or budgeted where possible. Documents, code and text you submit are sent to the third-party Boltwork API, and memory entries are stored there; memory_delete…

Installation

In SourceWeft

  1. Open Boltwork in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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.

[PyPI] [Python 3.11+] [License: MIT] [API]

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:

json
{  "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

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

Or use directly with uvx — no install needed:

bash
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:
json
{  "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
json
{  "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
json
{  "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
json
{  "mcpServers": {    "boltwork": {      "command": "uvx",      "args": ["boltwork-mcp"],      "env": {        "PHOENIXD_URL": "http://localhost:9740",        "PHOENIXD_PASSWORD": "your-password-here"      }    }  }}

MCP config locations

ClientConfig file
Claude Desktop (macOS)~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop (Windows)%APPDATA%\Claude\claude_desktop_config.json
Cursor.cursor/mcp.json in your project
Windsurf~/.codeium/windsurf/mcp_config.json

Available tools

ToolWhat it doesCost
trial_summariseSummarise text — free trialFree
trial_review_codeReview code — free trialFree
summarise_pdfSummarise a PDF from URL500 sats
summarise_webpageSummarise any web page100 sats
review_codeFull code review with bugs, security, quality2000 sats
review_code_urlReview code from GitHub/GitLab URL2000 sats
extract_dataExtract structured data from PDF200 sats
translateTranslate text or document (24 languages)150 sats
extract_tablesExtract all tables from a PDF300 sats
compare_documentsDiff two PDFs500 sats
explain_codeExplain code in plain English500 sats
memory_storeStore persistent agent memory10 sats
memory_retrieveRetrieve agent memory5 sats
memory_deleteDelete a memory keyFree
run_workflowChain multiple services in one call1000 sats

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

Source: README.md at commit 8d802db

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.12LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.