Labsco
MCP SERVER · OFFICIAL PROJECT

AIBTC Bitcoin Wallets

by aibtcdev

Gives an agent its own Bitcoin and Stacks wallet, and a wide tool surface to use it with — payments, sBTC, DeFi, stacking, ordinals, BNS and x402 paid APIs.

Wallets, Signing & Transaction ExecutionOfficial source
Summary
An agent with a wallet of its own, and a tool surface wide enough to spend, lend, swap and stake from it.

Read the guardrails before the feature list: the keystore is encrypted behind a password you set, the wallet auto-locks after 15 minutes, and the bridge will run read-only with individual write tools allowed by name. Start on testnet — the install command takes --testnet — and read the safety receipt it prints before letting a loop run.

What it is

A Bitcoin-native server for agents: an encrypted local wallet plus a wide tool surface over Bitcoin L1, Lightning, Stacks L2 and the protocols built on them.

What you get
  • A wallet of the agent's own: create it or import a BIP39 mnemonic, unlock with a password, lock, switch between wallets, export the mnemonic, rotate the password, and set the auto-lock timeout
  • Bitcoin L1: balances, fee estimates, UTXOs separated into cardinal and ordinal, transfers, mempool statistics, transaction status and address history
  • Lightning through an embedded Spark wallet: create or import one, fund it from L1 BTC, create BOLT-11 invoices and pay them
  • Stacks L2: STX balances and transfers, contract calls, contract deploys, read-only calls, and account, block, mempool and contract queries
  • sBTC end to end: balance and transfers, deposits from BTC, peg-out withdrawals with status tracking, and peg supply information
  • SIP-010 tokens and SIP-009 NFTs: balances, metadata, holders, transfers, holdings and collection history
  • Stacking and PoX: cycle information, stacking status, locking and extending, Dual Stacking enrolment with sBTC rewards, and the Stackspot lottery pots
  • DeFi across ALEX, Bitflow and Zest: quotes, routes, swaps, pool data, supplying, borrowing, repaying and collateral, plus automated orders through Bitflow Keeper
  • The Pillar smart wallet, both browser-confirmed and agent-signed: fund, send, supply, leverage and unwind, auto-compound, and DCA partners and schedules
  • A yield dashboard across protocols, and an autonomous yield hunter that watches a threshold and rebalances
  • BNS .btc domains: lookup, reverse lookup, availability, price, and either one-transaction or two-step registration
  • X402 paid APIs: list known endpoints, probe one for its cost without paying, execute with payment handled, and scaffold your own paid API as a Cloudflare Worker
  • Ordinals and inscriptions: holdings by address, Magic Eden listings and purchases, and a P2P trade ledger with offers, counters and PSBT swaps
  • Nostr: derive the public key from the wallet, post notes, read feeds, search hashtags, and read or update a profile
  • Prediction markets on Stacks Market, token and wallet analytics from Tenero, and nonce diagnostics for when a transaction gets stuck
Requirements

No account to register — but a wallet with a password you choose, and a mnemonic that is the only recovery path. Keys live under ~/.aibtc/, encrypted with AES-256-GCM and Scrypt, with file permissions set to owner-only; the wallet auto-locks after 15 minutes unless wallet_set_timeout says otherwise. Install with npx @aibtc/mcp-server@latest --install, which has variants for Claude Desktop, Cursor, Windsurf, Gemini CLI, Codex and VS Code. NETWORK chooses mainnet or testnet (mainnet by default) and --testnet on the install command wires up the testnet variant. The bundled bridge can run read-only with individual write tools allowed by name, and prints a safety receipt to stderr — network, read-only status, exposed, write and blocked tool counts, and the session spend cap — before any agent loop begins.

Setup effort

One command — npx @aibtc/mcp-server@latest --install