@blockrun/mcp

Access 30+ AI models in Claude Code with zero API keys. One wallet, pay-per-request.

GitHub

@blockrun/mcp

The Problem

Want to use GPT-5, Gemini, or DeepSeek in Claude Code? Today you need to:

  1. Create accounts with 5+ AI providers
  2. Manage 5+ API keys and billing systems
  3. Pay $20-100/month minimums per provider
  4. Configure each provider separately

That's too much friction.

The Solution

BlockRun MCP gives you access to 30+ AI models with:

  • Zero API keys - No accounts needed with OpenAI, Google, etc.
  • One wallet - Single USDC balance for all providers
  • Pay-per-use - No minimums, $5 gets you started
  • One command - Install and go
claude mcp add blockrun npx @blockrun/mcp

Alternative: Prefer Python? Try the BlockRun Skill (pip install blockrun-llm) - same features, different integration style.

Quick Start

1. Install

claude mcp add blockrun npx @blockrun/mcp

A wallet is automatically created for you.

2. Get Your Wallet Address

You: blockrun setup

Claude: Your wallet address is 0x...
        Send USDC on Base network to fund it.

3. Fund Your Wallet

Send USDC to your wallet address on Base network. Even $5 gets you hundreds of requests.

MethodSteps
From CoinbaseSend → USDC → Select "Base" network → Paste your address
Bridgebridge.base.org → Bridge USDC to Base
Buy DirectCoinbase Onramp → Buy USDC on Base

4. Start Using

Just ask naturally:

You: blockrun ask GPT-5 to explain quantum computing

You: blockrun chat with Claude Opus about this error

You: blockrun generate an image of a mountain sunset

Usage Examples

Chat with Any Model

blockrun ask GPT-5 what causes aurora borealis

blockrun chat with Claude Opus about optimizing this algorithm

blockrun ask Gemini Pro to review this code for security issues

Popular Models:

  • openai/gpt-5.2 - Most capable OpenAI model
  • anthropic/claude-opus-4 - Best for complex reasoning
  • anthropic/claude-sonnet-4 - Fast & capable (recommended)
  • google/gemini-2.5-pro - Great for long context (1M tokens)
  • deepseek/deepseek-chat - Very affordable

Smart Model Selection

Let BlockRun pick the best model for your needs:

blockrun smart fast: what's 2+2

blockrun smart powerful: analyze this complex codebase

blockrun smart cheap: summarize this text
ModeModels UsedBest For
fastGemini Flash, GPT-4o-miniQuick responses
balancedGPT-4o, Claude SonnetDaily tasks
powerfulGPT-5.2, Claude Opus, o3Complex work
cheapGemini Flash, DeepSeekBudget-conscious
reasoningo3, o1, DeepSeek ReasonerLogic & math

Generate Images

blockrun generate an image of a cyberpunk cityscape

blockrun create a watercolor painting of mountains

List Available Models

blockrun list models

blockrun show OpenAI models with pricing

Real-Time X/Twitter Search

Get live data from X/Twitter using Grok's real-time search:

blockrun twitter: what is @elonmusk posting about today

blockrun twitter: trending AI news

blockrun twitter: reactions to [recent event]

Wallet & Balance

blockrun setup          # First-time setup instructions
blockrun wallet         # Check your wallet address
blockrun balance        # Check on-chain USDC balance

Budget Management

Control your session spending:

blockrun budget check              # View current spending
blockrun budget set $1.00          # Set $1.00 limit
blockrun budget clear              # Remove limit

Supported Models & Pricing

Chat Models

ProviderModelsInput PriceOutput Price
OpenAIGPT-5.2, GPT-5-mini, GPT-4o, o3, o1$0.15 - $21/M$0.60 - $84/M
AnthropicClaude Opus 4, Sonnet 4, Haiku$0.25 - $15/M$1.25 - $75/M
GoogleGemini 3 Pro, 2.5 Pro/FlashFree - $2.50/MFree - $15/M
DeepSeekV3.2, Reasoner$0.14 - $0.55/M$0.28 - $2.19/M
xAIGrok 3, Grok 3 Mini$3 - $5/M$15 - $25/M

M = million tokens. Prices in USD.

Image Models

ModelPrice per Image
DALL-E 3 (Standard)$0.04
DALL-E 3 (HD)$0.08
Flux Schnell$0.02

Cost Examples

TaskModelApprox. Cost
Quick questionGemini Flash$0.0001
Code reviewClaude Sonnet$0.003
Complex analysisGPT-4o$0.005
Long documentClaude Opus$0.02
Image generationDALL-E 3$0.04

$5 gets you approximately:

  • 50,000 Gemini Flash requests, OR
  • 1,600 Claude Sonnet requests, OR
  • 1,000 GPT-4o requests, OR
  • 125 DALL-E 3 images

Wallet Management

Auto-Generated Wallet

When you first use BlockRun MCP, a wallet is automatically created and saved to:

~/.blockrun/.session

This wallet is:

  • Created locally on your machine
  • Never transmitted to any server
  • Used only for signing payment authorizations
  • Persistent across sessions

Using Your Own Wallet

If you prefer to use an existing wallet:

# Option 1: Environment variable
export BLOCKRUN_WALLET_KEY=0x...

# Option 2: Add with Claude Code
claude mcp add blockrun npx @blockrun/mcp --env BLOCKRUN_WALLET_KEY=0x...

Wallet Priority

  1. Environment variable BLOCKRUN_WALLET_KEY
  2. Environment variable BASE_CHAIN_WALLET_KEY
  3. File at ~/.blockrun/.session
  4. Auto-generate new wallet (saved to file)

How Payment Works

┌─────────────────────────────────────────────────────────────┐
│  1. You send a request (e.g., chat with GPT-5)              │
│                          ↓                                  │
│  2. BlockRun calculates cost based on tokens                │
│                          ↓                                  │
│  3. Your wallet signs a payment authorization LOCALLY       │
│     (private key NEVER leaves your machine)                 │
│                          ↓                                  │
│  4. Payment settles on Base network via USDC                │
│                          ↓                                  │
│  5. You receive your AI response                            │
└─────────────────────────────────────────────────────────────┘

Security Guarantees:

  • Private key is used ONLY for local signing
  • Key is NEVER transmitted to any server
  • Same security model as MetaMask transactions
  • You can verify all transactions on Basescan

Comparison with Alternatives

vs claude-code-proxy

claude-code-proxyBlockRun MCP
API KeysRequired (bring your own)Not needed
SetupConfigure each providerOne command
BillingMultiple subscriptionsUnified wallet

vs gemini-mcp

gemini-mcpBlockRun MCP
ModelsGemini only30+ models, 6 providers
API KeyRequiredNot needed
PaymentGoogle billingPay-per-use crypto

vs Direct API Keys

Direct APIsBlockRun MCP
Accounts5+ accounts neededOne wallet
Minimums$20-100/mo per provider$0 minimum
ManagementComplexSimple

Troubleshooting

"Payment was rejected"

Your wallet needs funding. Say blockrun setup to get your address and funding instructions.

"Wallet key required"

The MCP couldn't find or create a wallet. Check that ~/.blockrun/ directory is writable.

Model not responding

Some models have rate limits. Try blockrun smart cheap or blockrun smart fast to use alternative models.

Check wallet balance

Say blockrun balance to check your on-chain USDC balance, or visit: https://basescan.org/address/YOUR_ADDRESS

Budget limit reached

If you've set a session budget and hit the limit, use blockrun budget clear to remove it or blockrun budget set $X to increase it.

Configuration

Claude Code Setup

# Basic (recommended)
claude mcp add blockrun npx @blockrun/mcp

# With explicit wallet
claude mcp add blockrun npx @blockrun/mcp --env BLOCKRUN_WALLET_KEY=0x...

# Project-specific
claude mcp add blockrun --scope project npx @blockrun/mcp

# User-wide (all projects)
claude mcp add blockrun --scope user npx @blockrun/mcp

Environment Variables

VariableDescription
BLOCKRUN_WALLET_KEYYour wallet private key (hex, starts with 0x)
BASE_CHAIN_WALLET_KEYAlternative name for wallet key

Development

# Clone
git clone https://github.com/blockrunai/blockrun-mcp
cd blockrun-mcp

# Install dependencies
npm install

# Development mode (auto-reload)
npm run dev

# Build for production
npm run build

# Test locally
echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | node dist/index.js

Links

Support

License

MIT

Related Servers