{
  "markdown": "mcp-name: io.github.Squidboy30/boltwork-mcp\n# boltwork-mcp\n**MCP server for Boltwork — AI services that pay for themselves via Bitcoin Lightning.**\n\nGive 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.\n\n[![PyPI](https://img.shields.io/pypi/v/boltwork-mcp)](https://pypi.org/project/boltwork-mcp/)\n[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![API](https://img.shields.io/badge/API-parsebit.fly.dev-green)](https://parsebit.fly.dev)\n\n---\n\n## What this is\n\n[Boltwork](https://parsebit.fly.dev) is a pay-per-call AI services API that uses the [L402 protocol](https://github.com/lightninglabs/L402) — your agent makes a request, receives a Lightning invoice, pays it automatically, and gets the result back. No human involved.\n\nThis package wraps Boltwork as an [MCP server](https://modelcontextprotocol.io) so any MCP-compatible AI (Claude, Cursor, Windsurf, etc.) can use it as a tool — with payments handled transparently in the background.\n\n---\n\n## Try it immediately — no wallet required\n\nTwo tools work right now with zero setup:\n\n```json\n{\n  \"mcpServers\": {\n    \"boltwork\": {\n      \"command\": \"uvx\",\n      \"args\": [\"boltwork-mcp\"],\n      \"env\": {}\n    }\n  }\n}\n```\n\nThen ask your AI:\n```\n\"Use trial_review_code to review this: def add(a, b): return a + b\"\n\"Use trial_summarise to summarise this: <paste any text>\"\n```\n\nReal AI results instantly. No Lightning wallet. No setup. Rate limited to 5 calls/hour.\n\n---\n\n## Install\n\n```bash\npip install boltwork-mcp\n\n# If using NWC (Alby, Mutiny, Coinos, etc.):\npip install \"boltwork-mcp[nwc]\"\n```\n\nOr use directly with `uvx` — no install needed:\n\n```bash\nuvx boltwork-mcp\n```\n\n---\n\n## Setup — pick a wallet\n\nFour wallet backends are supported. Pick whichever fits your setup:\n\n### Option A — NWC / Nostr Wallet Connect *(easiest)*\nWorks with **Alby**, **Mutiny Wallet**, **Coinos**, **Primal**, **Cashu.me**, and any NWC-compatible wallet.\n\n1. Get a connection string:\n   - **Alby** — go to [nwc.getalby.com](https://nwc.getalby.com), create a budget, copy the string\n   - **Mutiny** — Settings → Connections → Add connection\n   - **Coinos** — [coinos.io](https://coinos.io) → Settings → Nostr Wallet Connect\n2. Add to your MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"boltwork\": {\n      \"command\": \"uvx\",\n      \"args\": [\"boltwork-mcp\"],\n      \"env\": {\n        \"NWC_CONNECTION_STRING\": \"nostr+walletconnect://your-string-here\"\n      }\n    }\n  }\n}\n```\n\nRequires: `pip install \"boltwork-mcp[nwc]\"`\n\n---\n\n### Option B — LNbits\nWorks with **lnbits.com** or any self-hosted LNbits instance. Popular with BTCPay Server users and home node operators.\n\n1. Create a wallet at [lnbits.com](https://lnbits.com) or your instance\n2. Go to API info → copy your Invoice/read key\n\n```json\n{\n  \"mcpServers\": {\n    \"boltwork\": {\n      \"command\": \"uvx\",\n      \"args\": [\"boltwork-mcp\"],\n      \"env\": {\n        \"LNBITS_URL\": \"https://lnbits.com\",\n        \"LNBITS_API_KEY\": \"your-invoice-key-here\"\n      }\n    }\n  }\n}\n```\n\nFor self-hosted: set `LNBITS_URL` to your instance URL (e.g. `https://lnbits.yourdomain.com`).\n\n---\n\n### Option C — Strike\nWorks with a **Strike** account. Custodial, simple API key setup. Good for US users or anyone who already uses Strike.\n\n1. Create an account at [strike.me](https://strike.me)\n2. Go to [dashboard.strike.me/developers/api-keys](https://dashboard.strike.me/developers/api-keys) → create an API key\n\n```json\n{\n  \"mcpServers\": {\n    \"boltwork\": {\n      \"command\": \"uvx\",\n      \"args\": [\"boltwork-mcp\"],\n      \"env\": {\n        \"STRIKE_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n---\n\n### Option D — Phoenixd\nWorks with **Phoenixd** — ACINQ's self-hosted Lightning node. Simple REST API, no channel management.\n\n1. Install Phoenixd: [phoenix.acinq.co/server](https://phoenix.acinq.co/server)\n2. Get your HTTP password from the Phoenixd config\n\n```json\n{\n  \"mcpServers\": {\n    \"boltwork\": {\n      \"command\": \"uvx\",\n      \"args\": [\"boltwork-mcp\"],\n      \"env\": {\n        \"PHOENIXD_URL\": \"http://localhost:9740\",\n        \"PHOENIXD_PASSWORD\": \"your-password-here\"\n      }\n    }\n  }\n}\n```\n\n---\n\n## MCP config locations\n\n| Client | Config file |\n|--------|------------|\n| Claude Desktop (macOS) | `~/Library/Application Support/Claude/claude_desktop_config.json` |\n| Claude Desktop (Windows) | `%APPDATA%\\Claude\\claude_desktop_config.json` |\n| Cursor | `.cursor/mcp.json` in your project |\n| Windsurf | `~/.codeium/windsurf/mcp_config.json` |\n\n---\n\n## Available tools\n\n| Tool | What it does | Cost |\n|------|-------------|------|\n| `trial_summarise` | Summarise text — free trial | Free |\n| `trial_review_code` | Review code — free trial | Free |\n| `summarise_pdf` | Summarise a PDF from URL | 500 sats |\n| `summarise_webpage` | Summarise any web page | 100 sats |\n| `review_code` | Full code review with bugs, security, quality | 2000 sats |\n| `review_code_url` | Review code from GitHub/GitLab URL | 2000 sats |\n| `extract_data` | Extract structured data from PDF | 200 sats |\n| `translate` | Translate text or document (24 languages) | 150 sats |\n| `extract_tables` | Extract all tables from a PDF | 300 sats |\n| `compare_documents` | Diff two PDFs | 500 sats |\n| `explain_code` | Explain code in plain English | 500 sats |\n| `memory_store` | Store persistent agent memory | 10 sats |\n| `memory_retrieve` | Retrieve agent memory | 5 sats |\n| `memory_delete` | Delete a memory key | Free |\n| `run_workflow` | Chain multiple services in one call | 1000 sats |\n\n---\n\n## Payment flow\n\nWhen your agent calls a paid tool:\n\n1. boltwork-mcp calls the Boltwork API\n2. Receives HTTP 402 with a Lightning invoice\n3. Pays the invoice automatically using your configured wallet\n4. Retries the request with the payment proof\n5. Returns the result to your agent\n\nYour agent never sees this — it just gets the result.\n\n---\n\n## Links\n\n- [Boltwork API](https://parsebit.fly.dev) — live API\n- [Agent spec](https://parsebit.fly.dev/agent-spec.md) — full endpoint documentation\n- [L402 manifest](https://parsebit.fly.dev/.well-known/l402.json) — machine-readable service discovery\n- [Cracked Minds](https://crackedminds.co.uk) — by Cracked Minds\n",
  "bytes": 6375,
  "sha": "c457871680761e15ab43c776c517e9fb3dca2bd3c6a276a6faca121e511ed75e",
  "repo_slug": "squidboy30/boltwork-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_squidboy30_boltwork_mcp_87442b59/readme"
}