A
securityA
licenseA
qualityA Model Context Protocol server that provides read-only access to Bybit's cryptocurrency exchange API, allowing users to query real-time cryptocurrency data using natural language.
Last updated -
12
015
MIT License
Provides real-time Bitcoin blockchain and mempool data through the mempool.space APIs, offering tools for accessing network statistics, price information, transaction details, block data, mining pools information, and address tracking.
Supports retrieving Bitcoin price data in various fiat currencies through the get-price tool.
Enables connecting to a local Bitcoin node running on Umbrel for privacy and unlimited API calls by configuring the MEMPOOL_BASE_URL environment variable.
🚀 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. |
🤖 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
Clone this repository:
git clone https://github.com/alexandresanlim/mempool-mcp-server.git
Install and build:
npm install
npm run build
npm run server
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!
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
A Model Context Protocol server that provides real-time Bitcoin blockchain and mempool data to AI clients, allowing access to comprehensive Bitcoin network information through various data tools.
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol server providing tools for querying Bitcoin blockchain data via Blockchain Data and Query APIs, supporting various BTC information retrieval functions.Last updated -1
- AsecurityFlicenseAqualityA Model Context Protocol server that provides access to CoinMarketCap's cryptocurrency data, enabling AI applications to retrieve cryptocurrency listings, quotes, and detailed information.Last updated -33
Satstream MCP Serverofficial
AsecurityAlicenseAqualityA 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.Last updated -37MIT License