Query Bitcoin price, fees, blocks, and sentiment data via L402 Lightning micropayments. For developers building Bitcoin apps who need real-time on-chain metrics without traditional API keys.
io.github.SatoshiAPI/satoshi-btc-api
SatoshiAPI — Bitcoin Data via Lightning runs locally over stdio. Test it on your machine with MCP Playground Desktop:
Local install
STDIO
No auth required
How models use it and what it is built for.
Query Bitcoin price, fees, blocks, and sentiment data via L402 Lightning micropayments. For developers building Bitcoin apps who need real-time on-chain metrics without traditional API keys.
Local install — runs as a subprocess.
Configuration this server reads at startup.
LND REST endpoint for auto-payment
Path to LND invoice macaroon
Path to LND TLS certificate
Where to find authoritative docs and source for SatoshiAPI — Bitcoin Data via Lightning.
Paste any of these into Agent Studio after connecting SatoshiAPI — Bitcoin Data via Lightning.
Common questions about connecting and running SatoshiAPI — Bitcoin Data via Lightning.
What is L402 and why does this API use it?
L402 is a protocol for Lightning-based micropayments. This server uses it so you pay per query via Bitcoin Lightning instead of traditional subscriptions, enabling pay-as-you-go access to Bitcoin data.
How do I set up Lightning auto-payment for this MCP server?
Configure three environment variables: SATOSHIAPI_LND_REST (your LND node REST endpoint), SATOSHIAPI_LND_MACAROON (path to invoice macaroon), and SATOSHIAPI_LND_CERT (path to TLS cert). The server will automatically route payments through your LND node.
What Bitcoin data does this server provide?
Real-time price, network fees, block data, market sentiment, and DCA (dollar-cost averaging) signals. All queries are paid via Lightning micropayments to the Satoshi API backend.
Do I need my own Lightning node to use this?
Yes, you need an LND (Lightning Network Daemon) node running and accessible via REST. The server uses your node's macaroon and certificate to authenticate and route payments.
What happens if a query fails or the payment doesn't go through?
Check your LND node connectivity, macaroon permissions, and certificate paths. Ensure your Lightning channel has sufficient balance for the micropayment. Consult the Satoshi API docs for specific error codes.
MCP Playground runs 10,000+ hosted MCP servers — GitHub, Linear, Notion, Stripe, Sentry and more — across Claude, GPT, Gemini, DeepSeek and 90+ AI models. Compare model answers side-by-side, save agent presets, share runs. Zero install.
Open Agent StudioIn your browser
MCP Agent Studio
Server has a public URL? Chat with 90+ models on it, watch every tool call, and compare models side by side.
Open MCP Agent Studio →On your computer
MCP Playground Desktop
Server runs on localhost or over stdio? The browser can’t reach it. The desktop app can, with 90+ models in Agent Studio. Download free
Judges Panel
45 judges that evaluate AI-generated code for security, cost, and quality with built-in AST.
Addozhang Nexus
Query Sonatype Nexus Repository (OSS/Pro) for Maven, Python, and Docker artifacts
Cyanheads MCP Ts Template
TypeScript template for building MCP servers with declarative tooling, observability, and auth.
Chernistry Bernstein
Declarative agent orchestration for engineering teams