bitcoin-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
bitcoin-mcp
MCP server giving AI agents Bitcoin and Lightning superpowers.
pip install bitcoin-mcpPlug it into Claude Desktop, Cursor, or any MCP-compatible client and your AI can instantly:
π Check Bitcoin price (USD / EUR / GBP)
βοΈ Inspect mempool, fee rates, blocks, and transactions
β‘ Decode Lightning invoices
π Query the Lightning Network global stats
π Pay Lightning invoices via Nostr Wallet Connect (NWC)
π Fetch L402-protected content, auto-paying the invoice
Quick start
pip install bitcoin-mcp
bitcoin-mcp # starts MCP server on stdioClaude Desktop integration
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"bitcoin": {
"command": "bitcoin-mcp",
"env": {
"NWC_CONNECTION_STRING": "nostr+walletconnect://your-nwc-uri-here"
}
}
}
}Restart Claude Desktop. You'll see Bitcoin tools appear in the tool picker.
Lightning payments (optional)
Requires a Nostr Wallet Connect connection string from a compatible wallet (Alby, Mutiny, etc.):
export NWC_CONNECTION_STRING="nostr+walletconnect://..."
export NWC_MAX_SATS=5000 # spending cap per payment (default: 10000)Also requires Node.js (npx) for the @getalby/cli NWC backend.
Related MCP server: Lightning Enable MCP
Available tools
Read-only (no auth needed)
Tool | Description |
| BTC price in USD, EUR, GBP |
| Unconfirmed tx count, vsize, fee rates (fastest/hour/economy) |
| Most recent block: height, hash, timestamp, tx count |
| Block by height or hash |
| Decode a bolt11: amount, description, expiry, payee |
| LN node count, channel count, total capacity |
| On-chain balance (confirmed + unconfirmed) in satoshis |
| Recent transactions for a Bitcoin address |
| Transaction details: confirmations, fee, inputs, outputs |
Lightning (requires NWC_CONNECTION_STRING)
Tool | Description |
| Lightning wallet balance in satoshis |
| Pay a bolt11 invoice (capped by |
| Create a Lightning invoice |
L402 (requires NWC_CONNECTION_STRING)
Tool | Description |
| Fetch an L402-protected URL, auto-paying the Lightning invoice |
Example session
Once connected, you can ask Claude:
"What's the current Bitcoin price and mempool congestion?"
"Decode this invoice: lnbc1000n1p..."
"What's the balance on bc1q...?"
"Pay this invoice for me: lnbc..." (requires NWC)
Python API
The library can also be used directly in Python:
import asyncio
from bitcoin_mcp import BitcoinAPIClient, NWCClient
async def main():
async with BitcoinAPIClient() as api:
price = await api.get_price()
print(f"BTC: ${price['usd']:,.0f}")
mempool = await api.get_mempool_info()
print(f"Mempool: {mempool['count']:,} txs")
print(f"Fastest fee: {mempool['fees']['fastest_sat_vb']} sat/vB")
# Decode an invoice
decoded = await api.decode_invoice("lnbc1000n1p...")
print(f"Invoice for {decoded['amount_sat']} sats: {decoded['description']}")
asyncio.run(main())Data sources
All data is fetched from free public APIs:
mempool.space β blocks, transactions, addresses, fees, Lightning
blockchain.info β BTC price ticker
No API keys required for read-only tools.
Development
git clone https://github.com/spcpza/bitcoin-mcp
cd bitcoin-mcp
pip install -e ".[dev]"
pytestSupport
This is open-source infrastructure for autonomous AI agents. If your agent uses it or you're building on top of it, consider donating:
β‘ sensiblefield821792@getalby.com
Issues and PRs welcome.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server connecting AI agents to non-custodial staking data across 130+ networks.
Give AI agents a Bitcoin wallet with Lightning Network payments and L402 support.
Hosted MCP server for live public-data APIs and Skills for AI agents.
MCP server for building and testing AI agents with multi-model experimentation and insights.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that provides AI agents with real-time and historical Bitcoin network data by wrapping the mempool.space WebSocket and REST APIs. It enables tracking addresses, monitoring blocks, and retrieving transaction details or fee estimates through natural language.MIT
- AlicenseAqualityBmaintenanceMCP server that enables AI agents to make autonomous Bitcoin Lightning Network payments using the L402 protocol. Agents can pay for API access, purchase resources, and complete transactions without human intervention β invoice comes in, sats go out, done.179MIT
- AlicenseAqualityDmaintenanceMCP server that gives AI agents Lightning payments, L402 API access, trust verification, and service discovery.1122 npmMIT

satsrail-mcpofficial
AlicenseNot gradedqualityCmaintenanceAn MCP server that enables AI agents to accept Bitcoin Lightning payments. It allows agents to create orders, generate invoices, check payment status, and manage the full SatsRail merchant API through natural language.MIT