bitcoin-mcp

What This Skill Does

The bitcoin-mcp skill is an extensive toolkit providing your AI agent with deep-level interaction capabilities for the Bitcoin network. Rather than requiring you to maintain a local full node or manage complex RPC connections, this skill leverages the robust Satoshi API to deliver instant, actionable data. It equips your agent with 47 distinct tools ranging from high-level market metrics to granular transaction analysis. Whether you are tracking mempool congestion, performing forensic examination on partially signed transactions (PSBTs), or simply checking the current network hash rate, this skill serves as the comprehensive bridge between your AI agent and the blockchain.

Installation

To integrate this skill into your OpenClaw environment, add the following configuration to your openclaw.json file:

"mcpServers": {
  "bitcoin": {
    "command": "uvx",
    "args": ["bitcoin-mcp"]
  }
}

Alternatively, you can run the installation command directly: clawhub install openclaw/skills/skills/bortlesboat/bitcoin-mcp. This tool uses uvx for execution, ensuring a clean, ephemeral, and isolated environment that does not pollute your global Python dependencies.

Use Cases

This skill is perfect for developers building financial agents, security researchers auditing transactions, and everyday users who need real-time data for trading or mining. You can automate fee estimation to ensure transactions confirm in the next block, analyze UTXO sets for address privacy, decode complex Lightning Network invoices, or monitor the progression of the current block halving cycle. It is also an essential tool for PSBT security, allowing your agent to audit transactions before you sign them.

Example Prompts

1. "Analyze the current mempool congestion and recommend the optimal sat/vB rate to ensure my transaction confirms within two blocks."
2. "Look up the balance and UTXO count for address bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh. Also, check if there are any pending transactions associated with it."
3. "Decode this BOLT11 invoice [insert string] and provide me with the payment amount in BTC and the expiration time."

Tips & Limitations

Because this tool relies on the Satoshi API, ensure your environment has active internet access. While the skill is powerful, it is an analytical tool—it cannot sign transactions for you, which is a significant safety feature. Always double-check critical financial transactions in an offline-signed environment. For high-frequency data needs, cache results locally to avoid unnecessary API lookups.