Skip to main content
Glama
Mempool MCP Server

Mempool MCP Server

πŸš€ Mempool MCP Server

A Model Context Protocol (MCP) server providing real-time Bitcoin blockchain and mempool data, powered by mempool.space APIs. Use this server as a tool provider in your MCP-compatible clients (like Claude, Cursor, and others) to access up-to-date Bitcoin network information. Its an unofficial repository.


πŸ› οΈ Available Bitcoin Tools

Tool Name

Description

get-difficulty-adjustment

Get current and next Bitcoin difficulty adjustment info.

get-price

Get the current BTC price in various fiat currencies.

get-historical-price

Get the BTC price for a specific date (YYYY-MM-DD).

get-recommended-fees

Get recommended Bitcoin transaction fees.

get-stats-info

Get general Bitcoin network statistics.

get-mining-pools

Get mining pools info.

get-mining-pool

Get info for a specific mining pool.

get-mining-blocks-fees-24h

Get mining blocks fees for the last 24h.

get-mempool-info

Get mempool info.

get-mempool-txids

Get mempool txids.

get-mempool-recent

Get recent mempool transactions.

get-blocks

Get the latest blocks.

get-block

Get details about a block from its hash.

get-block-txids

Get txids for a block.

get-block-txs

Get transactions for a block.

get-block-status

Get block status.

get-block-raw

Get raw block hex.

get-block-txid-by-index

Get block txid by index.

get-block-header

Get the block header in hex.

get-address-info

Get details about an address.

get-address-txs

Get transactions for an address.

get-address-txs-chain

Get chain transactions for an address.

get-address-txs-mempool

Get mempool transactions for an address.

get-address-utxo

Get UTXOs for an address.

get-tx-info

Get details about a transaction.

get-tx-status

Get transaction status.

get-tx-raw

Get raw transaction hex.

get-tx-merkleblock-proof

Get transaction merkleblock proof.

get-tx-outspend

Get outspend info for a transaction output.

get-tx-outspends

Get outspends for all outputs of a transaction.


Related MCP server: Satstream MCP Server

πŸ€– What is MCP?

Model Context Protocol (MCP) is a standard for tool providers to communicate with AI clients via standard input/output. This server lets you plug Bitcoin data tools into any MCP-compatible client.


⚑ Quick Start: Use in Your MCP Client

You can configure this server as a tool provider in your MCP Client such Claude, Cursor, VsCode and others:

"mempool-mcp-server": {
  "command": "npx",
  "args": [
    "@sanlim/mempool-mcp-server"
  ]
},
TIP

To connect locally for privacy and unlimited calls, you can pass the base mempool API URL as an environment config from your local Bitcoin node such as Umbrel, MyNode, etc. See below:

"mempool-mcp-server-local": {
 "command": "npx",
 "args": [
   "@sanlim/mempool-mcp-server"
 ],
 "env": {
   "MEMPOOL_BASE_URL": "http://umbrel.local:3006/api"
 }
},

Check this working with "mempool url" text on your MCP Client.

Enjoy!

or

πŸ› οΈ Using a Local Build

  1. Clone this repository:

git clone https://github.com/alexandresanlim/mempool-mcp-server.git
  1. Install and build:

npm install
npm run build
npm run server
  1. Configure your MCP client:

"mempool-mcp-server-debug": {
  "command": "node",
  "args": [
    "...replace_to_path_of_project/mempool-mcp-server/build/main.js"
  ]
},

The server will start and listen for MCP requests via standard input/output. πŸŽ‰


πŸ“š Reference & Troubleshooting

  • Full API reference: mempool.space API docs

  • If you have issues, make sure your build is up to date and your MCP client is configured to use stdio.

  • For questions or contributions, feel free to open an issue or pull request!


Made with ❀️ by a bitcoiner. Enjoy!

Available Tools

31 tools
get-address-infoC

Returns details about an address

Inputs: address (required).

get-address-txsC

Returns transactions for an address

Inputs: address (required).

get-address-txs-chainC

Returns chain transactions for an address

Inputs: address (required).

get-address-txs-mempoolC

Returns mempool transactions for an address

Inputs: address (required).

get-address-utxoC

Returns UTXOs for an address

Inputs: address (required).

get-base-urlB

Returns mempool.space base url api

Inputs: no named parameters.

get-blockA

Returns details about a block from hash

Inputs: hash (required).

get-block-headerC

Returns the block header in hex

Inputs: hash (required).

get-block-rawC

Returns raw hex for a block

Inputs: hash (required).

get-blocksC

Returns the latest blocks

Inputs: no named parameters.

get-block-statusC

Returns status for a block

Inputs: hash (required).

get-block-txid-by-indexC

Returns txid for a block at a specific index

Inputs: hash (required), index (required).

get-block-txidsC

Returns txids for a block

Inputs: hash (required).

get-block-txsC

Returns transactions for a block

Inputs: hash (required).

get-difficulty-adjustmentB

Returns current and next Bitcoin difficulty adjustment info

Inputs: no named parameters.

get-historical-priceC

Returns the BTC price for a specific date (YYYY-MM-DD)

Inputs: date (required).

get-mempool-infoC

Returns mempool info

Inputs: no named parameters.

get-mempool-recentB

Returns recent mempool transactions

Inputs: no named parameters.

get-mempool-txidsC

Returns mempool txids

Inputs: no named parameters.

get-mining-blocks-fees-24hB

Returns mining blocks fees for the last 24h

Inputs: no named parameters.

get-mining-poolC

Returns info for a specific mining pool

Inputs: poolId (required).

get-mining-poolsB

Returns mining pools info

Inputs: no named parameters.

get-priceB

Returns the current BTC price in various fiat currencies

Inputs: no named parameters.

get-stats-infoD

Returns stats info

Inputs: no named parameters.

get-tx-infoC

Returns details about a transaction

Inputs: txid (required).

get-tx-merkleblock-proofC

Returns the merkleblock proof for a transaction

Inputs: txid (required).

get-tx-outspendC

Returns outspend info for a transaction output

Inputs: txid (required), vout (required).

get-tx-outspendsC

Returns outspends info for all outputs of a transaction

Inputs: txid (required).

get-tx-rawC

Returns raw hex for a transaction

Inputs: txid (required).

get-tx-statusC

Returns status for a transaction

Inputs: txid (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 31 tools

    Disambiguation4/5

    Most tools have distinct purposes targeting specific resources like addresses, blocks, transactions, or mempool data, with clear naming to differentiate them. However, some tools like get-address-txs, get-address-txs-chain, and get-address-txs-mempool have overlapping scopes that could cause confusion in selection, though descriptions help clarify the differences.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern with hyphens (e.g., get-address-info, get-block-txids), using 'get' as the primary verb throughout. This uniformity makes the tool set predictable and easy to navigate, with no deviations in naming conventions.

    Tool Count2/5

    With 31 tools, the count feels excessive for a mempool server, leading to potential bloat and complexity. While the domain is broad, many tools could be consolidated (e.g., multiple address transaction queries), making the set heavy and less scoped than ideal for efficient agent use.

    Completeness5/5

    The tool set provides comprehensive coverage for Bitcoin blockchain and mempool operations, including CRUD-like actions for addresses, blocks, transactions, and fees. There are no obvious gaps; it supports full lifecycle queries from raw data to status checks, ensuring agents can handle typical workflows without dead ends.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that enables querying Bitcoin blockchain data, including address information, transaction details, mempool statistics, and ordinals/runes data through the Satstream API.
      37
      MIT
    • F
      license
      A
      quality
      C
      maintenance
      A server that exposes blockchain data (balances, tokens, NFTs, contract metadata) via the Model Context Protocol, enabling AI agents and tools to access and analyze blockchain information contextually.
      18
      46
      -
    • 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