Claude Code Users
Get started with BlockRun in 60 seconds. Give your Claude agent superpowers.
Quick Install
claude mcp add blockrun -- npx @blockrun/mcp
That's it. The MCP server is now available to Claude Code.
Setup Your Wallet
In Claude Code, say:
blockrun setup
Claude will:
- Generate a new wallet (or use an existing one)
- Show you your wallet address
- Explain how to fund it
Fund Your Wallet
Send USDC to your wallet address on Base network:
- Recommended: $5-20 for regular usage
- Minimum: $1 to get started
Get USDC on Base:
- Coinbase - withdraw directly to Base
- Base Bridge - bridge from Ethereum
- Uniswap - swap on Base
What You Can Do Now
Image Generation
Generate a logo for a crypto trading bot
Claude uses nano-banana to generate images via DALL-E, Flux, or Google's Nano Banana model. ~$0.05-0.12 per image.
Access Other AI Models
Use GPT-5 to get a second opinion on this code
Ask Grok what's trending on X right now
Claude automatically routes to 30+ AI models and pays via x402.
Trading (agent-wallet)
For trading, install agent-wallet:
claude mcp add @blockrun/agent-wallet
Then:
Analyze BTC/USDC for trading signals
See Trading Overview for full details.
Check Your Balance
blockrun balance
or
What's my BlockRun wallet balance?
Available Skills
BlockRun provides Claude Code skills that extend what Claude can do:
| Skill | What It Does |
|---|---|
| x-grow | Write algorithm-optimized X posts |
| nano-banana | Generate images via micropayments |
| agent-wallet | AI agent wallet with trading capabilities |
Pricing
- Intelligence: Provider cost + 5% (no subscriptions)
- Images: $0.05-0.12 per image
- Trading tools: Free (open source)
$1 gets you approximately:
- ~1,000 GPT-4o calls
- ~10,000 DeepSeek calls
- ~20 DALL-E images
Security
- Your private key stays on your machine (
~/.blockrun/) - Only cryptographic signatures are sent to servers
- All payments are verifiable on Basescan
- You control your wallet — withdraw anytime
Troubleshooting
MCP not loading?
Restart Claude Code after installation:
# Check if MCP is registered
claude mcp list
Wallet not found?
# Check wallet location
ls ~/.blockrun/
Transaction failed?
Check your USDC balance on Base:
blockrun balance
For more help, see MCP Troubleshooting.