Command Palette

Search for a command to run...

UnylyUnyly
Browse all

kukapay/bitcoin-utxo-mcp

FreeNot checked

Track Bitcoin unspent transaction outputs (UTXOs) and block statistics.

GitHubEmbed

About

Track Bitcoin unspent transaction outputs (UTXOs) and block statistics.

README

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

GitHub License Python Version Status

Features

  • 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.

Installation

Prerequisites

Setup

  1. Clone the Repository:

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

    uv sync
    
  3. 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.

Usage

Available Tools and Prompts

  • Tools:
    • get_utxo(address: str): Returns UTXO details for a Bitcoin address, e.g., "Address 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa: 50 UTXOs, Total Value: 50.00000000 BTC, UTXO Details: ...".
    • get_block_stats(block_height: int): Returns block statistics, e.g., "Block Height: 0, Block Hash: 000000000019d668..., Transactions: 1, Total Value: 50.00000000 BTC, Block Time: 1231006505".
  • Prompt:
    • analyze_bitcoin_flow(): Generates a prompt for LLMs to analyze UTXO and block data, e.g., "Analyze the provided Bitcoin UTXO and block data: What do the UTXO distributions indicate about funds flow? ...".

Example Interaction

Below are examples of natural language prompts you might use in an MCP-compatible client (e.g., Claude Desktop) and the corresponding outputs from the server, based on hypothetical Blockchain.com API responses.

  1. Get UTXO for a Bitcoin Address:

    • Prompt: "Show me the UTXO details for the Bitcoin genesis address."
    • Command: get_utxo("1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa")
    • Output:
      Address 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa:
      50 UTXOs
      Total Value: 50.00000000 BTC
      UTXO Details:
      - TXID: 4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b, Value: 50.00000000 BTC, Confirmations: 800000
      
  2. Get Block Statistics:

    • Prompt: "What's the transaction data for the Bitcoin genesis block?"
    • Command: get_block_stats(0)
    • Output:
      Block Height: 0
      Block Hash: 000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f
      Transactions: 1
      Total Value: 50.00000000 BTC
      Block Time: 1231006505
      
  3. Analyze Bitcoin Flow:

    • Prompt: "Analyze Bitcoin funds flow and network health."
    • Command: analyze_bitcoin_flow()
    • Output (prompt sent to LLM for analysis):
      Analyze the provided Bitcoin UTXO and block data:
      - What do the UTXO distributions indicate about funds flow?
      - How does the block statistics reflect network health (e.g., transaction volume, congestion)?
      - Provide insights on potential market impacts or trends.
      
      • LLM Response (example, depends on the LLM):
        The UTXO distribution for the queried address shows a significant number of unspent outputs, indicating long-term holding behavior, possibly by an early adopter. The genesis block's single transaction with 50 BTC reflects the initial reward structure. Current block statistics suggest stable network health with consistent transaction volumes. High UTXO consolidation may signal preparation for large transfers, potentially impacting market liquidity if moved. Historically, such patterns precede price volatility.
        

License

This project is licensed under the MIT License. See the LICENSE file for details.

from github.com/kukapay/bitcoin-utxo-mcp

Installing kukapay/bitcoin-utxo-mcp

This server has no published package — it is built from source. Open the repository and follow its README.

▸ github.com/kukapay/bitcoin-utxo-mcp

FAQ

Is kukapay/bitcoin-utxo-mcp MCP free?

Yes, kukapay/bitcoin-utxo-mcp MCP is free — one-click install via Unyly at no cost.

Does kukapay/bitcoin-utxo-mcp need an API key?

No, kukapay/bitcoin-utxo-mcp runs without API keys or environment variables.

Is kukapay/bitcoin-utxo-mcp hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install kukapay/bitcoin-utxo-mcp in Claude Desktop, Claude Code or Cursor?

Open kukapay/bitcoin-utxo-mcp on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

$5

Stripe

Payments, customers, subscriptions

Stripeby Stripe

malamutemayhem/unclick-agent-native-endpoints

110+ tools for AI agents spanning social media, finance, gaming, music, AU-specific services, and utilities. Zero-config local tools plus platform connectors. n

malamutemayhemby malamutemayhem

whiteknightonhorse/APIbase

API hub covering travel (Amadeus, Sabre), Polymarket prediction markets, crypto and weather, paid per call via x402 in USDC.

whiteknightonhorseby whiteknightonhorse

trackerfitness729-jpg/sitelauncher-mcp-server

Deploy live HTTPS websites on subdomains or custom .xyz domains, paid in USDC on Base, with templates for crypto tokens and AI agent profiles.

trackerfitness729-jpgby trackerfitness729-jpg

embeddedlayers/mcp-analytics

Statistical analysis, forecasting and ML on CSV files or live data from Shopify, Stripe, GA4 and more, with interactive HTML reports.

embeddedlayersby embeddedlayers

carrierone/verilexdata-mcp

Pay-per-query x402 datasets: NPI healthcare, SEC filings, OFAC sanctions, crypto whales, Polymarket signals, patents and economic indicators.

carrieroneby carrierone

paracetamol951/P-Link-MCP

HTTP 402 (Payment Required) implementation using Solana.

paracetamol951by paracetamol951

tipdotmd/tip-md-x402-mcp-server

Cryptocurrency tipping using the x402 payment protocol and CDP Wallet.

tipdotmdby tipdotmd

laundromatic/shopgraph

Structured product data from the open web — Schema.org + AI extraction for e-commerce enrichment. Pay per call via Stripe. [shopgraph.dev](https://shopgraph.dev

laundromaticby laundromatic

mrslbt/xendit-mcp

Xendit payment gateway for Southeast Asia: invoices, disbursements, balance checks and bank transfers.

mrslbtby mrslbt

Compare kukapay/bitcoin-utxo-mcp with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All finance MCPs