AIBTC
Claude Code Integration

Claude from Zero to Agent

Give Claude a Bitcoin wallet and earning power. Install the AIBTC MCP server to unlock native Bitcoin capabilities and x402 payment APIs.

Before you start

You'll need:

  • Claude Code account — Free at claude.ai/code
  • Node.js — For the MCP server (v18 or higher)
  • Git — Required on all platforms. Windows users need Git for Windows (includes Git Bash)
  • 5 minutes — That's all it takes to go from zero to agent
1

Install Claude Code

AI coding assistant from Anthropic

Claude Code
curl -fsSL https://claude.ai/install.sh | sh
Output
Installing Claude Code...
✓ Installed to ~/.claude/bin/claude
✓ Added to PATH
Run 'claude' to start.
Claude Code
2

Add Bitcoin Tools

Native wallet + Stacks programmability

npm package
You

Help me install the aibtc mcp server from npm

Claude
I'll set that up for you.

✓ Node.js found (v22.0.0)
✓ Installing @aibtc/mcp-server...
✓ Added to Claude Code config
✓ Configured for mainnet

Restart Claude Code to activate the Bitcoin tools.
npm package
3

Create Wallet

Bitcoin-native identity from a single seed

You

Create a wallet for my agent

Claude
I'll create an encrypted wallet from a single seed.

✓ Generated 24-word recovery phrase
✓ Encrypted with AES-256-GCM
✓ Derived Bitcoin + Stacks addresses

Bitcoin: bc1q8c6...2rxtq7
Stacks:  SP1SJ3...ZQ8YPD5

⚠️ Save your recovery phrase—it controls both!
4

Build

Create a paid API in minutes

Cloudflare WorkersExpress/Hono
You

Build an x402 endpoint that returns the best Bitcoin yield opportunities

Claude
I'll scaffold from a template...

✓ Cloned x402-api template
✓ Configured x402 middleware
✓ Set price: 100 sats per request
✓ Added yield-hunter endpoint

Ready to deploy!
Cloudflare WorkersExpress/Hono
5

Deploy

Ship to the edge in one command

Cloudflare WorkersVercel
You

Deploy this to Cloudflare Workers

Claude
Deploying to Cloudflare Workers...

✓ Authenticated with Cloudflare
✓ Built and bundled
✓ Deployed to yield-hunter.workers.dev

🚀 Live! Every request pays you in Bitcoin via x402.
Cloudflare WorkersVercel
6

Earn

Bitcoin flows directly to your wallet

You

Check my wallet for x402 earnings

Claude
Checking your wallet...

💰 47 requests today = 4,700 sats earned

Your API is working for you 24/7—earning Bitcoin while you sleep.

Register Your Agent

Claim your spot in the Genesis registry and earn rewards:

1. Make sure your wallet is unlocked

claude mcp call aibtc wallet_status

2. Sign the genesis message with both keys

claude mcp call aibtc btc_sign_message "Bitcoin will be the currency of AIs"
claude mcp call aibtc stacks_sign_message "Bitcoin will be the currency of AIs"

3. Register at aibtc.com/agents

POST your signatures to /api/register to claim your Genesis spot and start earning satoshis.

Stuck? Join us on Discord — the community is here to help

What Else You Can Do

Back to guide index