get_utxo
Retrieve Unspent Transaction Outputs (UTXOs) for any Bitcoin address to check available balance and transaction details.
Instructions
Get UTXO for a Bitcoin address.
Args:
address (str): Bitcoin address (base58 or bech32 format)
Returns:
A string containing:
- Address
- Number of UTXOs
- Total value in BTC
- List of UTXO details (txid, value, confirmations)Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- main.py:10-42 (handler)The handler function for the 'get_utxo' tool. It is decorated with @mcp.tool() for registration and implements the logic to fetch unspent transaction outputs (UTXOs) for a given Bitcoin address using the blockchain.info API, processes the data, and returns a formatted string summary.
@mcp.tool() async def get_utxo(address: str) -> str: """Get UTXO for a Bitcoin address. Args: address (str): Bitcoin address (base58 or bech32 format) Returns: A string containing: - Address - Number of UTXOs - Total value in BTC - List of UTXO details (txid, value, confirmations) """ async with httpx.AsyncClient() as client: try: response = await client.get(f"https://blockchain.info/unspent?active={address}") response.raise_for_status() data = response.json() utxos = data.get("unspent_outputs", []) total_value = sum(u['value'] for u in utxos) / 1e8 utxo_details = "\n".join( f"- TXID: {u['tx_hash_big_endian']}, Value: {u['value'] / 1e8:.8f} BTC, Confirmations: {u['confirmations']}" for u in utxos ) return ( f"Address {address}:\n" f"{len(utxos)} UTXOs\n" f"Total Value: {total_value:.8f} BTC\n" f"UTXO Details:\n{utxo_details}" ) except Exception as e: return f"Error fetching UTXO: {str(e)}"