get_utxo_set_info
Retrieve Bitcoin UTXO set statistics including total UTXOs, circulating supply, and disk storage size. This operation typically requires 1-2 minutes to complete on local nodes.
Instructions
Get UTXO set statistics: total UTXOs, total supply, disk size. Note: this is a slow operation (1-2 minutes on local nodes, may vary on hosted API).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- src/bitcoin_mcp/server.py:621-631 (handler)The tool 'get_utxo_set_info' is defined here as an MCP tool. It calls the 'gettxoutsetinfo' method on the RPC connection and returns a JSON summary of the UTXO set statistics.
@mcp.tool() def get_utxo_set_info() -> str: """Get UTXO set statistics: total UTXOs, total supply, disk size. Note: this is a slow operation (1-2 minutes on local nodes, may vary on hosted API).""" info = get_rpc().gettxoutsetinfo() return json.dumps({ "height": info["height"], "txouts": info["txouts"], "total_amount": info["total_amount"], "disk_size": info["disk_size"], "hash_serialized_2": info.get("hash_serialized_2", ""), })