Skip to main content
Glama
mcp-mempool

mcp-mempool

by Ethosen

mcp-mempool

MCP (Model Context Protocol) server for the mempool.space Bitcoin API. No API key required.

Lets any MCP client (Claude Code, Claude Desktop, etc.) query live Bitcoin data: recommended fees, mempool state, blocks, transactions, addresses, price.

Tools

Tool

Arguments

Returns

get_recommended_fees

—

Fee estimates in sat/vB (fastest, 30 min, 1 h, economy, minimum)

get_mempool_stats

—

Unconfirmed tx count, total vsize, total pending fees

get_tip

—

Current block height and hash

get_recent_blocks

limit (1-10, default 5)

Recent blocks: height, time, tx count, median fee, mining pool

get_transaction

txid (64 hex chars)

Confirmation status, fee, fee rate, inputs/outputs

get_address

address

Confirmed balance, received total, tx counts, pending delta

get_price

—

BTC price in USD, EUR, GBP, CAD, CHF, AUD, JPY

Related MCP server: mcp-l402-gate-example

Install and build

npm install
npm run build

Try it

examples/client.mjs spawns the server over stdio and calls each tool:

npm run example

Use with Claude Code

claude mcp add mempool -- node /path/to/mcp-mempool/dist/index.js

Then ask, for example: "quels frais je mets pour une transaction confirmée dans l'heure ?"

Use with Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "mempool": {
      "command": "node",
      "args": ["/path/to/mcp-mempool/dist/index.js"]
    }
  }
}

Other networks / self-hosted instance

Set MEMPOOL_API_BASE to point elsewhere (default: https://mempool.space/api):

{
  "mcpServers": {
    "mempool-testnet": {
      "command": "node",
      "args": ["/path/to/mcp-mempool/dist/index.js"],
      "env": { "MEMPOOL_API_BASE": "https://mempool.space/testnet4/api" }
    }
  }
}

Works with any mempool.space-compatible instance (e.g. a self-hosted one on your own node).

Notes

  • Uses the public REST API; heavy usage should point MEMPOOL_API_BASE at a self-hosted instance (mempool.space rate-limits aggressively).

  • API errors are returned as MCP tool errors (isError: true) with the upstream message, so the model can react to them.

License

MIT

Available Tools

7 tools
get_addressAddress statsA

Get stats for a Bitcoin address: confirmed balance, total received/spent, and transaction counts (on-chain and in mempool).

Inputs: address (required).

get_mempool_statsMempool statisticsA

Get the current state of the Bitcoin mempool: number of unconfirmed transactions, total virtual size (vBytes), and total pending fees in satoshis. Useful to judge network congestion.

Inputs: no named parameters.

get_priceBitcoin priceA

Get the current Bitcoin price in USD, EUR, GBP, CAD, CHF, AUD, and JPY.

Inputs: no named parameters.

get_recent_blocksRecent blocksA

Get a summary of the most recent Bitcoin blocks: height, hash, timestamp, transaction count, size, and median fee. Returns up to 10 blocks.

Inputs: limit.

get_tipChain tipA

Get the current Bitcoin chain tip: block height and block hash.

Inputs: no named parameters.

get_transactionTransaction detailsA

Get details for a Bitcoin transaction by txid: confirmation status, block height, fee, size, and inputs/outputs summary.

Inputs: txid (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool targets a distinct data resource: fees, mempool stats, chain tip, recent blocks, a specific transaction, an address, and price. No two tools overlap in purpose, making selection unambiguous.

    Naming Consistency5/5

    All tools follow a consistent 'get_' verb + noun pattern (get_recommended_fees, get_mempool_stats, get_tip, get_recent_blocks, get_transaction, get_address, get_price). The naming scheme is uniform and predictable.

    Tool Count5/5

    Seven tools is well-scoped for a mempool/blockchain information server. Each tool addresses a common need without redundancy, and the count is within the ideal 3-15 range.

    Completeness4/5

    The server covers fees, mempool state, chain tip, recent blocks, transactions, addresses, and price—covering the primary read-only use cases. A notable minor gap is the lack of a way to fetch a specific block by height or hash, but this is not critical for typical mempool queries.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An 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
    • A
      license
      Not graded
      quality
      D
      maintenance
      Minimal MCP server demonstrating L402 pay-per-call with Depth-of-Identity reputation gating, providing a bitcoin data tool that fetches BTC price and mempool fees.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server for Bitcoin block explorer and mempool/fee statistics, providing tools to query fees, mempool stats, blocks, transactions, addresses, hashrate, and mining pools.
      300 npm
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      MCP server offering 26 Lightning-paid tools for Bitcoin mempool intelligence and sovereign on-prem AI inference, with no third-party APIs and pay-per-call in sats.
      26
      16 npm
      1
      MIT