🔥 Quick Start
Add to your claude_desktop_config.json or any MCP client:
{
"mcpServers": {
"btc-node": {
"type": "sse",
"url": "https://mcp.btcnode.uk/sse"
}
}
}
That's it. No install. No API keys. No setup. Free tools work immediately.
🆓 Free Tools (No Payment Required)
# Try them right now — no payment, no API key
curl https://btcnode.uk/api/info
curl https://btcnode.uk/api/fees
curl https://btcnode.uk/api/mempool
💰 Paid Tools ($0.001 each via x402)
Paid tools use x402 protocol — pay $0.001 USDC per call on Base mainnet. Your wallet approves the payment directly in the MCP client.
🏗 Architecture
MCP Client (Claude Desktop, Cursor, etc.)
│
▼ SSE (mcp.btcnode.uk/sse)
┌──────────────┐
│ MCP Server │ 17 tools, x402 payment middleware
└──────┬───────┘
│ HTTP API
┌──────┴───────┐
│ BTC API │ REST endpoints, paywall enforcement
└──────┬───────┘
│ RPC
┌──────┴───────┐
│ Bitcoin Core │ Full node (953K+ blocks, 10 peers)
│ LND │ Lightning Network (12K sats)
└──────────────┘
🚀 Self-Hosted Deployment
git clone https://github.com/cariohca-ux/x402-btc-node.git
cd x402-btc-node
npm install
cp .env.example .env
# Edit .env with your settings
node mcp-server.mjs
Requirements: Node.js 18+, a synced Bitcoin Core node (or use the hosted endpoint at btcnode.uk).
📋 Listings
📄 License
MIT — do what you want. Built by cariohca-ux. Bitcoin data served from a real full node.