@blockrun/mcp
Advanced tools
BlockRun MCP Server - Access 30+ AI models via x402 micropayments. No API keys needed.
Want to use GPT-5, Gemini, or DeepSeek in Claude Code? Today you need to:
That's too much friction.
BlockRun MCP gives you access to 30+ AI models with:
claude mcp add blockrun npx @blockrun/mcp
Alternative: Prefer Python? Try the BlockRun Skill (
pip install blockrun-llm) - same features, different integration style.
claude mcp add blockrun npx @blockrun/mcp
A wallet is automatically created for you.
You: blockrun setup
Claude: Your wallet address is 0x...
Send USDC on Base network to fund it.
Send USDC to your wallet address on Base network. Even $5 gets you hundreds of requests.
| Method | Steps |
|---|---|
| From Coinbase | Send → USDC → Select "Base" network → Paste your address |
| Bridge | bridge.base.org → Bridge USDC to Base |
| Buy Direct | Coinbase Onramp → Buy USDC on Base |
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
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 modelanthropic/claude-opus-4 - Best for complex reasoninganthropic/claude-sonnet-4 - Fast & capable (recommended)google/gemini-2.5-pro - Great for long context (1M tokens)deepseek/deepseek-chat - Very affordableLet 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
| Mode | Models Used | Best For |
|---|---|---|
fast | Gemini Flash, GPT-4o-mini | Quick responses |
balanced | GPT-4o, Claude Sonnet | Daily tasks |
powerful | GPT-5.2, Claude Opus, o3 | Complex work |
cheap | Gemini Flash, DeepSeek | Budget-conscious |
reasoning | o3, o1, DeepSeek Reasoner | Logic & math |
blockrun generate an image of a cyberpunk cityscape
blockrun create a watercolor painting of mountains
blockrun list models
blockrun show OpenAI models with pricing
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]
blockrun setup # First-time setup instructions
blockrun wallet # Check your wallet address
blockrun balance # Check on-chain USDC balance
Control your session spending:
blockrun budget check # View current spending
blockrun budget set $1.00 # Set $1.00 limit
blockrun budget clear # Remove limit
| Provider | Models | Input Price | Output Price |
|---|---|---|---|
| OpenAI | GPT-5.2, GPT-5-mini, GPT-4o, o3, o1 | $0.15 - $21/M | $0.60 - $84/M |
| Anthropic | Claude Opus 4, Sonnet 4, Haiku | $0.25 - $15/M | $1.25 - $75/M |
| Gemini 3 Pro, 2.5 Pro/Flash | Free - $2.50/M | Free - $15/M | |
| DeepSeek | V3.2, Reasoner | $0.14 - $0.55/M | $0.28 - $2.19/M |
| xAI | Grok 3, Grok 3 Mini | $3 - $5/M | $15 - $25/M |
M = million tokens. Prices in USD.
| Model | Price per Image |
|---|---|
| DALL-E 3 (Standard) | $0.04 |
| DALL-E 3 (HD) | $0.08 |
| Flux Schnell | $0.02 |
| Task | Model | Approx. Cost |
|---|---|---|
| Quick question | Gemini Flash | $0.0001 |
| Code review | Claude Sonnet | $0.003 |
| Complex analysis | GPT-4o | $0.005 |
| Long document | Claude Opus | $0.02 |
| Image generation | DALL-E 3 | $0.04 |
$5 gets you approximately:
When you first use BlockRun MCP, a wallet is automatically created and saved to:
~/.blockrun/.session
This wallet is:
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...
BLOCKRUN_WALLET_KEYBASE_CHAIN_WALLET_KEY~/.blockrun/.session┌─────────────────────────────────────────────────────────────┐
│ 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:
| claude-code-proxy | BlockRun MCP | |
|---|---|---|
| API Keys | Required (bring your own) | Not needed |
| Setup | Configure each provider | One command |
| Billing | Multiple subscriptions | Unified wallet |
| gemini-mcp | BlockRun MCP | |
|---|---|---|
| Models | Gemini only | 30+ models, 6 providers |
| API Key | Required | Not needed |
| Payment | Google billing | Pay-per-use crypto |
| Direct APIs | BlockRun MCP | |
|---|---|---|
| Accounts | 5+ accounts needed | One wallet |
| Minimums | $20-100/mo per provider | $0 minimum |
| Management | Complex | Simple |
Your wallet needs funding. Say blockrun setup to get your address and funding instructions.
The MCP couldn't find or create a wallet. Check that ~/.blockrun/ directory is writable.
Some models have rate limits. Try blockrun smart cheap or blockrun smart fast to use alternative models.
Say blockrun balance to check your on-chain USDC balance, or visit: https://basescan.org/address/YOUR_ADDRESS
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.
# 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
| Variable | Description |
|---|---|
BLOCKRUN_WALLET_KEY | Your wallet private key (hex, starts with 0x) |
BASE_CHAIN_WALLET_KEY | Alternative name for wallet key |
# 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
MIT
FAQs
BlockRun MCP Server - Access 30+ AI models via x402 micropayments. No API keys needed.
We found that @blockrun/mcp demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
TeamPCP is targeting security tools across the OSS ecosystem, turning scanners and CI pipelines into infostealers to access enterprise secrets.
Security News
TypeScript 6.0 introduces new standard APIs, modern default settings, and deprecations as it prepares projects for the upcoming TypeScript 7.0 release.
Security News
/Research
Newly published Trivy Docker images (0.69.4, 0.69.5, and 0.69.6) were found to contain infostealer IOCs and were pushed to Docker Hub without corresponding GitHub releases.