Bitcoin SegWit/Taproot UTXO Dust Consolidation & Fee-Window Planner
plan_bitcoin_utxo_consolidationAnalyzes a set of Bitcoin UTXO balances in satoshis to compute exact vByte transaction weight, identify uneconomical dust inputs, and recommend whether to consolidate now or hold. Use when optimizing on-chain Bitcoin treasury UTXO sets to minimize long-term miner fee drag; for fetching current live Bitcoin mempool sat/vB feerates alone, use estimate_bitcoin_mempool_fees instead. Stateless read-only edge call (max 32 KB, 60 RPM): accepts 'utxos_sats_json' ('script_type' defaults to 'p2wpkh_segwit'), supports '?demo=true' or L402 (20 sats), and returns HTTP 400 if invalid.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"utxos_sats_json": "<utxos_sats_json>"
},
"name": "plan_bitcoin_utxo_consolidation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| script_type | No | Bitcoin input script type determining vByte weight per input; defaults to 'p2wpkh_segwit' when omitted. | |
| utxos_sats_json | Yes | JSON array or comma-separated list of UTXO values in satoshis (e.g. '[1200, 45000, 85000]'). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| utxo_count | Yes | Number of UTXO inputs analyzed. | |
| recommended_action | Yes | Execution timing advice ('CONSOLIDATE_NOW' or 'HOLD_UNTIL_SUB_15_SAT_VB'). | |
| high_fee_dust_utxos | Yes | Count of UTXOs whose input weight costs more than 3% of their value. | |
| estimated_consolidation_vbytes | Yes | Total virtual byte (vB) size of the consolidation transaction. |