BlockRun MCP
Give Claude Code access to 33+ AI models with zero API keys.
BlockRun MCP is a Model Context Protocol server that connects Claude Code to BlockRun's intelligence, trading, and creation capabilities.
Latest version: v0.4.2
Installation
claude mcp add blockrun -- npx @blockrun/mcp
That's it. Restart Claude Code and the MCP is available.
What It Enables
| Capability | Example |
|---|---|
| Multi-model access | "Use GPT-5 to review this code" |
| Image generation | "Generate a logo for my app" |
| Real-time data | "What's trending on X?" |
| Cost optimization | "Use DeepSeek for bulk processing" |
How It Works
- You ask Claude to use an external capability
- Claude calls the BlockRun MCP tool
- MCP signs a USDC payment locally
- Request goes to BlockRun with payment signature
- BlockRun verifies, calls the provider, returns result
Your private key stays on your machine.
Setup
1. Install MCP
claude mcp add blockrun -- npx @blockrun/mcp
2. Setup Wallet
In Claude Code:
blockrun setup
This creates or displays your wallet address.
3. Fund Wallet
Send USDC to your wallet on Base network:
- Coinbase — withdraw directly to Base
- Base Bridge — bridge from Ethereum
Recommended: $5-20 to start.
4. Verify
blockrun balance
Or ask: "What's my BlockRun wallet balance?"
Available Tools
The MCP exposes these tools to Claude:
blockrun_chat
Call any supported LLM model.
Use GPT-5.4 to explain this error
blockrun_image
Generate images via DALL-E or Nano Banana.
Generate an image of a futuristic city
blockrun_models
List available models with context window sizes and categories.
Show me all available BlockRun models
Returns model details including context_window, max_output, and categories for each model.
blockrun_wallet
Check wallet balance and address.
blockrun balance
Smart Routing
The MCP includes built-in smart routing that selects the best model based on your intent:
| Mode | Models | Best For |
|---|---|---|
fast | Gemini Flash, GPT-5 Mini | Quick responses |
balanced | GPT-5.4, Claude Sonnet 4.6 | General use |
powerful | GPT-5.4, Claude Opus 4.6 | Complex tasks |
cheap | NVIDIA free models, DeepSeek, Gemini Flash | Cost savings |
reasoning | o3, o1, DeepSeek Reasoner | Logic and math |
Configuration
Environment Variables
# Optional: Custom wallet location
export BLOCKRUN_WALLET_PATH=~/.blockrun/custom-wallet.json
# Optional: Session budget limit
export BLOCKRUN_SESSION_BUDGET=10.00
Claude Code Settings
View MCP configuration:
claude mcp list
Remove if needed:
claude mcp remove blockrun
Pricing
- Intelligence: Provider cost + 5%
- Images: $0.05-0.12 per image
- No subscriptions, no minimums
See Intelligence Pricing for details.
Security
| Aspect | How It's Protected |
|---|---|
| Private key | Stored locally at ~/.blockrun/ |
| Payments | Only signatures sent, key never transmitted |
| Verification | All transactions viewable on Basescan |
| Control | You control your wallet, withdraw anytime |
Common Commands
# Check balance
blockrun balance
# Setup/view wallet
blockrun setup
# Use a specific model
Use GPT-5 to analyze this
# Generate image
Create an image of [description]
# Get second opinion
Ask Claude Opus what it thinks about this approach
Troubleshooting
See MCP Troubleshooting for common issues.
Quick Fixes
MCP not loading:
# Restart Claude Code
pkill -f "claude"
claude
# Verify installation
claude mcp list
Wallet not found:
blockrun setup
Insufficient balance:
blockrun balance
Fund your wallet if needed.