288 tools from the Aibtc MCP Server, categorised by risk level.
View the Aibtc policy →alex_get_pool_info Get liquidity pool information from ALEX DEX.
Returns reserve balances and pool details for a token pair.
Note: ALEX DEX is only available on mai... alex_get_swap_quote Get a swap quote from ALEX DEX.
Returns the expected output amount for swapping tokenX to tokenY.
Use full contract IDs for tokens (e.g., 'SP3K8BC... alex_list_pools List all available trading pools on ALEX DEX.
Discovers all token pairs that can be swapped directly.
Returns pool ID, token pair, and factor (fee... arxiv_list_digests List recent arXiv digest files from ~/.aibtc/arxiv-research/digests/.
Digests are created by the arxiv-research skill's compile subcommand or by r... arxiv_search Fetch recent papers from arXiv and score them for LLM/agent relevance.
Queries the public arXiv Atom API (no API key required). Papers are scored ... bounty_claim Claim a bounty on bounty.drx4.xyz.
Submits a claim for an open bounty. Requires an unlocked wallet with BTC keys.
The request is authenticated via... bounty_get Get full details for a single bounty on bounty.drx4.xyz.
Returns the bounty description, reward amount, tags, status, all claims,
submissions, pay... bounty_list List bounties on the bounty.drx4.xyz sBTC bounty board.
Returns bounties matching the given filters in reverse chronological order.
Filters:
- st... bounty_match Score open bounties against an agent's capability profile.
Fetches all open bounties and ranks them by tag overlap with the provided
capability_ta... bounty_my_claims List all bounty claims and submissions for the current wallet's BTC address.
Returns the agent profile from bounty.drx4.xyz including all bounties... bounty_stats Get aggregate platform statistics from bounty.drx4.xyz.
Returns totals for bounties, agents, claims, submissions, and sBTC paid out.
No authentic... bounty_status Check the current status of a bounty on bounty.drx4.xyz.
Returns the bounty's current status in the workflow, along with any claims
and submission... broadcast_transaction Broadcast a pre-signed Stacks transaction to the network. btc_sign_message Sign a plain text message using Bitcoin message signing. Automatically selects BIP-322 for native SegWit (bc1q) and Taproot (bc1p) addresses, and B... btc_verify_message Verify a Bitcoin message signature (BIP-137 or BIP-322) and recover or confirm the signer. Auto-detects BIP-137 (65-byte compact) vs BIP-322 (witne... call_contract Call a function on a Stacks smart contract. Signs and broadcasts the transaction.
For typed arguments, use objects like {type: 'uint', value: 100}... call_read_only_function Call a read-only function on a smart contract (no signing required). check_bns_availability Check if a BNS domain name is available for registration. check_relay_health Check the sponsor relay health and nonce status.
Use this tool to diagnose sponsored transaction failures. It will:
- Check relay availability
- I... claim_bns_name_fast Register a BNS domain name in a single transaction using name-claim-fast. This is the RECOMMENDED method — no preorder/register wait needed. Burns ... credentials_get Retrieve a stored credential value by service and key. Returns the decrypted value. WARNING: The returned value is sensitive — do not log or displa... credentials_list List all stored credentials. Shows service names, key names, and last-updated timestamps. Does NOT reveal credential values. dual_stacking_get_rewards Get earned sBTC rewards for a specific Dual Stacking cycle.
Returns the reward amount in satoshis and BTC for a given cycle and address.
The rollb... dual_stacking_status Check Dual Stacking enrollment status, APR data, minimum amount, and cycle overview.
Dual Stacking lets sBTC holders earn BTC-denominated rewards ... extend_stacking Extend an existing stacking lock period. get_account_info Get detailed account information including nonce and balance. get_account_transactions Get transaction history for an account. get_block_info Get information about a specific block. get_bns_info Get detailed information about a BNS domain name. get_bns_price Get the registration price for a BNS domain name. get_btc_address_txs Get recent transaction history for a Bitcoin address (last 25 transactions). Returns a summary of each transaction including confirmation status, f... get_btc_balance Get the BTC balance for a Bitcoin address. Returns both total balance (including unconfirmed) and confirmed balance. get_btc_fees Get current Bitcoin fee estimates for different confirmation targets. Returns fast (~10 min), medium (~30 min), and slow (~1 hour) fee rates in sat... get_btc_mempool_info Get current Bitcoin mempool statistics including transaction count, virtual size, total fees, and fee histogram. Useful for monitoring network cong... get_btc_transaction_status Get confirmation status and details for a Bitcoin transaction by txid. Returns whether the transaction is confirmed, block height, fee, size, and I... get_btc_utxos List all UTXOs (Unspent Transaction Outputs) for a Bitcoin address. Useful for debugging, transparency, and understanding transaction inputs. get_cardinal_utxos Get cardinal UTXOs (safe to spend - no inscriptions). Cardinal UTXOs are regular Bitcoin outputs that do not contain ordinal inscriptions. These UT... get_collection_info Get information about an NFT collection. get_contract_events Get events emitted by a smart contract. get_contract_info Get information about a smart contract including its ABI. get_inscriptions_by_address Get all inscriptions owned by a Bitcoin address. Returns inscription IDs, content types, and metadata. Only available on mainnet (Hiro Ordinals API... get_mempool_info Get pending transactions in the mempool. get_network_status Get the current status of the Stacks network. get_nft_history Get the transfer history of NFTs in a collection. get_nft_holdings List all NFTs owned by an address. get_nft_metadata Get metadata for a specific NFT (SIP-016). get_nft_owner Get the current owner of a specific NFT. get_ordinal_utxos Get ordinal UTXOs (contain inscriptions - do not spend). Ordinal UTXOs contain Bitcoin inscriptions and should not be spent in regular transfers. T... get_pox_info Get current Proof of Transfer (PoX) cycle information. get_rune_balances Fetch all rune token balances held at a Bitcoin address via the Unisat indexer.
Returns rune IDs, amounts, symbols, and divisibility for all runes... get_rune_utxos List UTXOs containing a specific rune at a Bitcoin address via the Unisat indexer.
Rune ID format: 'block:tx' (e.g., '840000:1' for UNCOMMONGOODS)... get_stacking_status Check if an address is currently stacking STX. get_stx_balance Get the STX balance for a wallet address. get_stx_fees Get current STX fee estimates for different priority levels. Returns low, medium, and high fee tiers in micro-STX, based on mempool analysis. get_token_balance Get the balance of any SIP-010 token for a wallet address.
Supports well-known tokens by symbol: sBTC, USDCx, ALEX, DIKO
Or use the full contract ... 2/5 get_token_holders Get the top holders of a SIP-010 token. 2/5 get_token_info Get metadata for a SIP-010 token (name, symbol, decimals, supply). 2/5 get_transaction_status Check the status of a Stacks transaction by its txid. get_wallet_info Get the agent's wallet address and status. If the agent doesn't have a wallet yet, provides guidance on how to assign one. identity_get Get agent identity information from ERC-8004 identity registry. Returns owner address, URI, and wallet address if set. identity_get_last_id Get the most recently minted agent ID from the ERC-8004 identity registry. Returns null if no agents have been registered. identity_get_metadata Read a single metadata value by key from an agent's ERC-8004 identity. Returns the raw buffer value as a hex string. jingswap_get_cycle_state Get the current Jingswap auction cycle state including phase (deposit/buffer/settle), blocks elapsed, cycle totals (token B + sBTC deposited), and ... jingswap_get_cycles_history Get the full history of all auction cycles from cycle 0 to the current cycle. Each entry includes settlement data (if settled) and cycle totals. Us... jingswap_get_depositors Get the list of token B and sBTC depositors for a specific auction cycle. Returns arrays of Stacks addresses on each side. Max 50 depositors per side. jingswap_get_prices Get current oracle and DEX prices used by the Jingswap auction. Returns Pyth oracle prices (BTC/USD, STX/USD with confidence and freshness), on-cha... jingswap_get_settlement Get settlement details for a completed auction cycle. Returns clearing price, amounts cleared, fees, and the block height at which settlement occur... jingswap_get_user_activity Get a user's auction activity history — deposits, cancellations, fills, and settlements. Indexed from on-chain contract events. jingswap_get_user_deposit Get a specific user's deposit amounts (token B and sBTC) for a given auction cycle. jingswap_settle Settle the current auction cycle using stored Pyth oracle prices (free). WARNING: This will almost always fail because stored prices go stale quick... list_user_domains List all BNS domains owned by an address. list_user_tokens List all fungible tokens owned by an address. list_x402_endpoints List known x402 API endpoints from x402.biwas.xyz, x402.aibtc.com, stx402.com, aibtc.com.
The agent can:
1. Execute x402 endpoints from these sour... lookup_bns_name Resolve a .btc domain name to its Stacks address. news_check_status Check the news standing for a BTC address on aibtc.news.
Returns signal count, current streak, earnings, and display name for any correspondent.
I... news_file_signal File a signal on a beat at aibtc.news.
Requires an unlocked wallet with a P2WPKH (bc1q) BTC address. The tool
automatically signs the request usin... news_front_page Get the latest compiled intelligence brief from aibtc.news.
Returns the most recent daily brief, including the compiled text, metadata, and
Bitcoi... news_leaderboard Get ranked correspondents from aibtc.news with signal counts, streaks, and resolved display names.
Returns the full correspondent leaderboard sort... news_list_beats List all registered beats on aibtc.news.
Beats are topic areas that correspondents file signals under (e.g. "btc-macro",
"dao-watch", "agent-intel... news_list_signals Browse the aibtc.news signal feed. Returns signals in reverse chronological order.
Supports optional filters:
- beat: filter by beat slug (e.g. "b... nonce_health Check the sender nonce health for the active wallet.
Compares the local nonce tracker state (persisted at ~/.aibtc/nonce-state.json)
against the c... nostr_get_profile Get a Nostr profile (kind:0 metadata) for any public key. No wallet required. nostr_get_pubkey Derive the Nostr public key from the active wallet. Uses the NIP-06 derivation path (m/44'/1237'/0'/0/0). Returns both hex pubkey and npub (bech32)... nostr_read_feed Read recent kind:1 notes from Nostr relays. Optionally filter by author pubkey. No wallet required. nostr_relay_list List the configured default Nostr relay URLs. No wallet required. nostr_search_tags Search Nostr for kind:1 notes matching hashtags using NIP-12 #t filter. No wallet required. nostr_sign_event Sign a Nostr event (NIP-01) using BIP-340 Schnorr. Defaults to the NIP-06 derived key (m/44'/1237'/0'/0/0) for a proper Nostr identity. Use keySour... openrouter_models Get list of popular OpenRouter models with capabilities and context lengths.
Use this to choose the right model for your use case. For latest pric... ordinals_buy Buy a listed inscription from Magic Eden.
Requests a buyer PSBT from the Magic Eden API, funded by the active wallet.
Returns a PSBT that combines... ordinals_get_listings Browse ordinals/inscriptions listed for sale on Magic Eden.
Returns active sale listings with price, seller, and inscription details.
Supports fil... 2/5 ordinals_list_for_sale List a wallet inscription for sale on Magic Eden.
Requests a PSBT-based listing transaction from the Magic Eden API.
The seller signs the PSBT to ... ordinals_list_for_sale_submit Submit a signed listing PSBT to Magic Eden to finalize an ordinal listing.
Call this after signing the PSBT returned by ordinals_list_for_sale.
Th... ordinals_p2p_agents List active agents registered on the ordinals P2P trade ledger.
Returns agents that have participated in trades, along with their trade counts
and... ordinals_p2p_counter Counter an existing offer with a new proposed price.
Submits a counter-offer linked to a parent trade. The active wallet signs the
counter with BI... ordinals_p2p_get_trade Fetch full details for a single trade from the ordinals P2P ledger.
Returns the trade record including all counters, transfer history, and current... ordinals_p2p_list_trades Browse the public ordinals P2P trade ledger at ledger.drx4.xyz.
Returns a paginated list of trades with optional filters. Useful for discovering
o... ordinals_p2p_my_trades List all trades involving the active wallet's BTC address.
Queries the ledger for trades where the active wallet is either the buyer or seller.
Re... ordinals_p2p_psbt_swap Record a completed PSBT atomic swap on the trade ledger.
After both parties have signed a PSBT and the transaction is broadcast, use this
tool to ... pillar_dca_leaderboard View the DCA streak leaderboard. Shows top partnerships by streak length, and highlights your entry if you have one. pillar_dca_partners View your DCA partners and weekly status. Shows active partnerships with streak, PnL, and weekly status badges, plus any pending invites. pillar_dca_status Check your DCA schedule status. Shows all active DCA schedules (up to 10) with chunk progress (completed, pending, failed) and next execution time. pillar_direct_dca_leaderboard View the DCA streak leaderboard. Shows top partnerships by streak length, and highlights your entry if you have one. pillar_direct_dca_partners View your DCA partners and weekly status. Shows active partnerships with streak, PnL, and weekly status badges, plus any pending invites. pillar_direct_dca_status Check your DCA schedule status. Shows all active DCA schedules (up to 10) with chunk progress (completed, pending, failed) and next execution time. pillar_direct_position View your Pillar smart wallet balances (STX, sBTC, aeUSDC) and Zest position. No signing needed — reads on-chain data. pillar_direct_quote Get a boost quote showing projected leverage, LTV, and swap details. No signing needed. Use this to determine aeUsdcToBorrow and minSbtcFromSwap be... pillar_direct_stack_stx Stack STX from your Pillar smart wallet via Fast Pool or Stacking DAO. Agent-signed, no browser needed. Backend sponsors gas. Fast Pool delegates S... pillar_direct_stacking_status Check stacking status for your Pillar smart wallet. No signing needed — reads on-chain data. Shows STX balance (locked vs liquid), current PoX cycl... pillar_direct_supply Earn yield on your Bitcoin. Supply sBTC from your Pillar smart wallet to Zest Protocol. No leverage, no liquidation risk. Agent-signed, no browser ... pillar_direct_unwind Close or reduce your leveraged sBTC position. Agent-signed, no browser needed. Swaps sBTC to aeUSDC to repay debt, then withdraws remaining sBTC co... pillar_fund Fund your Pillar smart wallet. Supports multiple methods:
- 'exchange': Deposit BTC from an exchange (Coinbase, Binance, etc.) - generates a deposi... pillar_key_info Show signing key info: pubkey, smart wallet, lock status, and all stored keys. pillar_position View your Pillar wallet balance and Zest position. Opens the Position page in the browser AND returns the data (sBTC balance, collateral, borrowed,... pillar_status Check if you're connected to Pillar and get your wallet address. pillar_supply Earn yield on your Bitcoin. Supply sBTC from your Pillar smart wallet to Zest Protocol. Your sBTC earns interest with no leverage and no liquidatio... pillar_unwind Close or reduce your leveraged sBTC position. Opens a modal to repay borrowed sBTC and withdraw collateral back to your wallet. reputation_append_response Append a response to feedback received from a client. Must be called by the agent that received the feedback. Requires an unlocked wallet. reputation_get_approved_limit Get the approved feedback index limit for a specific client of an agent. Returns the maximum index up to which the client is approved to submit fee... reputation_get_clients Get a paginated list of clients who gave feedback to an agent. Returns client addresses and a nextCursor for pagination. No wallet required. reputation_get_feedback_count Get the total number of feedback entries for an agent from the ERC-8004 reputation registry. No wallet required. reputation_get_last_index Get the last feedback index submitted by a specific client for an agent. No wallet required. reputation_get_summary Get aggregated reputation summary for an agent from the ERC-8004 reputation registry. Returns average rating as a WAD string (18 decimals) and tota... reputation_give_feedback Submit feedback for an agent using the ERC-8004 reputation registry. Value is normalized to 18 decimals (WAD) internally for aggregation. Requires ... reputation_read_all_feedback Read all feedback entries for an agent with optional tag filtering and pagination. Returns up to 20 entries per page. Pass nextCursor from the prev... reputation_read_feedback Read a specific feedback entry for an agent by index from the ERC-8004 reputation registry. Returns client address, value, decimals, tags, and time... reverse_bns_lookup Get the BNS domain names owned by an address. runes_get_activity Get recent on-chain activity (mints, transfers, burns) for a specific Bitcoin Rune.
Returns transaction events with amounts, addresses, block heig... runes_get_address_activity Get Bitcoin Rune transaction activity for a specific Bitcoin address.
Returns mints received, transfers sent/received, and burns associated with t... runes_get_address_balances Get all Bitcoin Rune balances for a Bitcoin address.
Returns each rune the address holds along with its balance, divisibility, and symbol. Useful ... runes_get_etching Get details for a specific Bitcoin Rune by its name or numeric ID.
Returns name, ID, supply info, divisibility, symbol, etching transaction, cenot... runes_get_holders Get the list of holders for a specific Bitcoin Rune.
Returns Bitcoin addresses and their rune balances, sorted by balance descending.
Supports pa... runes_list_etchings List all Bitcoin Rune etchings (token deployments) with pagination.
Returns rune names, IDs, supply, divisibility, symbol, etching transaction, an... sbtc_deposit_status Check the status of an sBTC deposit transaction from Emily API. sbtc_get_balance Get the sBTC balance for a wallet address. sbtc_get_deposit_info Get information about how to deposit BTC to receive sBTC. sbtc_get_peg_info Get sBTC peg information including total supply and peg ratio. sbtc_withdraw_status Alias for sbtc_withdrawal_status. Check the status of an sBTC peg-out (withdrawal) request. sbtc_withdrawal_status Check status of an sBTC withdrawal request by requestId or initiating txid. schnorr_sign_digest Sign a raw 32-byte digest with Schnorr (BIP-340) using the wallet's Taproot private key. Use for Taproot script-path spending, multisig coordinatio... schnorr_verify_digest Verify a BIP-340 Schnorr signature over a 32-byte digest. Takes the digest, signature, and public key, returns whether the signature is valid. Use ... sip018_hash Compute the SIP-018 message hash without signing. Returns the full encoded hash, domain hash, and message hash. Useful for preparing data for on-ch... sip018_sign Sign structured Clarity data using SIP-018 standard. Creates a signature that can be verified both off-chain and on-chain by smart contracts. Use c... sip018_verify Verify a SIP-018 signature and recover the signer's address. Takes the verification hash (from sip018_sign or sip018_hash 'verification' field) and... souldinals_display_soul Parse and display soul traits from a specific inscription.
Fetches the inscription content from Unisat and extracts structured soul traits:
- name... souldinals_list_souls List all soul inscriptions (text/markdown) owned by a Taproot address.
Queries the Unisat Ordinals API for inscriptions with content type text/mar... souldinals_load_soul Load and display the full content of the oldest soul inscription from a Taproot address.
Fetches the list of soul inscriptions (text/markdown) and... souldinals_reveal_soul Complete a soul inscription - STEP 2: Broadcast reveal transaction.
Call this AFTER the commit transaction from `souldinals_inscribe_soul` has con... stack_stx Lock STX for stacking to earn BTC rewards.
Requires a Bitcoin address (hash) for receiving rewards. stacks_market_buy_no Buy NO shares in a Stacks Market prediction market.
Uses the buy-no-auto function with slippage protection via a max-cost cap.
The transaction wil... stacks_market_buy_yes Buy YES shares in a Stacks Market prediction market.
Uses the buy-yes-auto function with slippage protection via a max-cost cap.
The transaction w... stacks_market_get Get full details for a specific prediction market on stacksmarket.app.
Market IDs are epoch millisecond timestamps (uint) visible in market URLs.
... stacks_market_get_position Check YES and NO share balances for an address in a Stacks Market prediction market.
If no address is provided, uses the currently configured wall... stacks_market_list List prediction markets on stacksmarket.app.
Returns a paginated list of markets with optional filtering by status, category, or featured flag.
N... stacks_market_quote_buy Get an LMSR buy price quote for YES or NO shares on a Stacks Market prediction market.
Returns the cost in micro-STX to buy the requested number o... stacks_market_quote_sell Get an LMSR sell price quote for YES or NO shares on a Stacks Market prediction market.
Returns the proceeds in micro-STX for selling the requeste... stacks_market_redeem Redeem winning shares after a Stacks Market prediction market is resolved.
Call this after the market has been resolved to claim STX for the winni... stacks_market_search Search prediction markets by keyword on stacksmarket.app.
Searches across market titles and descriptions.
Note: Stacks Market is only available o... 2/5 stacks_market_sell_no Sell NO shares in a Stacks Market prediction market.
Uses the sell-no-auto function with a minimum proceeds guard.
The transaction will fail if pr... stacks_market_sell_yes Sell YES shares in a Stacks Market prediction market.
Uses the sell-yes-auto function with a minimum proceeds guard.
The transaction will fail if ... stacks_sign_message Sign a plain text message using the Stacks message signing format. The message is prefixed with '\x17Stacks Signed Message:\n' before hashing (SIWS... stacks_verify_message Verify a Stacks message signature and recover the signer's address. Takes the original message and signature, applies the Stacks prefix, and verifi... stackspot_claim_rewards Claim rewards from a completed Stackspot stacking lottery pot.
After stacking completes and a winner is selected by VRF, each participant claims
t... stackspot_get_pot_state Get full on-chain state for a Stackspot stacking lottery pot.
Returns the pot value, lock status, configurations, pool config, and detailed state.... stackspot_join_pot Contribute STX to a Stackspot stacking lottery pot.
Joins a pot by contributing STX. Your STX is locked until the stacking cycle
completes. All pa... stackspot_list_pots List all known Stackspot stacking lottery pots with current on-chain values.
Stackspot is a stacking lottery on Stacks: participants pool STX into... styx_fees Get current Bitcoin network fee estimates (sat/vB) from Styx: low, medium, high. styx_history Get BTC→sBTC deposit history for a Stacks address via Styx. Uses the active wallet's Stacks address if no address is provided. styx_pool_status Get current Styx pool liquidity and status. Shows realAvailable and estimatedAvailable BTC in the pool. styx_pools List all available Styx pools with their configurations. Pools: main (up to 300k sats, sbtc/usda/pepe), aibtc (up to 1M sats, sbtc/aibtc). Minimum ... styx_price Get current BTC price in USD from Styx. styx_status Check the status of a Styx BTC→sBTC deposit by deposit ID or Bitcoin transaction ID. taproot_get_pubkey Derive the x-only Taproot public key (32 bytes hex) from the active wallet using the BIP-86 derivation path m/86'/0'/0'/0/0. Share this pubkey with... taproot_multisig_guide Return a step-by-step guide for M-of-N Taproot multisig coordination between agents using OP_CHECKSIGADD (BIP-341/342). Read-only — no wallet needed. taproot_verify_cosig Verify a Schnorr co-signature against a BIP-341 sighash. Use this to confirm that a co-signer's signature is valid before combining and broadcastin... tenero_holder_stats Get token holder distribution and concentration statistics. Shows total holders, top holder percentages, and Gini coefficient. Powered by the Tener... tenero_market_stats Get overall Stacks ecosystem market statistics including total volume, buy/sell netflow, unique traders, and active pools. Returns a time series of... tenero_market_summary Get token market summary including price history, 24h volume, and pool liquidity. Returns weighted price across all pools trading this token. Power... tenero_search Search tokens, pools, and wallets by name, symbol, or contract address. Returns matching tokens with metadata and pricing information. Powered by t... 2/5 tenero_token_info Get token details including metadata, current price, market cap, and 24h volume. Powered by the Tenero API (api.tenero.io). No authentication requi... tenero_top_gainers List top gaining tokens by 24h price change percentage on the Stacks ecosystem. Useful for spotting momentum and trending assets. Powered by the Te... tenero_top_losers List top losing tokens by 24h price change percentage on the Stacks ecosystem. Useful for identifying underperforming assets or potential reversal ... tenero_trending_pools List trending DEX liquidity pools by volume over the last hour. Includes pool platform, token pair, volume, and liquidity details. Powered by the T... tenero_wallet_holdings Get token holdings with current USD value for a Stacks wallet address. Shows portfolio composition including token balances and estimated values. P... tenero_wallet_trades Get trade history for a Stacks wallet address. Returns recent buy/sell events with token, pool, and USD value details. Powered by the Tenero API (a... tenero_whale_trades Get recent large/whale trades above threshold value on the Stacks ecosystem. Useful for tracking smart money and large market movements. Powered by... tx_status_deep Deep diagnostic view correlating sender nonces with sponsor nonces for sponsored transactions.
Reads the sender's local pending txid log and cross... wallet_list List all wallets available for the agent to use. wallet_rotate_password Change the password for a wallet's encrypted keystore.
Performs an atomic operation: backs up the keystore, re-encrypts with the new password, veri... wallet_status Get the agent's wallet status - whether it has a wallet, if it's unlocked, and what it can do. yield_dashboard_apy_breakdown Current APY rates across all supported Stacks DeFi protocols.
Returns live APY data for Zest Protocol (sBTC lending), ALEX DEX (aBTC/STX LP),
Bitf... yield_dashboard_overview Portfolio overview across Stacks DeFi protocols.
Aggregates positions across Zest Protocol (sBTC lending), ALEX DEX (AMM LP),
Bitflow (DEX LP), an... yield_dashboard_positions Detailed per-protocol DeFi position data.
Returns an array of positions across Zest Protocol, ALEX DEX, Bitflow, and
STX Stacking. Each position i... yield_dashboard_rebalance Rebalance suggestions based on risk-adjusted yield.
Reads current positions across all protocols, compares to optimal allocation
for the chosen ri... yield_hunter_status Get current yield hunter status.
Shows:
- Whether yield hunting is active
- Current configuration
- Statistics (checks run, deposits made)
- Recen... zest_borrow Borrow assets from Zest Protocol v2.
Borrows assets against your supplied collateral.
Ensure you have sufficient collateral to maintain a healthy ... zest_get_position Get user's lending position on Zest Protocol v2.
Returns collateral, debt, health factor, and LTV data across all assets.
The position query retur... zest_list_assets List all supported assets on Zest Protocol v2.
Returns the list of assets that can be supplied, borrowed, or used as collateral.
Each asset includ... zest_repay Repay borrowed assets to Zest Protocol v2.
Repays borrowed assets plus accrued interest.
You can use the asset symbol (e.g., 'USDC', 'sBTC') or fu... zest_supply Supply assets to Zest Protocol v2.
Deposits assets and adds them as collateral in one atomic operation.
The supplied assets earn yield AND provide... credentials_set Store or update a credential. Encrypts the value with AES-256-GCM and saves to ~/.aibtc/credentials.enc. If the service/key pair already exists, it... 2/5 credentials_unlock Verify that the credential store password works and show store info. Uses ARC_CREDS_PASSWORD env var. Creates a new empty store if none exists. 2/5 identity_register Register a new agent identity on-chain using ERC-8004 identity registry. Returns a transaction ID. Check the transaction result to get the assigned... 2/5 identity_set_approval Approve or revoke an operator for an agent identity in the ERC-8004 identity registry. An approved operator can update URI, metadata, and wallet on... 2/5 identity_set_metadata Set a metadata key-value pair on an agent identity in the ERC-8004 identity registry. Value must be a hex-encoded buffer (max 512 bytes). The key "... 2/5 identity_set_uri Update the URI for an agent identity in the ERC-8004 identity registry. Requires an unlocked wallet. Must be called by agent owner or approved oper... 2/5 identity_set_wallet Link the active Stacks wallet address to an agent identity in the ERC-8004 identity registry. Requires an unlocked wallet. 2/5 jingswap_close_deposits Close the deposit phase of the current Jingswap auction cycle. Before calling, check jingswap_get_cycle_state to verify: phase is 0 (deposit), bloc... 2/5 jingswap_settle_with_refresh Settle the current auction cycle by first refreshing Pyth oracle prices with fresh VAAs. This is the recommended settlement method — stored prices ... 2/5 news_claim_beat Create or join a beat on aibtc.news.
Requires an unlocked wallet with a P2WPKH (bc1q) BTC address. The tool
automatically signs the request using ... 2/5 nonce_fill_gap Fill a nonce gap by sending a minimal STX transfer at the specified nonce.
LAST-RESORT recovery action. Each gap-fill is a real on-chain transacti... 2/5 nostr_post Publish a short-text note (kind:1) to Nostr relays. Optionally include hashtag tags and specify target relays. Requires an unlocked wallet. 2/5 nostr_set_profile Update the agent's Nostr profile (kind:0 metadata event). Only provided fields are updated; existing fields are preserved by fetching the current p... 2/5 openrouter_integration_guide Get OpenRouter integration examples and code patterns for implementing AI features.
Use this tool when you need to add AI capabilities to any proj... 2/5 ordinals_p2p_create_offer List an inscription for sale on the P2P trade ledger.
Creates a new offer entry authenticated with a BIP-137 signature from the active
wallet's BT... 2/5 pillar_add_admin Add a backup admin address to your Pillar smart wallet for recovery purposes. The admin can help recover funds if you lose access to your passkey. 3/5 pillar_auto_compound Configure auto-compound for your Pillar wallet. When enabled, a keeper will automatically boost your position when sBTC accumulates in your wallet. 2/5 pillar_boost Create or increase a leveraged sBTC position (up to 1.5x) on your Pillar smart wallet. Opens the Pillar website Boost tab where you can set the amo... 2/5 pillar_connect Connect to your Pillar smart wallet. Opens the Pillar website - if you're logged in, it will automatically connect and return your wallet address. ... 2/5 pillar_create_wallet Create a new Pillar smart wallet. Opens the Pillar website to complete registration. You'll need to enter your email to receive updates. If the use... 2/5 pillar_dca_invite Invite a DCA partner by email or wallet address. DCA partners hold each other accountable — both must boost each week to keep the streak alive. 2/5 pillar_direct_add_admin Add a backup admin address to your Pillar smart wallet for recovery purposes. Agent-signed, no browser needed. The admin can help recover funds if ... 3/5 pillar_direct_boost Create or increase a leveraged sBTC position (up to 1.5x) on your Pillar smart wallet. Agent-signed, no browser needed. Your sBTC is supplied to Ze... 2/5 pillar_direct_create_wallet Create a new Pillar smart wallet for agent direct operations. This is a bundled operation: generates a signing keypair, unlocks it, and deploys a n... 2/5 pillar_direct_dca_invite Invite a DCA partner by email or wallet address. DCA partners hold each other accountable — both must boost each week to keep the streak alive. 2/5 pillar_direct_resolve_recipient Resolve a recipient before sending. Resolves BNS names (.btc) via backend, Pillar wallet names via backend, or validates a Stacks address. Use this... 2/5 pillar_direct_send Send sBTC from your Pillar smart wallet to a recipient. Agent-signed, no browser needed. Supports BNS names, wallet names, or Stacks addresses. Bac... 2/5 pillar_disconnect Disconnect from Pillar. Clears locally stored wallet address. 2/5 pillar_invite Get your Pillar referral link to invite friends. Share this link and earn rewards when friends sign up. 2/5 pillar_key_generate Generate a new secp256k1 signing keypair for Pillar smart wallet direct operations. Returns the compressed public key (33 bytes hex). After generat... 3/5 pillar_key_lock Lock the signing key, clearing sensitive data from memory. 2/5 pillar_key_unlock Unlock a signing key for Pillar direct operations. Uses auto-derived password. Usually not needed — tools auto-unlock on first use. 2/5 pillar_send Send sBTC from your Pillar smart wallet. Requires being connected first (use pillar_connect). Opens the frontend for signing, then waits for confir... 2/5 preorder_bns_name Preorder a BNS domain name (step 1 of 2-step registration). NOTE: For .btc names, prefer claim_bns_name_fast instead — it registers in one transact... 2/5 register_bns_name Register a BNS domain name after preorder is confirmed. This is step 2 of a 2-step process. You MUST use the same salt from the preorder step. Only... 2/5 reputation_approve_client Approve a client to submit feedback up to a specified index limit. Must be called by the agent owner. Requires an unlocked wallet. 2/5 sbtc_initiate_withdrawal Initiate an sBTC peg-out to a Bitcoin L1 address.
Locks (amount + maxFee) of sBTC in the sBTC protocol and creates a withdrawal request.
Signers l... 2/5 send_inbox_message Send a paid x402 message to another agent's inbox on aibtc.com.
Uses sponsored transactions so the sender only pays the sBTC message cost — no STX... 2/5 souldinals_inscribe_soul Inscribe a soul.md as a child inscription - STEP 1: Broadcast commit transaction.
Creates a child inscription linked to a parent genesis inscripti... 2/5 wallet_create Create a new wallet for the agent with a generated BIP39 24-word mnemonic.
The wallet is encrypted locally and stored in ~/.aibtc/.
IMPORTANT: Save... 3/5 wallet_export Export the mnemonic phrase for a wallet.
WARNING: Only use this in a secure environment! Anyone with the mnemonic can access your funds. 3/5 wallet_import Import an existing wallet for the agent using a BIP39 mnemonic phrase.
The wallet is encrypted locally and stored in ~/.aibtc/. 3/5 wallet_lock Lock the agent's wallet, clearing sensitive data from memory. 2/5 wallet_set_timeout Set how long the agent's wallet stays unlocked before automatically locking. Set to 0 to disable auto-lock. 2/5 wallet_switch Switch to a different wallet.
Note: The new wallet will need to be unlocked before use. 2/5 wallet_unlock Unlock the agent's wallet to enable transactions.
If no wallet ID is provided, unlocks the active wallet. 3/5 yield_hunter_configure Configure yield hunter settings.
Adjust the deposit threshold, reserve, or check interval.
Changes take effect on the next check cycle. 2/5 zest_enable_collateral Add existing zTokens as collateral on Zest Protocol v2.
Use this when you deposited directly to a vault and need to register
those zTokens as coll... 2/5 credentials_delete Remove a stored credential by service and key. The encrypted store file is rewritten without the deleted entry. 4/5 identity_unset_wallet Remove the agent wallet association from an agent identity in the ERC-8004 identity registry. Requires an unlocked wallet. 4/5 jingswap_cancel_cycle Cancel the current auction cycle if settlement has failed for too long. Can only be called 530 blocks (~17.5 min) after deposits were closed (BUFFE... 4/5 jingswap_cancel_sbtc Cancel your sBTC deposit from the current Jingswap auction cycle and get a full refund. Only works during the deposit phase. Works the same for bot... 4/5 jingswap_cancel_stx Cancel your token-B deposit (STX or USDCx depending on market) from the current Jingswap auction cycle and get a full refund. Only works during the... 4/5 ordinals_cancel_listing Cancel an active Magic Eden listing for an inscription.
Requests a cancellation PSBT from Magic Eden. The seller signs the PSBT to
invalidate the ... 4/5 ordinals_p2p_cancel Cancel an open offer or counter on the trade ledger.
Only the parties involved in a trade may cancel it. The active wallet signs
the cancellation ... 4/5 pillar_direct_revoke_fast_pool Revoke Fast Pool STX delegation from your Pillar smart wallet. Agent-signed, no browser needed. Backend sponsors gas. After revoking, STX stays loc... 4/5 recover_sponsor_nonce Attempt automated recovery of stuck sponsor transactions via the relay API, or resync the local nonce counter.
Run check_relay_health first to ide... 4/5 reputation_revoke_feedback Revoke a previously submitted feedback entry by index. Only the original submitter can revoke their feedback. Requires an unlocked wallet. 4/5 stackspot_cancel_pot Cancel a Stackspot stacking lottery pot before stacking begins.
Cancels an unlocked pot to recover contributed STX. The pot must not yet be locked... 4/5 wallet_delete Permanently delete a wallet.
WARNING: This cannot be undone! Make sure you have backed up your mnemonic. 5/5 alex_swap Execute a token swap on ALEX DEX.
Swaps tokenX for tokenY using the ALEX AMM.
Use full contract IDs for tokens.
Note: ALEX DEX is only available ... 3/5 arxiv_compile_digest Compile a Markdown digest from recent arXiv papers on LLMs and autonomous agents.
Fetches papers from arXiv, filters for relevance score >= min_sc... 3/5 deploy_contract Deploy a Clarity smart contract to the Stacks blockchain. 3/5 dual_stacking_enroll Enroll in Dual Stacking to earn sBTC rewards.
Enrolls your wallet in the Dual Stacking protocol. Enrollment takes effect at the
start of the next ... 3/5 dual_stacking_opt_out Opt out of Dual Stacking.
Removes your wallet from the Dual Stacking protocol. The opt-out takes effect at
the start of the next PoX cycle; you co... 3/5 execute_x402_endpoint Execute an x402 API endpoint. Payment is handled automatically.
Supported sources:
- x402.biwas.xyz (default): Use path like "/api/pools/trending"... 4/5 nonce_heal Diagnose and heal the full nonce state for the active wallet in one shot.
Handles 90% of stuck-tx cases automatically:
1. Fetches current nonce st... 4/5 pillar_direct_auto_compound Configure auto-compound for your Pillar wallet. When enabled, a keeper automatically boosts when sBTC accumulates above the trigger. Agent-signed, ... 3/5 probe_x402_endpoint Probe an x402 API endpoint to discover its cost WITHOUT making payment.
This tool is useful for:
- Discovering the cost of a paid endpoint before ... 4/5 scaffold_x402_ai_endpoint Create a complete x402 paid AI API project with OpenRouter integration.
This creates a NEW PROJECT FOLDER with everything needed to deploy a pay-p... 5/5 scaffold_x402_endpoint Create a complete x402 paid API project as a Cloudflare Worker.
This creates a NEW PROJECT FOLDER with everything needed to deploy a pay-per-use A... 5/5 stackspot_start_pot Trigger a full Stackspot pot to begin stacking via the platform contract.
Initiates stacking for a pot that has reached its participant limit. Thi... 3/5 yield_hunter_start Start autonomous yield hunting.
This will:
1. Monitor your wallet for sBTC
2. Automatically deposit sBTC to Zest Protocol when balance exceeds thr... 3/5 yield_hunter_stop Stop autonomous yield hunting.
Stops the background process that monitors and deposits sBTC.
Your existing Zest positions remain untouched. 3/5 identity_transfer Transfer an agent identity NFT to a new owner in the ERC-8004 identity registry. This clears the agent wallet association — run identity_set_wallet... 5/5 jingswap_deposit_sbtc Deposit sBTC into the current Jingswap auction cycle. Only works during the deposit phase. Amount is in satoshis (e.g. 1000 for 1000 sats). Works t... 5/5 jingswap_deposit_stx Deposit the token-B side (STX or USDCx depending on market) into the current Jingswap auction cycle. Only works during the deposit phase. Amount is... 5/5 ordinals_p2p_transfer Record a completed inscription transfer on the trade ledger.
Marks a trade as closed by recording the on-chain (or off-chain sBTC) transfer.
The a... 5/5 pillar_direct_withdraw_collateral Withdraw sBTC collateral from Zest on the Pillar smart wallet. Agent-signed, no browser needed. Backend sponsors gas. 5/5 sbtc_deposit Deposit BTC to receive sBTC on Stacks L2.
This builds, signs, and broadcasts a Bitcoin transaction to the sBTC deposit address.
After confirmation... 5/5 sbtc_transfer Transfer sBTC tokens to a recipient address.
sBTC uses 8 decimals (same as Bitcoin).
Example: To send 0.001 sBTC, use amount "100000" (satoshis). 5/5 sbtc_withdraw Alias for sbtc_initiate_withdrawal. Initiates an sBTC peg-out request to BTC L1. 5/5 styx_deposit Full headless BTC→sBTC deposit via the Styx protocol. Flow: reserve pool liquidity → build PSBT locally → sign with wallet keys → broadcast to memp... 5/5 transfer_btc Transfer BTC to a recipient address. Builds, signs, and broadcasts a Bitcoin transaction. Requires an unlocked wallet with BTC balance. By default,... 5/5 transfer_nft Transfer an NFT (SIP-009) to a recipient address. 5/5 transfer_rune Transfer runes to a recipient address using Runestone OP_RETURN encoding.
Builds a Bitcoin transaction with a Runestone, sends runes to the recipi... 5/5 transfer_stx Transfer STX tokens to a recipient address. Signs and broadcasts the transaction.
Example: To send 2 STX, use amount "2000000" (micro-STX).
1 STX ... 5/5 transfer_token Transfer any SIP-010 token to a recipient address.
Supports well-known tokens by symbol: sBTC, USDCx, ALEX, DIKO
Or use the full contract ID. 5/5 zest_withdraw Withdraw assets from Zest Protocol v2.
Removes collateral and redeems for underlying assets in one atomic operation.
You can use the asset symbol ... 5/5 The Aibtc MCP server exposes 288 tools across 5 categories: Read, Write, Destructive, Execute, Financial.
Use Intercept, the open-source MCP proxy. Write YAML rules for each tool — rate limits, argument validation, or deny rules — then run Intercept in front of the Aibtc server.
Aibtc tools are categorised as Read (199), Write (48), Destructive (12), Execute (14), Financial (15). Each category has a recommended default policy.
Open source. One binary. Zero dependencies.
npx -y @policylayer/intercept