ocbenji/bitcoinbenji-mcp

MCP server for Bitcoin Benji API — 26 paid tools for Bitcoin mempool intelligence + sovereign on-prem AI inference.

No third-party APIs. No data leakage. Dual payment rails: Lightning sats (L402) or USDC on Base (x402) — with automatic payment.

⚡ New in v0.2: x402 autopay

Set X402_PRIVATE_KEY to an EVM private key holding USDC on Base and every tool call pays for itself automatically — no Lightning wallet, no API key, no manual steps. The server signs an EIP-3009 USDC authorization for each 402 challenge and retries; gas is sponsored by the facilitator, funds go directly seller-side.

{
  "mcpServers": {
    "bitcoinbenji": {
      "command": "bitcoinbenji-mcp",
      "env": { "X402_PRIVATE_KEY": "0x<key holding USDC on Base>" }
    }
  }
}

What you get

Mempool intelligence (from a real Bitcoin Core full node):

• get_fees — fee estimates with trend
• get_whales — whale/consolidation alerts
• get_mempool_state — live mempool state
• get_mempool_history — 24h rolling snapshots
• predict_fees — EMA-based prediction
• get_recent_blocks — recent blocks
• tx_status — lookup any txid
• fee_quote — exact fee for a planned tx

AI inference (Qwen3 on dedicated GPU, no third-party APIs):

• ai_summarize, ai_sentiment, ai_translate, ai_grammar
• ai_code_review, ai_code_generate, ai_extract, ai_classify
• ai_rewrite, ai_explain, ai_agent, ai_scrape
• ai_embed, ai_vision, ai_ocr, ai_transcribe_table
• ai_longform (~50K-word docs flat-fee), ai_research (multi-step + cited)

Pricing: 2–100 sats per call (or the USD-equivalent in USDC: 10 sats = $0.01). See api.bitcoinbenji.com/pricing.

Install

npm install -g @bitcoinbenji/mcp

Use in Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "bitcoinbenji": {
      "command": "bitcoinbenji-mcp"
    }
  }
}

Restart Claude. Ask: "What are current Bitcoin fees?" — Claude will call get_fees, hit a 402 challenge, return a Lightning invoice. Pay it with any wallet, paste the preimage back, and Claude completes the call.

Use in Cursor / Cline / Continue / Windsurf

Same idea — point your MCP-compatible client at the bitcoinbenji-mcp binary.

Skip the manual payment loop — use an API key

Pre-fund a key once, then every call auto-debits in the background:

# Get a key (one-time): visit https://api.bitcoinbenji.com or curl /api/key/create
# Then:
export BITCOIN_BENJI_API_KEY="bb_live_..."
bitcoinbenji-mcp

Or in Claude Desktop config:

{
  "mcpServers": {
    "bitcoinbenji": {
      "command": "bitcoinbenji-mcp",
      "env": { "BITCOIN_BENJI_API_KEY": "bb_live_..." }
    }
  }
}

Why this exists

Most AI inference APIs require a credit card, an account, and a SaaS subscription. This one runs on a sovereign solar-powered AMD Strix Halo box, accepts payment in sats over Lightning, and never leaks your prompts to OpenAI/Anthropic/Google.

Source

github.com/ocbenji/bitcoinbenji-mcp

License

MIT