{"_id":"@bolthub/mcp-registry","_rev":"11-850fcce528d9d899f547b8f569baea93","name":"@bolthub/mcp-registry","dist-tags":{"latest":"0.1.6"},"versions":{"0.1.0":{"name":"@bolthub/mcp-registry","version":"0.1.0","keywords":["mcp","l402","lightning","bitcoin","ai-agent","api-marketplace","model-context-protocol","registry"],"license":"MIT","_id":"@bolthub/mcp-registry@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-registry":"dist/index.js"},"dist":{"shasum":"bbf0403ba03255521e7940a0c79afa12c8cadc2a","tarball":"https://registry.npmjs.org/@bolthub/mcp-registry/-/mcp-registry-0.1.0.tgz","fileCount":3,"integrity":"sha512-tdYHZXLZSQPudq3M5fu22v9XTIHpBZSdMjPUiuNVc7veP6jug9fF0gDAe6Okp07N3Gq1VIGbnpZrtbxcE/DVgQ==","signatures":[{"sig":"MEYCIQCm/mQNqStNnm+CnHicxQc55oXb1qXq59Qy09thU/M1WQIhAPsaGMKO8maxHh9IdUEPWTB8AZLDhJhFbF3LQfHns9t3","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":833713},"main":"dist/index.js","type":"module","gitHead":"a11d9dea972ec413d46db4ad688da9b43e5c48e3","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 — npx -y @bolthub/mcp is a drop-in (zero config = marketplace mode). 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-registry"},"_npmVersion":"10.9.7","description":"MCP server that gives AI agents access to every API on the bolthub marketplace — search, discover, and call any L402 endpoint with one config","directories":{},"_nodeVersion":"22.22.2","dependencies":{"zod":"^3","@bolthub/agent":"workspace:*","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-registry_0.1.0_1778827855240_0.8008296567664348","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@bolthub/mcp-registry","version":"0.1.1","keywords":["mcp","l402","lightning","bitcoin","ai-agent","api-marketplace","model-context-protocol","registry"],"license":"MIT","_id":"@bolthub/mcp-registry@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-registry":"dist/index.js"},"dist":{"shasum":"95b0f13d27703818265850eb5866aa450de7cecf","tarball":"https://registry.npmjs.org/@bolthub/mcp-registry/-/mcp-registry-0.1.1.tgz","fileCount":3,"integrity":"sha512-mF4IjsRWqJM2qXxcpBpk8Kdb+zI7GK0BukIfMS9SbXyICI0ckxCqCT5eDpg9YgYOUEPWeK1dfqmOMoifs89MGg==","signatures":[{"sig":"MEQCIF/XCeIxTm56z3Kqfxz8v7UKt+hPUFLIuuFc5qcZ76KwAiA0TLo6L+A+4Ja1lcB8DcjFXXJPSP9VViP4eHX5VSToxw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":833675},"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 — npx -y @bolthub/mcp is a drop-in (zero config = marketplace mode). 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-registry"},"_npmVersion":"10.9.7","description":"MCP server that gives AI agents access to every API on the bolthub marketplace — search, discover, and call any L402 endpoint with one config","directories":{},"_nodeVersion":"22.22.2","dependencies":{"zod":"^3","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-registry_0.1.1_1778829426014_0.630037152924207","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@bolthub/mcp-registry","version":"0.1.2","keywords":["mcp","l402","lightning","bitcoin","ai-agent","api-marketplace","model-context-protocol","registry"],"license":"MIT","_id":"@bolthub/mcp-registry@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-registry":"dist/index.js"},"dist":{"shasum":"3088a032c127d9048a9c0d2992f8755e1fe48dc4","tarball":"https://registry.npmjs.org/@bolthub/mcp-registry/-/mcp-registry-0.1.2.tgz","fileCount":3,"integrity":"sha512-3U//rRrsNBv4juuDrDWzJfkKTgCwZ/79YX+C+BCVP0sPMazt1Kz0AS6Ur4syACEWEI+1VRHE+H7vynEWHWSrug==","signatures":[{"sig":"MEYCIQCWF3buoRcjvWXKeq6ciZIX16mkg5+jJPkuIN9rErFPrgIhAPSN2Urqx8omA1VwGN8rF1NUNd0fIR94kxBykzgGa0Xa","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":834697},"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 — npx -y @bolthub/mcp is a drop-in (zero config = marketplace mode). 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-registry"},"_npmVersion":"10.9.7","description":"MCP server that gives AI agents access to every API on the bolthub marketplace — search, discover, and call any L402 endpoint with one config","directories":{},"_nodeVersion":"22.22.2","dependencies":{},"_hasShrinkwrap":false,"devDependencies":{"zod":"^3","@modelcontextprotocol/sdk":"^1.12.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-registry_0.1.2_1778831362019_0.0980546939859237","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@bolthub/mcp-registry","version":"0.1.3","keywords":["mcp","l402","lightning","bitcoin","ai-agent","api-marketplace","model-context-protocol","registry"],"license":"MIT","_id":"@bolthub/mcp-registry@0.1.3","maintainers":[{"name":"bolthub.ai","email":"contact@bolthub.ai"}],"homepage":"https://docs.bolthub.ai/docs/sdks/mcp-registry","bugs":{"url":"https://github.com/signaltech-org/bolthub-sdk/issues"},"bin":{"mcp-registry":"dist/index.js"},"dist":{"shasum":"f7e9b449f0e0b88ff0ab8b3eaa83ed0dd5e37822","tarball":"https://registry.npmjs.org/@bolthub/mcp-registry/-/mcp-registry-0.1.3.tgz","fileCount":4,"integrity":"sha512-560fO7GhZKn9wIXWzeOE9UPQ3LTSmg/MTAPC8NxeGImF+yAHxn4wQy3uitJ7SRS5rbcnQS7Zq+PdNYIBi0oIdA==","signatures":[{"sig":"MEYCIQDij9zQ3p6R5cro+1zQIrHpr4kYwH5B5EyAl8hst7SVOgIhAPoHsvieVwDE3cDBaDP5LiGU2zuk6jRu2DGT7S9xBZ4H","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bolthub%2fmcp-registry@0.1.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":2222279},"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-registry"},"_npmVersion":"10.9.8","description":"MCP server that gives AI agents access to every API on the bolthub marketplace — search, discover, and call any L402 endpoint with one config","directories":{},"_nodeVersion":"22.22.3","dependencies":{},"_hasShrinkwrap":false,"devDependencies":{"zod":"^3","@modelcontextprotocol/sdk":"^1.12.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-registry_0.1.3_1781075617206_0.22090320236719752","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Replaced by @bolthub/mcp — npx -y @bolthub/mcp is a drop-in (zero config = marketplace mode). Migration: https://github.com/signaltech-org/bolthub-sdk/tree/main/packages/mcp#migrating-from-bolthubmcp-registry--bolthubmcp-bridge"},"0.1.4":{"name":"@bolthub/mcp-registry","version":"0.1.4","keywords":["mcp","l402","lightning","bitcoin","ai-agent","api-marketplace","model-context-protocol","registry"],"license":"MIT","_id":"@bolthub/mcp-registry@0.1.4","maintainers":[{"name":"bolthub.ai","email":"contact@bolthub.ai"}],"homepage":"https://docs.bolthub.ai/docs/sdks/mcp-registry","bugs":{"url":"https://github.com/signaltech-org/bolthub-sdk/issues"},"bin":{"mcp-registry":"dist/index.js"},"dist":{"shasum":"f340ff12fbfa12107bb47ea4317aa7f049c8c92e","tarball":"https://registry.npmjs.org/@bolthub/mcp-registry/-/mcp-registry-0.1.4.tgz","fileCount":4,"integrity":"sha512-6BrgjgvRJpiMEHw+pLtH9LV/DTCLXQQitkQy/0s6dxUdWxPU5lbmKe+RYEXjlO4D8OrnwZIUDA46JdoCnRrNKg==","signatures":[{"sig":"MEYCIQDl70ljSNvznj9Mbx3FhBggJusvj7n4yHXxF854X71OjQIhAKtx8EJ+47bDHyyhKG7xX1awsHqBo6m+QHXM2siS+/3s","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bolthub%2fmcp-registry@0.1.4","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":3194952},"main":"dist/index.js","type":"module","gitHead":"0abfa25844abeb3c356a3f2ad423fd8ea4cf8e59","mcpName":"ai.bolthub/registry","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-registry"},"_npmVersion":"10.9.8","description":"MCP server that gives AI agents access to every API on the bolthub marketplace — search, discover, and call any L402 endpoint with one config","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-registry_0.1.4_1781091340417_0.6518033010880444","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Replaced by @bolthub/mcp — npx -y @bolthub/mcp is a drop-in (zero config = marketplace mode). Migration: https://github.com/signaltech-org/bolthub-sdk/tree/main/packages/mcp#migrating-from-bolthubmcp-registry--bolthubmcp-bridge"},"0.1.5":{"name":"@bolthub/mcp-registry","version":"0.1.5","keywords":["mcp","l402","lightning","bitcoin","ai-agent","api-marketplace","model-context-protocol","registry"],"license":"MIT","_id":"@bolthub/mcp-registry@0.1.5","maintainers":[{"name":"bolthub.ai","email":"contact@bolthub.ai"}],"homepage":"https://docs.bolthub.ai/docs/sdks/mcp-registry","bugs":{"url":"https://github.com/signaltech-org/bolthub-sdk/issues"},"bin":{"mcp-registry":"dist/index.js"},"dist":{"shasum":"11aa4d042b1eb408081eec728ba58f71d2f7b765","tarball":"https://registry.npmjs.org/@bolthub/mcp-registry/-/mcp-registry-0.1.5.tgz","fileCount":4,"integrity":"sha512-/3C0ryFrkEs/XwrKTXnwMxiGJk9C2wxVxk+uORKKhG0+SFWQK9qKeQHGeCLu3jF3ZjHG508LqP1OQO/T+/PdzA==","signatures":[{"sig":"MEUCIQCWP3ZffqpM80fYo7U/VXZsMMJU4lIVc2zhihx12vyNqAIgCqmANfsuY7mSt6wA3Rkf1XcZ9YamX0UYDOyNUhF5SDk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bolthub%2fmcp-registry@0.1.5","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":3195977},"main":"dist/index.js","type":"module","gitHead":"45757d84b803c659344e6706e50384c582caba46","mcpName":"ai.bolthub/registry","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-registry"},"_npmVersion":"10.9.8","description":"MCP server that gives AI agents access to every API on the bolthub marketplace — search, discover, and call any L402 endpoint with one config","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-registry_0.1.5_1781231985310_0.4061327409330766","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Replaced by @bolthub/mcp — npx -y @bolthub/mcp is a drop-in (zero config = marketplace mode). Migration: https://github.com/signaltech-org/bolthub-sdk/tree/main/packages/mcp#migrating-from-bolthubmcp-registry--bolthubmcp-bridge"},"0.1.6":{"name":"@bolthub/mcp-registry","version":"0.1.6","keywords":["mcp","l402","lightning","bitcoin","ai-agent","api-marketplace","model-context-protocol","registry"],"license":"MIT","_id":"@bolthub/mcp-registry@0.1.6","maintainers":[{"name":"bolthub.ai","email":"contact@bolthub.ai"}],"homepage":"https://docs.bolthub.ai/docs/sdks/mcp-registry","bugs":{"url":"https://github.com/signaltech-org/bolthub-sdk/issues"},"bin":{"mcp-registry":"dist/index.js"},"dist":{"shasum":"c5e7910fa3af77e22772d411cc198ec906560ebd","tarball":"https://registry.npmjs.org/@bolthub/mcp-registry/-/mcp-registry-0.1.6.tgz","fileCount":4,"integrity":"sha512-hsff9xCTzNox8Rmf+kh5n+a87YuVqzC1RsaVZ9qXMRdbxhlSZdGGYs8/F76vMPaLfsaV/L0hC7ciaTs2GEbECw==","signatures":[{"sig":"MEYCIQCOFL1jzkY3z4sGrzgbjjRHSp94OA6Sx6/ZLwkS+wEigAIhAKItHRdVHZBzyRU56yyw5lYcALf2KZ6pNlPoye7bjXJV","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bolthub%2fmcp-registry@0.1.6","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":3197234},"main":"dist/index.js","type":"module","gitHead":"da81efaaaeb7f371cfe0bb65133308c7e6c0554b","mcpName":"ai.bolthub/registry","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-registry"},"_npmVersion":"10.9.8","description":"MCP server that gives AI agents access to every API on the bolthub marketplace — search, discover, and call any L402 endpoint with one config","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-registry_0.1.6_1781237933238_0.029879109027890483","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Replaced by @bolthub/mcp — npx -y @bolthub/mcp is a drop-in (zero config = marketplace mode). Migration: https://github.com/signaltech-org/bolthub-sdk/tree/main/packages/mcp#migrating-from-bolthubmcp-registry--bolthubmcp-bridge"}},"time":{"created":"2026-05-15T06:50:55.124Z","modified":"2026-07-07T01:08:14.397Z","0.1.0":"2026-05-15T06:50:55.387Z","0.1.1":"2026-05-15T07:17:06.222Z","0.1.2":"2026-05-15T07:49:22.188Z","0.1.3":"2026-06-10T07:13:37.381Z","0.1.4":"2026-06-10T11:35:40.550Z","0.1.5":"2026-06-12T02:39:45.529Z","0.1.6":"2026-06-12T04:18:53.414Z"},"bugs":{"url":"https://github.com/signaltech-org/bolthub-sdk/issues"},"license":"MIT","homepage":"https://docs.bolthub.ai/docs/sdks/mcp-registry","keywords":["mcp","l402","lightning","bitcoin","ai-agent","api-marketplace","model-context-protocol","registry"],"repository":{"url":"git+https://github.com/signaltech-org/bolthub-sdk.git","type":"git","directory":"packages/mcp-registry"},"description":"MCP server that gives AI agents access to every API on the bolthub marketplace — search, discover, and call any L402 endpoint with one config","maintainers":[{"name":"bolthub.ai","email":"contact@bolthub.ai"}],"readme":"# @bolthub/mcp-registry\n\nMCP server that gives AI agents access to **every API** on the bolthub marketplace. One config entry, every API, forever. New APIs are instantly available, with no config changes needed.\n\nSource: [signaltech-org/bolthub-sdk](https://github.com/signaltech-org/bolthub-sdk) · Docs: [docs.bolthub.ai](https://docs.bolthub.ai/docs/sdks/mcp-registry)\n\n## Install\n\n```bash\nnpm install -g @bolthub/mcp-registry\n```\n\nOr use directly with `npx`:\n\n```bash\nnpx @bolthub/mcp-registry\n```\n\n## Configuration\n\nAdd to your MCP client config (Cursor, Claude Desktop, OpenClaw, etc.):\n\n```json\n{\n  \"mcpServers\": {\n    \"bolthub\": {\n      \"command\": \"npx\",\n      \"args\": [\"@bolthub/mcp-registry\"],\n      \"env\": {\n        \"LND_REST_HOST\": \"https://your-lnd-node:8080\",\n        \"LND_MACAROON\": \"<hex-pay-macaroon>\"\n      }\n    }\n  }\n}\n```\n\nThat's it. Every API on bolthub.ai is now available to your agent.\n\n### Environment Variables\n\nThe registry needs a Lightning wallet to pay for API calls. You only need **one** wallet type.\n\n| Variable | Description |\n|----------|-------------|\n| `LND_REST_HOST` | **Recommended.** LND REST API URL (bolthub Node Launcher or your own node — self-hosted or via [Umbrel](https://umbrel.com)). Fast (<200ms), full control. Use a pay-scoped macaroon in production. |\n| `LND_MACAROON` | Hex-encoded macaroon for LND. Required with `LND_REST_HOST`. |\n| `NWC_URI` | **Recommended for easy setup.** Works with any NWC-compatible wallet: [CoinOS](https://coinos.io) (free), [Alby Hub](https://getalby.com), 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 with `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 with `PHOENIXD_URL`. |\n| `BUDGET_SATS` | Optional. Maximum sats the MCP can spend per session. When exceeded, API calls are refused. Unset = unlimited. |\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 (the session lasts as long as the MCP server process runs, typically the lifetime of your Cursor or Claude Desktop window). You can also use the `--budget` CLI flag:\n\n```bash\nnpx @bolthub/mcp-registry --budget 1000\n```\n\nOr via env var in your MCP config:\n\n```json\n\"env\": { \"LND_REST_HOST\": \"...\", \"LND_MACAROON\": \"...\", \"BUDGET_SATS\": \"1000\" }\n```\n\n**Guidance:**\n- `100-500` - Testing and light use\n- `1000-5000` - Typical daily development\n- `10000+` - Heavy or production use\n- Unset - No limit (pays any invoice as long as the wallet has funds)\n\nThe budget is a safety net against runaway spending. When the limit is reached, `call_api` returns an error instead of paying.\n\n## Tools\n\nThe registry exposes four tools to your AI agent:\n\n### `search_apis`\n\nSearch the bolthub marketplace for APIs by keyword or tag.\n\n```\nsearch_apis({ query: \"weather\" })\nsearch_apis({ tag: \"finance\" })\nsearch_apis()  // list all available APIs\n```\n\n### `get_api_details`\n\nGet full details for a specific API: endpoints, pricing, examples.\n\n```\nget_api_details({ slug: \"pokemon\" })\n```\n\n### `preview_cost`\n\nPreview the cost of calling an API endpoint without making the request or paying.\n\n```\npreview_cost({ slug: \"pokemon\" })\npreview_cost({ slug: \"pokemon\", path: \"/v2/pokemon/pikachu\" })\n```\n\n### `call_api`\n\nCall any API endpoint. Lightning payments are handled automatically.\n\n```\ncall_api({ slug: \"pokemon\", path: \"/v2/pokemon/pikachu\", method: \"GET\" })\ncall_api({ slug: \"my-api\", path: \"/analyze\", method: \"POST\", body: { text: \"hello\" } })\n```\n\n## How it works\n\n1. `search_apis` queries the live bolthub directory, and new APIs appear immediately\n2. `get_api_details` fetches endpoint specs so the agent knows how to call them\n3. `preview_cost` lets you check pricing before committing to a call\n4. `call_api` hits the gateway, pays any L402 invoice automatically, and returns the response\n\n## vs @bolthub/mcp-bridge\n\n| | Registry (`mcp-registry`) | Bridge (`mcp-bridge`) |\n|---|---|---|\n| Config | One entry, every API | One entry per API |\n| New APIs | Instant | Requires config change |\n| Tool count | 4 (fixed) | N (one per endpoint) |\n| Best for | General-purpose agents | Dedicated single-API agents |\n\nUse the registry for most cases. Use the bridge when you want direct, named tools for a specific API.\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**: `https://api.bolthub.ai` (marketplace directory), `https://<slug>.gw.bolthub.ai` (the API you call), 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-registry`). 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"}