AgentSkillsCN

aibtc-bitcoin-wallet

面向智能体的比特币L1钱包——查询余额、发送BTC、管理UTXO。同时支持Stacks L2（STX、DeFi）以及Pillar智能钱包（sBTC收益）。

SKILL.md
--- frontmatter
name: aibtc-bitcoin-wallet
description: Bitcoin L1 wallet for agents - check balances, send BTC, manage UTXOs. Extends to Stacks L2 (STX, DeFi) and Pillar smart wallets (sBTC yield).
license: MIT
metadata:
  author: aibtcdev
  version: 1.9.0
  npm: "@aibtc/mcp-server"
  github: https://github.com/aibtcdev/aibtc-mcp-server

AIBTC Bitcoin Wallet

A skill for managing Bitcoin L1 wallets with optional Pillar smart wallet and Stacks L2 DeFi capabilities.

Install

One-command installation:

bash
npx @aibtc/mcp-server@latest --install

For testnet:

bash
npx @aibtc/mcp-server@latest --install --testnet

Quick Start

Check Balance

Get your Bitcoin balance:

code
"What's my BTC balance?"

Uses get_btc_balance - returns total, confirmed, and unconfirmed balances.

Check Fees

Get current network fee estimates:

code
"What are the current Bitcoin fees?"

Uses get_btc_fees - returns fast (~10 min), medium (~30 min), and slow (~1 hr) rates in sat/vB.

Send BTC

Transfer Bitcoin to an address:

code
"Send 50000 sats to bc1q..."
"Transfer 0.001 BTC with fast fees to bc1q..."

Uses transfer_btc - requires an unlocked wallet.

Wallet Setup

Before sending transactions, set up a wallet:

  1. •Create new wallet: wallet_create - generates encrypted BIP39 mnemonic
  2. •Import existing: wallet_import - import from mnemonic phrase
  3. •Unlock for use: wallet_unlock - required before transactions

Wallets are stored encrypted at ~/.aibtc/.

Tool Reference

Read Operations

ToolDescriptionParameters
get_btc_balanceGet BTC balanceaddress (optional; requires unlocked wallet if omitted)
get_btc_feesGet fee estimatesNone
get_btc_utxosList UTXOsaddress (optional; requires unlocked wallet if omitted), confirmedOnly

Write Operations (Wallet Required)

ToolDescriptionParameters
transfer_btcSend BTCrecipient, amount (sats), feeRate

Wallet Management

ToolDescription
wallet_createGenerate new encrypted wallet
wallet_importImport wallet from mnemonic
wallet_unlockUnlock wallet for transactions
wallet_lockLock wallet (clear from memory)
wallet_listList available wallets
wallet_switchSwitch active wallet
wallet_statusGet wallet/session status

Units and Addresses

Amounts: Always in satoshis (1 BTC = 100,000,000 satoshis)

Addresses:

  • •Mainnet: bc1... (native SegWit)
  • •Testnet: tb1...

Fee Rates: "fast", "medium", "slow", or custom sat/vB number

Example Workflows

Daily Balance Check

code
1. "What's my BTC balance?"
2. "Show my recent UTXOs"
3. "What are current fees?"

Send Payment

code
1. "Unlock my wallet" (provide password)
2. "Send 100000 sats to bc1qxyz... with medium fees"
3. "Lock my wallet"

Multi-Wallet Management

code
1. "List my wallets"
2. "Switch to trading wallet"
3. "Unlock it"
4. "Check balance"

Progressive Layers

This skill focuses on Bitcoin L1. Additional capabilities are organized by layer:

Stacks L2 (Layer 2)

Bitcoin L2 with smart contracts and DeFi:

  • •STX token transfers
  • •ALEX DEX token swaps
  • •Zest Protocol lending/borrowing
  • •x402 paid API endpoints (AI, storage, utilities)

See: references/stacks-defi.md

Pillar Smart Wallet (Layer 3)

sBTC smart wallet with yield automation:

  • •Passkey or agent-signed transactions
  • •Send to BNS names (alice.btc)
  • •Auto-boost yield via Zest Protocol

See: references/pillar-wallet.md

Troubleshooting

"Wallet not unlocked"

Run wallet_unlock with your password before sending transactions.

"Insufficient balance"

Check get_btc_balance - you need enough BTC for amount + fees.

"Invalid address"

Ensure address matches network:

  • •Mainnet: starts with bc1
  • •Testnet: starts with tb1

See: references/troubleshooting.md

More Information

This skill follows the Agent Skills open specification.