IRONCLAW BTC Node

🔥 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.