Skip to main content
Glama
@bitcoinbenji/mcp

@bitcoinbenji/mcp

by 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>" }
    }
  }
}

Related MCP server: @powforge/captcha-mcp

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

Available Tools

26 tools
ai_agentB

General-purpose AI agent — handles any text task. [30 sats per call]

Inputs: task (required), context, preimage, macaroon.

ai_classifyC

Classify text into your provided categories. [10 sats per call]

Inputs: text (required), categories (required), preimage, macaroon.

ai_code_generateC

Generate code from a natural-language spec. [40 sats per call]

Inputs: prompt (required), language, context, preimage, +1 more.

ai_code_reviewB

Code review for bugs, security, and performance issues. [50 sats per call]

Inputs: code (required), language, preimage, macaroon.

ai_embedB

768-dim embedding vector for RAG (single text or batch). [2 sats per call]

Inputs: text, texts, preimage, macaroon.

ai_explainC

Explain any topic at the requested level. [25 sats per call]

Inputs: topic (required), level, preimage, macaroon.

ai_extractB

Extract structured data from text (entities/contacts/dates/custom schema). [25 sats per call]

Inputs: text (required), schema, custom_fields, preimage, +1 more.

ai_grammarC

Fix grammar, spelling, and punctuation. [15 sats per call]

Inputs: text (required), preimage, macaroon.

ai_longformB

Summarize huge documents (~50K words) in one flat-fee call. [75 sats per call]

Inputs: text, url, focus, max_length, +2 more.

ai_ocrA

Extract all visible text from an image URL. [25 sats per call]

Inputs: image_url (required), preimage, macaroon.

ai_researchB

Multi-step web research + cited synthesis. [100 sats per call]

Inputs: question (required), max_sources, preimage, macaroon.

ai_rewriteB

Rewrite text in a different style/tone. [15 sats per call]

Inputs: text (required), style (required), preimage, macaroon.

ai_scrapeB

Scrape & extract clean readable text from any URL. [15 sats per call]

Inputs: url (required), preimage, macaroon.

ai_sentimentC

Sentiment analysis with confidence score. [10 sats per call]

Inputs: text (required), preimage, macaroon.

ai_summarizeB

Summarize text (short/medium/long). [20 sats per call]

Inputs: text (required), max_length, preimage, macaroon.

ai_transcribe_tableB

Convert a table image into JSON rows. [35 sats per call]

Inputs: image_url (required), preimage, macaroon.

ai_translateB

Translate between 100+ languages. [20 sats per call]

Inputs: text (required), target (required), source, preimage, +1 more.

ai_visionC

Vision QA over an image URL (Qwen3-VL, sovereign). [40 sats per call]

Inputs: image_url (required), question, preimage, macaroon.

fee_quoteA

Exact fee quote for a planned tx: {inputs, outputs, target_blocks, input_type}. [15 sats per call]

Inputs: inputs (required), outputs (required), target_blocks (required), input_type, +2 more.

get_feesB

Bitcoin fee estimates with trend analysis (next-block, 30-min, 1-hour) from a full node mempool. [10 sats per call]

Inputs: preimage, macaroon.

get_mempool_historyA

Rolling 24h snapshots of mempool size and fees. [50 sats per call]

Inputs: preimage, macaroon.

get_mempool_stateB

Live Bitcoin mempool state: tx count, byte size, fee histogram. [5 sats per call]

Inputs: preimage, macaroon.

get_recent_blocksC

Recent Bitcoin block data: heights, tx counts, timestamps. [10 sats per call]

Inputs: preimage, macaroon.

get_whalesB

Recent whale alerts: large transfers, consolidations, distributions in the mempool. [40 sats per call]

Inputs: since_seconds, preimage, macaroon.

predict_feesB

EMA-based fee prediction with confidence + direction (rising/falling). [50 sats per call]

Inputs: preimage, macaroon.

tx_statusA

Lookup a Bitcoin transaction by txid: confirmations, fee, block height, mempool ETA. [15 sats per call]

Inputs: txid (required), preimage, macaroon.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 26 tools

    Disambiguation5/5

    All AI tools have distinct purposes (e.g., classify, summarize, translate) and are clearly delineated by the 'ai_' prefix. The Bitcoin tools are also distinct from each other and from the AI tools, leaving no ambiguity.

    Naming Consistency3/5

    The AI tools consistently use 'ai_' prefix, but the Bitcoin tools mix 'get_' (get_fees, get_mempool_state) with other patterns (fee_quote, predict_fees), creating an inconsistent overall naming convention.

    Tool Count4/5

    26 tools is on the high side but reasonable given the dual domain (18 AI + 8 Bitcoin). Each tool appears justified, and the count is not excessive for the scope.

    Completeness4/5

    The AI toolset covers many common tasks (generation, review, embedding, OCR, research, etc.). The Bitcoin toolset covers mempool, fees, and transaction status, though it lacks some operations like broadcasting.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      MCP 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.
      17
      9
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server that gates API calls to AI agents using proof-of-work (free) or Lightning payment (3 sats), providing challenge, verify, and status tools for per-call authentication without accounts.
      3
      87 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server giving AI agents Bitcoin and Lightning superpowers for price checks, mempool inspection, Lightning payments, and more.
      1
      MIT