Bitcoin UTXO

An MCP server that tracks Bitcoin's Unspent Transaction Outputs (UTXO) and block statistics.

python

2

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "kukapay-bitcoin-utxo-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/bitcoin-utxo-mcp",
        "run",
        "main.py"
      ]
    }
  }
}

Bitcoin UTXO MCP is an MCP server that tracks Bitcoin’s Unspent Transaction Outputs (UTXO) and block statistics, giving AI agents direct access to essential on-chain data to support analysis and decision making.

How to use

You access the Bitcoin UTXO MCP through an MCP-compatible client. Use the provided tools to fetch UTXO data for a Bitcoin address and to retrieve statistics for a specific block. You can then run the prompt template to analyze funds flow and network health based on the retrieved data.

How to install

Prerequisites: Python 3.10 or higher and uv.

Install the MCP using the following steps and commands.

Clone the repository and navigate into the project folder.

Install and synchronize dependencies with uv.

Install the MCP as a Claude Desktop application using uv with the exact command shown.

uv sync

uv run mcp install main.py --name "Bitcoin UTXO"

Configuration example you can reference when wiring the MCP into your client setup.

{
   "mcpServers": {
       "Bitcoin UTXO": {
           "command": "uv",
           "args": [ "--directory", "/path/to/bitcoin-utxo-mcp", "run", "main.py" ]
       }
   }
}

Additional notes

Replace /path/to/bitcoin-utxo-mcp with your actual installation path. The setup installs the MCP server as a local stdio process that you control from your MCP client. If you intend to run the server under a different directory, adjust the directory argument accordingly.

Tools and prompts overview

Tools available from this MCP server include get_utxo and get_block_stats. A reusable prompt template analyze_bitcoin_flow helps you request insights about funds flow, network health, and potential market impacts based on the retrieved UTXO and block data.

Available tools

get_utxo

Retrieves UTXO details for a given Bitcoin address, including the number of UTXOs, total value in BTC, and UTXO details.

get_block_stats

Fetches transaction statistics for a specific Bitcoin block, including block hash, transaction count, total value, and block time.