Bitcoin-native MCP 服务

Quick Start

Example Conversation

You: What's your wallet address?

Claude: I don't have a wallet yet. Would you like to assign me one?
        I can either create a fresh wallet or you can import an existing one.

You: Create a new wallet called "agent-wallet"

Claude: What password should I use to protect the wallet?

You: use "secure123password"

Claude: I now have a wallet! My address is ST1ABC...XYZ

        IMPORTANT: Please save this recovery phrase securely:
        "word1 word2 word3 ... word24"

        This phrase will NOT be shown again. It's the only way to recover
        the wallet if the password is forgotten.

You: Send 10 STX to ST2DEF...

Claude: Done! I've sent 10 STX to ST2DEF...
        Transaction: 0x123...

Usage Examples

Wallet management: > "What's your wallet address?" > "Create a wallet for yourself" > "Unlock your wallet" > "Keep your wallet unlocked for 1 hour"

Check balances: > "How much STX do you have?" > "What's your sBTC balance?"

Transfer tokens: > "Send 2 STX to ST1PQHQKV0RJXZFY1DGX8MNSNYVE3VGZJSRTPGZGM" > "Transfer 0.001 sBTC to muneeb.btc"

NFTs: > "What NFTs do you own?" > "Send this NFT to alice.btc"

BNS domains: > "What address is satoshi.btc?" > "Is myname.btc available?"

DeFi trading (mainnet): > "What pools are available on ALEX?" > "Swap 0.1 STX for ALEX" > "Get a quote for 100 STX to ALEX" > "What assets can I lend on Zest?" > "Supply 100 stSTX to Zest" > "Borrow 50 aeUSDC from Zest" > "Check my Zest position"

x402 endpoints: > "Get trending liquidity pools" > "Tell me a dad joke"

Manual Configuration

If you prefer to configure manually, add the following to your config file.

Claude Code (~/.claude.json):

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

Claude Desktop (claude_desktop_config.json -- see path table above):

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

Note: Claude Desktop requires the -y flag in args so npx doesn't prompt for confirmation.

Configuration

Note on NETWORK: The --install command writes NETWORK=mainnet by default (pass --testnet to use testnet). If you omit NETWORK from your config entirely, the runtime fallback is testnet. Most users should set this explicitly.

Note: CLIENT_MNEMONIC is optional. The recommended approach is to let Claude create its own wallet. HIRO_API_KEY is optional but recommended for production use — without it, you may hit Hiro's public rate limits (429 responses). Get a key at platform.hiro.so.

Advanced: Pre-configured Mnemonic

For automated setups where Claude needs immediate wallet access, add the CLIENT_MNEMONIC environment variable to your MCP server config (in ~/.claude.json for Claude Code, or claude_desktop_config.json for Claude Desktop):

{
  "mcpServers": {
    "aibtc": {
      "command": "npx",
      "args": ["@aibtc/mcp-server@latest"],
      "env": {
        "CLIENT_MNEMONIC": "your twenty four word mnemonic phrase",
        "NETWORK": "testnet"
      }
    }
  }
}

This bypasses the wallet creation flow - Claude has immediate access to transact.

x402 API Endpoints