bitcoin-utxo-mcp

An MCP server that tracks Bitcoin's Unspent Transaction Outputs (UTXO) and block statistics, giving AI agents direct access to essential on-chain data.

• Tools:
• get_utxo: Retrieves UTXO details for a given Bitcoin address, including the number of UTXOs, total value in BTC, and transaction details.
• get_block_stats: Fetches transaction statistics for a specific Bitcoin block, including block hash, transaction count, total value, and block time.
• Prompt:
• analyze_bitcoin_flow: A reusable prompt template for LLMs to analyze Bitcoin funds flow, network health, and potential market impacts based on UTXO and block data.

• Python: Version 3.10 or higher
• uv: A fast and modern Python package manager (installation instructions)

1. Clone the Repository:

   git clone https://github.com/kukapay/bitcoin-utxo-mcp.git
   cd bitcoin-utxo-mcp

1. Install dependencies:

   uv sync

1. Install to Claude Desktop:

Install the server as a Claude Desktop application:

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

Configuration file as a reference:

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

Replace /path/to/bitcoin-utxo-mcp with your actual installation path.

• Tools:
• get_utxo(address: str): Returns UTXO details for a Bitcoin address, e.g., "Address 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa: 50 UTXOs, Total Value