{"_id":"@bolthub/mcp-bridge","_rev":"11-c921c04735796bc22426b39a576ce3fa","name":"@bolthub/mcp-bridge","dist-tags":{"latest":"0.1.6"},"versions":{"0.1.0":{"name":"@bolthub/mcp-bridge","version":"0.1.0","keywords":["mcp","l402","lightning","bitcoin","ai-agent","paywall","model-context-protocol"],"license":"MIT","_id":"@bolthub/mcp-bridge@0.1.0","maintainers":[{"name":"bolthub.ai","email":"contact@bolthub.ai"}],"homepage":"https://github.com/signaltech-org/bolthub.ai#readme","bugs":{"url":"https://github.com/signaltech-org/bolthub.ai/issues"},"bin":{"mcp-bridge":"dist/index.js"},"dist":{"shasum":"589c8986621c881812ef140c58e294409f8f2289","tarball":"https://registry.npmjs.org/@bolthub/mcp-bridge/-/mcp-bridge-0.1.0.tgz","fileCount":3,"integrity":"sha512-PsE3fPpqHEeL89pMPz69WqzewLluvTmnaoxb6O+Sp2OE4eeQX1sAaLxhoPtfX94Kz3YBQFiIeCs+zKPNpQKOuA==","signatures":[{"sig":"MEQCIHs87pVjPUvR367LFt9pMtM9wI/o36xph4rmemruw9G4AiAczEy97Wsw1vLtSuRjBHDfUWDklvlXXjwLQ58H1tUq1A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":834940},"main":"dist/index.js","type":"module","gitHead":"f2323dd7a6e7c8dbe115ce251ccf3543c3fce927","scripts":{"dev":"bun run src/index.ts","test":"bun test","build":"bun build src/index.ts --outdir dist --target node --format esm","prepublishOnly":"bun run build"},"_npmUser":{"name":"bolthub.ai","email":"contact@bolthub.ai"},"deprecated":"Replaced by @bolthub/mcp — use npx -y @bolthub/mcp --gateway <url>. Migration: https://github.com/signaltech-org/bolthub-sdk/tree/main/packages/mcp#migrating-from-bolthubmcp-registry--bolthubmcp-bridge","repository":{"url":"git+https://github.com/signaltech-org/bolthub.ai.git","type":"git","directory":"packages/mcp-bridge"},"_npmVersion":"10.9.7","description":"MCP server bridge for bolthub L402 paywalled APIs — turns gateway endpoints into MCP tools with automatic Lightning payment","directories":{},"_nodeVersion":"22.22.2","dependencies":{"zod":"^3","@bolthub/agent":"workspace:*","@bolthub/shared":"workspace:*","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-bridge_0.1.0_1778828368814_0.9837303133933888","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@bolthub/mcp-bridge","version":"0.1.1","keywords":["mcp","l402","lightning","bitcoin","ai-agent","paywall","model-context-protocol"],"license":"MIT","_id":"@bolthub/mcp-bridge@0.1.1","maintainers":[{"name":"bolthub.ai","email":"contact@bolthub.ai"}],"homepage":"https://github.com/signaltech-org/bolthub.ai#readme","bugs":{"url":"https://github.com/signaltech-org/bolthub.ai/issues"},"bin":{"mcp-bridge":"dist/index.js"},"dist":{"shasum":"7f0cb5ca21014d7dcb105bdac04f048ee5c3c6e7","tarball":"https://registry.npmjs.org/@bolthub/mcp-bridge/-/mcp-bridge-0.1.1.tgz","fileCount":3,"integrity":"sha512-rqjkv0NIl5K+xKwEqI3zP5rco81TI2uzxk8JbfRLw6eZqsRLpEq6LF+mlXZuQ8Vf5O2Pfoj54XArqpPJSWTR5A==","signatures":[{"sig":"MEUCIF4CcJ4AExe0vzPaiQVsnZBpWIsqGb11MxRp3I7kt7DWAiEA+c2XfCWXDf4uZb1jP2CZZg4MrlK+Jlyc8ukMbWtiQ4c=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":834872},"main":"dist/index.js","type":"module","gitHead":"963154d95e030f975cac40012ef9e96c37f6760c","scripts":{"dev":"bun run src/index.ts","test":"bun test","build":"bun build src/index.ts --outdir dist --target node --format esm","prepublishOnly":"bun run build"},"_npmUser":{"name":"bolthub.ai","email":"contact@bolthub.ai"},"deprecated":"Replaced by @bolthub/mcp — use npx -y @bolthub/mcp --gateway <url>. Migration: https://github.com/signaltech-org/bolthub-sdk/tree/main/packages/mcp#migrating-from-bolthubmcp-registry--bolthubmcp-bridge","repository":{"url":"git+https://github.com/signaltech-org/bolthub.ai.git","type":"git","directory":"packages/mcp-bridge"},"_npmVersion":"10.9.7","description":"MCP server bridge for bolthub L402 paywalled APIs — turns gateway endpoints into MCP tools with automatic Lightning payment","directories":{},"_nodeVersion":"22.22.2","dependencies":{"zod":"^3","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-bridge_0.1.1_1778829426237_0.3560505236421416","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@bolthub/mcp-bridge","version":"0.1.2","keywords":["mcp","l402","lightning","bitcoin","ai-agent","paywall","model-context-protocol"],"license":"MIT","_id":"@bolthub/mcp-bridge@0.1.2","maintainers":[{"name":"bolthub.ai","email":"contact@bolthub.ai"}],"homepage":"https://github.com/signaltech-org/bolthub.ai#readme","bugs":{"url":"https://github.com/signaltech-org/bolthub.ai/issues"},"bin":{"mcp-bridge":"dist/index.js"},"dist":{"shasum":"2733d78b8b93e177d834510f153ca944164f3634","tarball":"https://registry.npmjs.org/@bolthub/mcp-bridge/-/mcp-bridge-0.1.2.tgz","fileCount":3,"integrity":"sha512-nHrynKpCuVL39f2VvBfMSlpxXW1mAhPuqNIgN8XR+fmK133tR6SIJTPF4LWfSz0rG29hH8e6bZc0zXLxa8H6Zw==","signatures":[{"sig":"MEUCIHYu/8sFDn098giz1R5ZG2aoyxhmWdYkErrFQ18ktVOhAiEAmdXDag9ywq2QzxuDMcS/Rcbv/AkX1l0qkIWoArGXY0o=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":835845},"main":"dist/index.js","type":"module","gitHead":"08e39312ea232f6e479bfad8c8aef5947e08abd2","scripts":{"dev":"bun run src/index.ts","test":"bun test","build":"bun build src/index.ts --outdir dist --target node --format esm","prepublishOnly":"bun run build"},"_npmUser":{"name":"bolthub.ai","email":"contact@bolthub.ai"},"deprecated":"Replaced by @bolthub/mcp — use npx -y @bolthub/mcp --gateway <url>. Migration: https://github.com/signaltech-org/bolthub-sdk/tree/main/packages/mcp#migrating-from-bolthubmcp-registry--bolthubmcp-bridge","repository":{"url":"git+https://github.com/signaltech-org/bolthub.ai.git","type":"git","directory":"packages/mcp-bridge"},"_npmVersion":"10.9.7","description":"MCP server bridge for bolthub L402 paywalled APIs — turns gateway endpoints into MCP tools with automatic Lightning payment","directories":{},"_nodeVersion":"22.22.2","dependencies":{},"_hasShrinkwrap":false,"devDependencies":{"zod":"^3","@modelcontextprotocol/sdk":"^1.12.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-bridge_0.1.2_1778831354498_0.547411917168181","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@bolthub/mcp-bridge","version":"0.1.3","keywords":["mcp","l402","lightning","bitcoin","ai-agent","paywall","model-context-protocol"],"license":"MIT","_id":"@bolthub/mcp-bridge@0.1.3","maintainers":[{"name":"bolthub.ai","email":"contact@bolthub.ai"}],"homepage":"https://docs.bolthub.ai/docs/sdks/mcp-bridge","bugs":{"url":"https://github.com/signaltech-org/bolthub-sdk/issues"},"bin":{"mcp-bridge":"dist/index.js"},"dist":{"shasum":"214f88224c232a52f0ab412d13a455cf6bd2d956","tarball":"https://registry.npmjs.org/@bolthub/mcp-bridge/-/mcp-bridge-0.1.3.tgz","fileCount":4,"integrity":"sha512-xI1I+/hJCVcN2hH8zzS5v//oWhVU3p6SqgDYLGTEcO6z+X4OTDO5+HiaviIgI51RbHAMm8r7l9D1TmN2COk+tA==","signatures":[{"sig":"MEUCIQDOOCrCEMpUjrkdgaBtaLmblKsGYTdk8fh6osIii7GXyQIgSmakl/rYh5Hb1Reh2kOzcnXwoVwLTfMe9sDmxR1IxvA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bolthub%2fmcp-bridge@0.1.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":2233060},"main":"dist/index.js","type":"module","gitHead":"2c200f6319c2f8b7c3a3379e6c525a9eb9ab7534","scripts":{"dev":"bun run src/index.ts","test":"bun test","build":"bun build src/index.ts --outdir dist --target node --format esm --sourcemap=linked","prepublishOnly":"bun run build"},"_npmUser":{"name":"bolthub.ai","email":"contact@bolthub.ai"},"repository":{"url":"git+https://github.com/signaltech-org/bolthub-sdk.git","type":"git","directory":"packages/mcp-bridge"},"_npmVersion":"10.9.8","description":"MCP server bridge for bolthub L402 paywalled APIs — turns gateway endpoints into MCP tools with automatic Lightning payment","directories":{},"_nodeVersion":"22.22.3","dependencies":{},"_hasShrinkwrap":false,"devDependencies":{"zod":"^3","@modelcontextprotocol/sdk":"^1.12.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-bridge_0.1.3_1781075615293_0.6999884920084383","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Replaced by @bolthub/mcp — use npx -y @bolthub/mcp --gateway <url>. Migration: https://github.com/signaltech-org/bolthub-sdk/tree/main/packages/mcp#migrating-from-bolthubmcp-registry--bolthubmcp-bridge"},"0.1.4":{"name":"@bolthub/mcp-bridge","version":"0.1.4","keywords":["mcp","l402","lightning","bitcoin","ai-agent","paywall","model-context-protocol"],"license":"MIT","_id":"@bolthub/mcp-bridge@0.1.4","maintainers":[{"name":"bolthub.ai","email":"contact@bolthub.ai"}],"homepage":"https://docs.bolthub.ai/docs/sdks/mcp-bridge","bugs":{"url":"https://github.com/signaltech-org/bolthub-sdk/issues"},"bin":{"mcp-bridge":"dist/index.js"},"dist":{"shasum":"1d7930444de2f2b5ad6ba60fe754c0308db2e1aa","tarball":"https://registry.npmjs.org/@bolthub/mcp-bridge/-/mcp-bridge-0.1.4.tgz","fileCount":4,"integrity":"sha512-BrBdShgzjE8dLKryjrj+FQ247mFPLrNJZX1tr430sI9xJfVlr/r87m2syl9KGTeguqJ5cWi4BwSunuqs4yTnFA==","signatures":[{"sig":"MEQCICQFzrtsJTbwyLPFfkVm3Tosx9FdI2WgJ+9/wwrfLaoRAiBVqxIomKzEXxoZtLMLo0NwiWb8rK4mNychtTjjthJaYg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bolthub%2fmcp-bridge@0.1.4","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":3205663},"main":"dist/index.js","type":"module","gitHead":"ff069dc3c23df292fde2a95a5444d509c62f3f30","scripts":{"dev":"bun run src/index.ts","test":"bun test","build":"bun build src/index.ts --outdir dist --target node --format esm --sourcemap=linked","prepublishOnly":"bun run build"},"_npmUser":{"name":"bolthub.ai","email":"contact@bolthub.ai"},"repository":{"url":"git+https://github.com/signaltech-org/bolthub-sdk.git","type":"git","directory":"packages/mcp-bridge"},"_npmVersion":"10.9.8","description":"MCP server bridge for bolthub L402 paywalled APIs — turns gateway endpoints into MCP tools with automatic Lightning payment","directories":{},"_nodeVersion":"22.22.3","dependencies":{"@getalby/sdk":"^8.0.3"},"_hasShrinkwrap":false,"devDependencies":{"zod":"^3","@modelcontextprotocol/sdk":"^1.12.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-bridge_0.1.4_1781093129574_0.7698912493376293","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Replaced by @bolthub/mcp — use npx -y @bolthub/mcp --gateway <url>. Migration: https://github.com/signaltech-org/bolthub-sdk/tree/main/packages/mcp#migrating-from-bolthubmcp-registry--bolthubmcp-bridge"},"0.1.5":{"name":"@bolthub/mcp-bridge","version":"0.1.5","keywords":["mcp","l402","lightning","bitcoin","ai-agent","paywall","model-context-protocol"],"license":"MIT","_id":"@bolthub/mcp-bridge@0.1.5","maintainers":[{"name":"bolthub.ai","email":"contact@bolthub.ai"}],"homepage":"https://docs.bolthub.ai/docs/sdks/mcp-bridge","bugs":{"url":"https://github.com/signaltech-org/bolthub-sdk/issues"},"bin":{"mcp-bridge":"dist/index.js"},"dist":{"shasum":"d4923ae1a8a40c5ea43e7b33449c84bd71d52429","tarball":"https://registry.npmjs.org/@bolthub/mcp-bridge/-/mcp-bridge-0.1.5.tgz","fileCount":4,"integrity":"sha512-UwoCEn+Li5S2pL34Z++VUyJuqFRT5sNUxCFjxixaNZ+6k0Z9wiQUEfzeGRgHF77pY7J5tKCCSA4bbHCld2Uypg==","signatures":[{"sig":"MEYCIQCydWyqiMNgC4vLkWwMD4LOUPLUVGmnl+eXXQ61Vet/XwIhAMu+GyH9bhpJN6pQeG90OSiWFSbivFCKr7r5WPrW7tOW","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bolthub%2fmcp-bridge@0.1.5","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":3206688},"main":"dist/index.js","type":"module","gitHead":"45757d84b803c659344e6706e50384c582caba46","scripts":{"dev":"bun run src/index.ts","test":"bun test","build":"bun build src/index.ts --outdir dist --target node --format esm --sourcemap=linked","prepublishOnly":"bun run build"},"_npmUser":{"name":"bolthub.ai","email":"contact@bolthub.ai"},"repository":{"url":"git+https://github.com/signaltech-org/bolthub-sdk.git","type":"git","directory":"packages/mcp-bridge"},"_npmVersion":"10.9.8","description":"MCP server bridge for bolthub L402 paywalled APIs — turns gateway endpoints into MCP tools with automatic Lightning payment","directories":{},"_nodeVersion":"22.22.3","dependencies":{"@getalby/sdk":"^8.0.3"},"_hasShrinkwrap":false,"devDependencies":{"zod":"^3","@modelcontextprotocol/sdk":"^1.12.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-bridge_0.1.5_1781231986552_0.902909804348577","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Replaced by @bolthub/mcp — use npx -y @bolthub/mcp --gateway <url>. Migration: https://github.com/signaltech-org/bolthub-sdk/tree/main/packages/mcp#migrating-from-bolthubmcp-registry--bolthubmcp-bridge"},"0.1.6":{"name":"@bolthub/mcp-bridge","version":"0.1.6","keywords":["mcp","l402","lightning","bitcoin","ai-agent","paywall","model-context-protocol"],"license":"MIT","_id":"@bolthub/mcp-bridge@0.1.6","maintainers":[{"name":"bolthub.ai","email":"contact@bolthub.ai"}],"homepage":"https://docs.bolthub.ai/docs/sdks/mcp-bridge","bugs":{"url":"https://github.com/signaltech-org/bolthub-sdk/issues"},"bin":{"mcp-bridge":"dist/index.js"},"dist":{"shasum":"ea212239363dcf87a5e9ee7f3ef23713ca5909d8","tarball":"https://registry.npmjs.org/@bolthub/mcp-bridge/-/mcp-bridge-0.1.6.tgz","fileCount":4,"integrity":"sha512-7ZgjgF08xyuVdpKuI61R4QsQAlnBqOaD63YZRLz9OBS15TMfRF1o2BDVwPB3CfZJ7GbRSK8JfcMAQxiNTGFNUA==","signatures":[{"sig":"MEYCIQDhlsmUlaZWoLFnHlig76WrjoMjwUjz3dn8sT/saV+TCQIhANzb1zbXRHAWkhOXmOvDWsDBk5lqw3Iz7Qpyz0eMvZTt","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bolthub%2fmcp-bridge@0.1.6","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":3207945},"main":"dist/index.js","type":"module","gitHead":"da81efaaaeb7f371cfe0bb65133308c7e6c0554b","scripts":{"dev":"bun run src/index.ts","test":"bun test","build":"bun build src/index.ts --outdir dist --target node --format esm --sourcemap=linked","prepublishOnly":"bun run build"},"_npmUser":{"name":"bolthub.ai","email":"contact@bolthub.ai"},"repository":{"url":"git+https://github.com/signaltech-org/bolthub-sdk.git","type":"git","directory":"packages/mcp-bridge"},"_npmVersion":"10.9.8","description":"MCP server bridge for bolthub L402 paywalled APIs — turns gateway endpoints into MCP tools with automatic Lightning payment","directories":{},"_nodeVersion":"22.22.3","dependencies":{"@getalby/sdk":"^8.0.3"},"_hasShrinkwrap":false,"devDependencies":{"zod":"^3","@modelcontextprotocol/sdk":"^1.12.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-bridge_0.1.6_1781237933784_0.8025200571345665","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Replaced by @bolthub/mcp — use npx -y @bolthub/mcp --gateway <url>. Migration: https://github.com/signaltech-org/bolthub-sdk/tree/main/packages/mcp#migrating-from-bolthubmcp-registry--bolthubmcp-bridge"}},"time":{"created":"2026-05-15T06:59:28.708Z","modified":"2026-07-07T01:08:33.624Z","0.1.0":"2026-05-15T06:59:28.974Z","0.1.1":"2026-05-15T07:17:06.420Z","0.1.2":"2026-05-15T07:49:14.773Z","0.1.3":"2026-06-10T07:13:35.508Z","0.1.4":"2026-06-10T12:05:29.798Z","0.1.5":"2026-06-12T02:39:46.767Z","0.1.6":"2026-06-12T04:18:53.927Z"},"bugs":{"url":"https://github.com/signaltech-org/bolthub-sdk/issues"},"license":"MIT","homepage":"https://docs.bolthub.ai/docs/sdks/mcp-bridge","keywords":["mcp","l402","lightning","bitcoin","ai-agent","paywall","model-context-protocol"],"repository":{"url":"git+https://github.com/signaltech-org/bolthub-sdk.git","type":"git","directory":"packages/mcp-bridge"},"description":"MCP server bridge for bolthub L402 paywalled APIs — turns gateway endpoints into MCP tools with automatic Lightning payment","maintainers":[{"name":"bolthub.ai","email":"contact@bolthub.ai"}],"readme":"# @bolthub/mcp-bridge\n\nMCP (Model Context Protocol) server that bridges AI agents to bolthub L402 paywalled APIs. It auto-discovers endpoints from a gateway's OpenAPI spec and handles Lightning payments transparently.\n\nSource: [signaltech-org/bolthub-sdk](https://github.com/signaltech-org/bolthub-sdk) · Docs: [docs.bolthub.ai](https://docs.bolthub.ai/docs/sdks/mcp-bridge)\n\n## Install\n\n```bash\nnpm install -g @bolthub/mcp-bridge\n```\n\nOr use directly with `npx`:\n\n```bash\nnpx @bolthub/mcp-bridge --gateway https://pokemon.gw.bolthub.ai\n```\n\n## Configuration\n\nAdd to your MCP client config (Cursor, Claude Desktop, OpenClaw, etc.):\n\n```json\n{\n  \"mcpServers\": {\n    \"pokemon-api\": {\n      \"command\": \"npx\",\n      \"args\": [\"@bolthub/mcp-bridge\", \"--gateway\", \"https://pokemon.gw.bolthub.ai\"],\n      \"env\": {\n        \"NWC_URI\": \"<your-nwc-connection-string>\"\n      }\n    }\n  }\n}\n```\n\n### Environment Variables\n\nThe bridge supports multiple wallet types. You only need **one**.\n\n| Variable | Description |\n|----------|-------------|\n| `LND_REST_HOST` | **Recommended.** LND REST API URL (e.g. from the bolthub Node Launcher or `https://your-node:8080`). Fast (<200ms), self-hosted, full control. Use a pay-scoped macaroon in production. |\n| `LND_MACAROON` | Hex-encoded macaroon for LND. Required when using `LND_REST_HOST`. |\n| `NWC_URI` | **Recommended for easy setup.** Works with any NWC-compatible wallet: CoinOS (free), Alby Hub, Zeus, Primal, and more. Slower (1-3s) but no node required. |\n| `LNBITS_URL` | LNbits instance URL. Fast (<300ms). Accounts system built on any Lightning funding source. Use if you already run LNbits. |\n| `LNBITS_ADMIN_KEY` | Admin API key for LNbits. Required when using `LNBITS_URL`. |\n| `PHOENIXD_URL` | Phoenixd HTTP API URL. Supported if you already run Phoenixd for outbound payments. |\n| `PHOENIXD_PASSWORD` | HTTP password for Phoenixd. Required when using `PHOENIXD_URL`. |\n| `BUDGET_SATS` | Optional. Maximum sats the MCP can spend per session. When exceeded, API calls are refused. Unset = unlimited. |\n\n**Priority order:** If multiple wallet types are configured, the bridge uses the first available: LND > NWC > LNbits > Phoenixd.\n\n### Which wallet should I use?\n\n- **Default for production / self-hosted nodes:** LND via the bolthub **Node Launcher**, or your own LND (self-hosted or via [Umbrel](https://umbrel.com)) with a pay-scoped macaroon. Fastest and most reliable.\n- **Just getting started without a node?** Use NWC with any compatible wallet like [CoinOS](https://coinos.io) (free) or [Alby Hub](https://getalby.com). Easiest to set up but slower (1-3s).\n\n### Spending budget\n\nSet `BUDGET_SATS` to cap total spending per session, or use `--budget`:\n\n```bash\nnpx @bolthub/mcp-bridge --gateway https://pokemon.gw.bolthub.ai --budget 1000\n```\n\nGuidance: `100–500` for testing, `1000–5000` for daily dev, `10000+` for production. Unset = no limit.\n\n## Alternatives\n\nThis bridge is one way to give agents L402 payment capabilities. There are also third-party MCPs that handle Lightning payments:\n\n- **[Alby MCP](https://getalby.com/blog/alby-bitcoin-payments-mcp-server)** -- Recommended for most users. Uses NWC under the hood. Works with any Alby Hub or CoinOS wallet.\n- **[Fewsats MCP](https://github.com/Fewsats/fewsats-mcp)** -- Zero-config custodial option. Single API key, no Lightning node needed.\n\nFor more options, see the [Start Earning guide](https://bolthub.ai/start-earning).\n\n## How it works\n\n1. On startup, fetches the gateway's OpenAPI spec from `/.well-known/openapi.json`\n2. Converts each API endpoint into an MCP tool with proper `inputSchema`\n3. When an agent calls a tool, makes the HTTP request to the gateway\n4. If the gateway returns 402 (Payment Required), automatically pays the Lightning invoice and retries\n5. Returns the API response to the agent\n\n## SDKs\n\nFor building custom agents without MCP, use our SDKs directly:\n\n- **TypeScript:** `npm install @bolthub/agent`\n- **Python:** `pip install bolthub`\n\n## Security & trust\n\nThis package handles your Lightning wallet credentials, so here is exactly what it does with them:\n\n- **Your credentials never reach bolthub.** Wallet secrets (`LND_MACAROON`, `NWC_URI`, `LNBITS_ADMIN_KEY`, `PHOENIXD_PASSWORD`) are read from env vars and passed only to the matching wallet adapter, which talks to the wallet *you* configured. They are never sent to bolthub servers, never persisted, and never logged.\n- **Endpoints contacted**: the gateway you pass via `--gateway` and your configured wallet. Nothing else — no telemetry or analytics.\n- **Local state**: paid L402 session tokens (not credentials) are cached in `~/.bolthub/sessions.json` with `0600` permissions, so an already-paid session is reused instead of paying again.\n- **Spend control**: `BUDGET_SATS` caps spending per server process (restarting your MCP client starts a fresh session and resets the cap). Use a pay-scoped macaroon or a small dedicated wallet for defense in depth.\n- **Auditable source & provenance**: the full source lives at [signaltech-org/bolthub-sdk](https://github.com/signaltech-org/bolthub-sdk) (`packages/mcp-bridge`). The published `dist/index.js` is bundled from it with Bun, has zero runtime npm dependencies, and ships a source map with embedded sources. Releases are published from that repo's CI with [npm provenance](https://docs.npmjs.com/generating-provenance-statements) — verify with `npm audit signatures`.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}