get_address_utxos
Scan Bitcoin's UTXO set to find all unspent transaction outputs for a specific address. Use this tool to identify available funds and verify address balances by examining the blockchain's complete unspent output data.
Instructions
Scan the UTXO set for all unspent outputs belonging to an address. Note: scans full UTXO set, may take minutes.
Args: address: Bitcoin address to scan
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- src/bitcoin_mcp/server.py:818-829 (handler)The implementation of the 'get_address_utxos' tool, which uses 'scantxoutset' via the RPC client to find UTXOs for a given address.
def get_address_utxos(address: str) -> str: """Scan the UTXO set for all unspent outputs belonging to an address. Note: scans full UTXO set, may take minutes. Args: address: Bitcoin address to scan """ try: result = get_rpc().scantxoutset("start", [f"addr({address})"]) except Exception as e: return json.dumps({"error": str(e)}) return json.dumps(result)