SDK and MCP server for per-call Bitcoin Lightning payments to MCP tools with budgets and verifiable receipts.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
One-click editor setup isn’t available for this listing yet — we don’t have a confirmed install command, and we’d rather show nothing than point your editor at the wrong package or host. Follow the project’s own setup instructions, linked above.
Manual Client & Custom JSON ConfigExpand JSON â–¾
No confirmed setup config for this listing yet. We only publish a config block when the install details come from the project itself — its README, its docs, or a verified owner. We haven’t found those for signaltech-org/bolthub-sdk, and we’d rather show nothing than a guess you’d paste into your client. Follow the project’s own setup instructions for the current steps.
Overview
Use cases
Charge AI agents per API call using Bitcoin Lightning payments
Manage prepaid budgets and scoped delegation for tool usage
Verify gateway signatures in Node.js or Python web frameworks
Aggregate multiple MCP servers behind a unified payment gateway
Integrate Lightning wallet adapters for payment processing
Key features
Per-call pricing and payment for MCP tools and HTTP endpoints
Support for Lightning Network (L402) payment rails without funds passing through bolthub
Shared Lightning budgets across MCP servers and gateways
Open-source SDKs in TypeScript (npm) and Python (PyPI)
CLI client for marketplace interaction
Middleware for signature verification in Express, Fastify, Flask, Django, and FastAPI
Capabilities & Tool Schemas
Inspect callable tools, capabilities, and parameters exposed to AI agents by Bolthub Sdk.
Extracted Tool Capabilities
Per-call pricing and payment for MCP tools and HTTP endpoints
Support for Lightning Network (L402) payment rails without funds passing through bolthub
Shared Lightning budgets across MCP servers and gateways
Open-source SDKs in TypeScript (npm) and Python (PyPI)
CLI client for marketplace interaction
Middleware for signature verification in Express, Fastify, Flask, Django, and FastAPI
Documentation Overview
bolthub SDK
Source code for every publicly published bolthub.ai package: the npm @bolthub/* scope and the bolthub / bolthub-verify PyPI packages.
bolthub is a payment layer for agent-to-tool commerce: charge agents for your MCP tools and APIs per call, settling straight to your wallet over Lightning (L402), with bolthub never in the funds path. These packages are the open-source side of that: the tool-payment SDK, payment clients, MCP servers, a CLI, and origin-verification middleware.
| Package | Registry | Directory | What it is |
|---|---|---|---|
@bolthub/pay | npm | packages/pay | The payments SDK, both sides: price an MCP tool or HTTP endpoint (createPaywall), pay for tools within a budget (ToolClient for MCP, L402Client for HTTP), wallet adapters (LND, LNbits, Phoenixd, NWC, WebLN); rails: L402, facilitator. Zero runtime dependencies |
@bolthub/mcp | npm | packages/mcp | The bolthub MCP server: marketplace + specific gateways + your other MCP servers behind one config entry, with one shared Lightning budget |
@bolthub/cli | npm | packages/cli | Terminal client for the marketplace |
@bolthub/verify | npm | packages/verify | Gateway signature verification middleware (Express/Fastify/Node) |
bolthub | PyPI | packages/agent-python | The payments SDK in Python: L402 client + wallets, and the seller-side paywall |
bolthub-verify | PyPI | packages/verify-python | Python gateway signature verification (Flask/Django/FastAPI) |
packages/shared is internal (never published); it is here because @bolthub/mcp bundles it.
Consolidation (2026-07):
@bolthub/agentmerged into@bolthub/pay(≥0.4.0);@bolthub/mcp-registryand@bolthub/mcp-bridgemerged into@bolthub/mcp. The old names are deprecated on npm and point here.
Relationship to the bolthub platform
The bolthub platform (gateway, API, web app) lives in a private monorepo. The SDK packages above are developed there and synced to this repository, which is the publish origin: releases are tagged here and built + published by CI with npm provenance, so what's on npm is verifiably built from this public source.
Issues and PRs are welcome here, but note that this repo is a generated mirror: PRs are never merged directly. Accepted changes are applied to the monorepo first (with attribution), then sync back out with the next release. See CONTRIBUTING.md before opening a PR.
Verifying what you install
Published dist/ bundles are built with Bun from this source and ship source maps with embedded sources, so the tarball itself is readable.
See SECURITY.md for the trust model (what touches your wallet credentials and what doesn't) and how to report vulnerabilities.
Development
Each TypeScript package builds with bun run build from its directory (@bolthub/pay must be built before the packages that bundle it).
License
MIT
Related MCP Servers
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Bolthub Sdk
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/signaltech-org-bolthub-sdk)HTML Embed
<a href="https://allmcps.com/mcp/signaltech-org-bolthub-sdk"><img src="https://allmcps.com/api/badge/signaltech-org-bolthub-sdk?style=directory" alt="Bolthub Sdk on AllMCPs" /></a>Technical Specs & Signals
CategoryFinance & Fintech
9/10 checks healthy over the last 31d
39Quality signal: Fair · 39/100How this signal is calculated ▾
Server availabilityNot measured
Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership10/20
Documentation & tools17/30
Adoption & activity2/15
Community engagement0/10
A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.