Aibtc MCP Server

Bitcoin-native MCP server for AI agents: BTC/STX wallets, DeFi yield, sBTC peg, NFTs, and x402 payments.

Local serverstdio

What is the Aibtc MCP Server?

Bitcoin-native MCP server for AI agents: BTC/STX wallets, DeFi yield, sBTC peg, NFTs, and x402 payments.

What it actually does

The aibtc-bitcoin-wallet skill provides: - Structured workflows for Bitcoin L1 operations (balance, send, fees) - Reference guides for Pillar smart wallets and Stacks L2 DeFi - LLM-agnostic instructions that work with Claude Code, Cursor, Codex, and 20+ other tools

  • Bitcoin L1 — - Check balances, send BTC, manage UTXOs via mempool.space
  • Agent's Own Wallet — - Agents get their own wallet to perform blockchain transactions
  • Secure Storage — - Wallets encrypted with AES-256-GCM and stored locally
  • 150+ Tools — - Bitcoin L1 + comprehensive Stacks L2 operations
  • sBTC Support — - Native Bitcoin on Stacks operations
  • Token Operations — - SIP-010 fungible token transfers and queries

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
GroupTools
walletWallet management extras, encrypted credential store
stacksStacks transactions, contracts, tokens, NFTs, chain queries, nonce tools
sbtcsBTC deposit/withdraw, Styx BTC→sBTC
bitcoinBitcoin L1 UTXOs, mempool watch
lightningLightning (Spark) wallet and L402 payments
stackingPoX stacking, dual stacking, StackSpot
defiALEX, Zest, Bitflow, Jingswap, yield hunter/dashboard, Tenero analytics
pillarPillar smart wallet
ordinalsInscriptions, runes, PSBT, ordinals marketplace/P2P, taproot multisig
bnsBNS names
identityERC-8004 identity and reputation, message signing
socialNostr, AIBTC inbox
earnBounty board (create, accept, pay, my views)
legionAIBTC News Legion
marketsStacks prediction market, At Stake
devScaffolding, OpenRouter, settings, inference marketplace, arXiv
wallet_createCreate a new wallet for Claude
wallet_importImport an existing wallet for Claude
wallet_unlockUnlock Claude's wallet
wallet_lockLock Claude's wallet
wallet_listList Claude's available wallets
wallet_switchSwitch Claude to a different wallet
wallet_deleteDelete a wallet
wallet_exportExport wallet mnemonic
wallet_statusCheck if Claude's wallet is ready (includes Stacks and Bitcoin addresses)
wallet_set_timeoutSet how long wallet stays unlocked
get_btc_balanceGet BTC balance (total, confirmed, unconfirmed)
get_btc_feesGet fee estimates (fast, medium, slow)
get_btc_utxosList UTXOs for an address
transfer_btcSend BTC to a recipient
get_cardinal_utxosUTXOs safe to spend (no inscriptions)
get_ordinal_utxosUTXOs containing inscriptions
get_btc_mempool_infoGet current Bitcoin mempool statistics (tx count, vsize, fees, fee histogram)
get_btc_transaction_statusGet confirmation status and details for a Bitcoin transaction by txid
get_btc_address_txsGet recent transaction history for a Bitcoin address (last 25 transactions)
get_taproot_addressGet wallet's Taproot (P2TR) address
estimate_inscription_feeCalculate inscription cost
inscribeCreate inscription commit transaction
inscribe_revealComplete inscription reveal transaction
get_inscriptionFetch inscription content from reveal tx
get_inscriptions_by_addressList inscriptions owned by address
psbt_create_ordinal_buyBuild a buyer-side PSBT for ordinal purchase
psbt_signSign selected PSBT inputs with active wallet keys
psbt_decodeDecode PSBT inputs/outputs/signature status
psbt_broadcastFinalize and broadcast a fully-signed PSBT
sip018_signSign structured Clarity data (SIP-018)
sip018_verifyVerify SIP-018 signature
sip018_hashCompute SIP-018 hash without signing
stacks_sign_messageSign plain text (SIWS-compatible)
stacks_verify_messageVerify Stacks message signature
btc_sign_messageSign with Bitcoin key (BIP-137)
btc_verify_messageVerify BIP-137 signature
get_wallet_infoGet Claude's wallet addresses (Stacks + Bitcoin) and status
get_stx_balanceGet STX balance for any address
get_stx_feesGet STX fee estimates (low, medium, high)
transfer_stxSend STX to a recipient
broadcast_transactionBroadcast a pre-signed transaction
sbtc_get_balanceGet sBTC balance
sbtc_transferSend sBTC
sbtc_initiate_withdrawalInitiate sBTC peg-out to BTC L1
sbtc_withdrawAlias for withdrawal initiation
sbtc_withdrawal_statusCheck withdrawal request status
sbtc_get_deposit_infoGet BTC deposit instructions
sbtc_depositBuild, sign, and broadcast BTC→sBTC deposit
sbtc_deposit_statusCheck deposit status via Emily API
sbtc_get_peg_infoGet peg ratio and TVL
get_token_balanceGet balance of any SIP-010 token
transfer_tokenSend any SIP-010 token
get_token_infoGet token metadata
list_user_tokensList tokens owned by an address
get_token_holdersGet top holders of a token
get_nft_holdingsList NFTs owned by an address
get_nft_metadataGet NFT metadata
transfer_nftSend an NFT
get_nft_ownerGet NFT owner
get_collection_infoGet NFT collection details
get_nft_historyGet NFT transfer history
get_pox_infoCurrent PoX-5 cycle, burn height, prepare phase
get_stacking_statusLocked amount, signer manager, unlock height
list_stacking_signersSigner managers in the next cycle's signer set
stack_stxLock STX with a signer manager
extend_stackingExtend, increase, switch signer or payout (stake-update)
unstake_stxStop early; unlocks next cycle
get_stacking_rewardsUnclaimed sBTC rewards for a cycle
claim_stacking_rewardsClaim a cycle's rewards through the signer manager
lookup_bns_nameResolve .btc domain to address
reverse_bns_lookupGet .btc domain for an address
get_bns_infoGet domain details
check_bns_availabilityCheck if domain is available
get_bns_priceGet registration price
list_user_domainsList domains owned
preorder_bns_namePreorder a .btc domain (step 1 of 2)
register_bns_nameRegister a .btc domain (step 2 of 2)
call_contractCall a smart contract function
deploy_contractDeploy a Clarity smart contract
get_transaction_statusCheck transaction status
call_read_only_functionCall read-only function
alex_list_poolsDiscover all available trading pools
alex_get_swap_quoteGet expected output for a token swap
alex_swapExecute a token swap (SDK handles routing)
alex_get_pool_infoGet liquidity pool reserves
zest_list_assetsList all supported lending assets
zest_get_positionGet user's supply/borrow position
zest_supplySupply assets to earn interest
zest_withdrawWithdraw supplied assets
zest_borrowBorrow against collateral
zest_repayRepay borrowed assets
bitflow_get_tickerGet market data (no API key needed)
bitflow_get_quoteGet swap quote
bitflow_swapExecute token swap
pillar_connectConnect to Pillar wallet
pillar_sendSend sBTC to BNS names or addresses
pillar_boostCreate leveraged sBTC position
pillar_positionView wallet and Zest position
get_account_infoGet account nonce, balance
get_account_transactionsList transaction history
get_block_infoGet block details
get_mempool_infoGet pending transactions
get_contract_infoGet contract ABI and source
get_contract_eventsGet contract event history
get_network_statusGet network health status
yield_hunter_startStart autonomous sBTC→Zest deposits
yield_hunter_stopStop yield hunting
yield_hunter_statusCheck yield hunter status
yield_hunter_configureAdjust threshold, reserve, interval
list_x402_endpointsDiscover x402 endpoints
execute_x402_endpointExecute x402 endpoint with auto-payment
scaffold_x402_endpointGenerate x402 Cloudflare Worker project
scaffold_x402_ai_endpointGenerate x402 AI API with OpenRouter

How to install the Aibtc MCP Server

{
  "mcpServers": {
    "aibtc": {
      "command": "npx",
      "args": [
        "-y",
        "@aibtc/mcp-server@latest"
      ],
      "env": {
        "NETWORK": "mainnet"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
NETWORKDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Aibtc to list x402 endpoints.”
  • “Use Aibtc to execute x402 endpoint.”
  • “Use Aibtc to scaffold x402 endpoint.”

Frequently asked questions

Bitcoin-native MCP server for AI agents: BTC/STX wallets, DeFi yield, sBTC peg, NFTs, and x402 payments. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.