aibtc

This MCP server, @aibtc/mcp-server, provides a Bitcoin-native assistant platform that exposes a wide range of on-chain capabilities to AI agents. It combines Bitcoin L1 operations (balance checks, BTC transfers, UTXO management via mempool.space) with Stacks L2 interactions, DeFi tools, NFT support, SIP-010 token transfers, and x402 automated payments. When you run the server via npx, Claude or other clients can request wallet creation, sign messages, manage wallets securely, and perform complex on-chain actions through the 150+ available tools. The server derives a single mnemonic into both a Bitcoin address and a Stacks address, enabling seamless management of BTC and Stacks assets from one wallet.

To use it, install and start the server with npx and then connect your Claude Code or Claude Desktop configuration to the MCP endpoint by specifying the command and environment variables. The recommended approach is to run the server with the latest package version using npx, which ensures automatic updates. You can configure the server for mainnet by default or switch to testnet via the provided flags in your CLI invocation (e.g., --testnet) as described in the Quick Start. Tools are organized by category, including Wallet Management (create/import/unlock/lock/list), Bitcoin L1 (balances, fees, UTXOs, transfers), Inscriptions, PSBT/ordinal trading, and cryptographic signing utilities for SIP-018 and SIWS messages.

Example usage scenarios include creating a Claude wallet, querying BTC or Stacks balances, sending BTC to a recipient, inscribing a message or NFT, performing DeFi operations on Stacks, and signing SIP-018 structured data. Each tool call is exposed through the MCP server, making it accessible to AI agents via natural-language prompts that map to these actions.

Prerequisites:

• Node.js and npm installed on your machine (npm version 6.x+ recommended).
• Basic familiarity with npm/npx commands.

Installation steps:

1. Install or run the MCP server via npx (recommended for auto-updates):

npx @aibtc/mcp-server@latest

2. If you prefer manual install/config, you can install the package globally or use npx with explicit version:

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

3. For testnet usage, append the testnet flag during install/run as described in the Quick Start:

# Claude Code on testnet
npx @aibtc/mcp-server@latest --install --testnet

4. Create or edit your Claude config to connect to the MCP server. Example Claude Code config (config.json):

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

5. If you are configuring Claude Desktop, ensure the CLI arguments include the -y flag to prevent prompts when using npx:

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

6. Restart Claude after installation to load the MCP server configuration.

Tips and notes:

• The default network is mainnet unless you pass --testnet or set NETWORK=testnet in your environment.
• Claude Desktop users should include the -y flag in args to avoid npx prompts.
• Wallets are stored locally with AES-256-GCM and Scrypt-derived keys; ensure proper backup of recovery phrases because mnemonics are not stored in plaintext.
• When testing, consider using testnet mode to avoid moving real assets accidentally.
• The MCP server supports over 150 tools across Wallet Management, Bitcoin L1, Inscriptions, PSBT/Ordinal trading, and signing utilities. Use tool names like get_btc_balance, transfer_btc, inscribe, psbt_sign, sip018_sign, stacks_sign_message, etc., to perform actions via your AI agents.
• If you encounter issues with discovery or updates, relying on npx ensures you always fetch the latest version without manual global installs.