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. BlockRun MCP gives you access to 30+ AI models with: - Zero API keys - No accounts needed with OpenAI, Google, etc. - One wallet - Single
Add this skill
npx mdskills install blockrunai/blockrun-mcpUnifies 30+ AI models through crypto payments with clear setup and comprehensive pricing docs
1# @blockrun/mcp23## The Problem45Want to use GPT-5, Gemini, or DeepSeek in Claude Code? Today you need to:671. Create accounts with 5+ AI providers82. Manage 5+ API keys and billing systems93. Pay $20-100/month minimums per provider104. Configure each provider separately1112**That's too much friction.**1314## The Solution1516BlockRun MCP gives you access to 30+ AI models with:1718- **Zero API keys** - No accounts needed with OpenAI, Google, etc.19- **One wallet** - Single USDC balance for all providers20- **Pay-per-use** - No minimums, $5 gets you started21- **One command** - Install and go2223```bash24claude mcp add blockrun npx @blockrun/mcp25```2627> **Alternative:** Prefer Python? Try the [BlockRun Skill](https://github.com/BlockRunAI/claude-code-blockrun-agent) (`pip install blockrun-llm`) - same features, different integration style.2829## Quick Start3031### 1. Install3233```bash34claude mcp add blockrun npx @blockrun/mcp35```3637A wallet is automatically created for you.3839### 2. Get Your Wallet Address4041```42You: blockrun setup4344Claude: Your wallet address is 0x...45 Send USDC on Base network to fund it.46```4748### 3. Fund Your Wallet4950Send USDC to your wallet address on **Base** network. Even $5 gets you hundreds of requests.5152| Method | Steps |53|--------|-------|54| **From Coinbase** | Send → USDC → Select "Base" network → Paste your address |55| **Bridge** | [bridge.base.org](https://bridge.base.org) → Bridge USDC to Base |56| **Buy Direct** | [Coinbase Onramp](https://www.coinbase.com/onramp) → Buy USDC on Base |5758### 4. Start Using5960Just ask naturally:6162```63You: blockrun ask GPT-5 to explain quantum computing6465You: blockrun chat with Claude Opus about this error6667You: blockrun generate an image of a mountain sunset68```6970## Usage Examples7172### Chat with Any Model7374```75blockrun ask GPT-5 what causes aurora borealis7677blockrun chat with Claude Opus about optimizing this algorithm7879blockrun ask Gemini Pro to review this code for security issues80```8182**Popular Models:**83- `openai/gpt-5.2` - Most capable OpenAI model84- `anthropic/claude-opus-4` - Best for complex reasoning85- `anthropic/claude-sonnet-4` - Fast & capable (recommended)86- `google/gemini-2.5-pro` - Great for long context (1M tokens)87- `deepseek/deepseek-chat` - Very affordable8889### Smart Model Selection9091Let BlockRun pick the best model for your needs:9293```94blockrun smart fast: what's 2+29596blockrun smart powerful: analyze this complex codebase9798blockrun smart cheap: summarize this text99```100101| Mode | Models Used | Best For |102|------|-------------|----------|103| `fast` | Gemini Flash, GPT-4o-mini | Quick responses |104| `balanced` | GPT-4o, Claude Sonnet | Daily tasks |105| `powerful` | GPT-5.2, Claude Opus, o3 | Complex work |106| `cheap` | Gemini Flash, DeepSeek | Budget-conscious |107| `reasoning` | o3, o1, DeepSeek Reasoner | Logic & math |108109### Generate Images110111```112blockrun generate an image of a cyberpunk cityscape113114blockrun create a watercolor painting of mountains115```116117### List Available Models118119```120blockrun list models121122blockrun show OpenAI models with pricing123```124125### Real-Time X/Twitter Search126127Get live data from X/Twitter using Grok's real-time search:128129```130blockrun twitter: what is @elonmusk posting about today131132blockrun twitter: trending AI news133134blockrun twitter: reactions to [recent event]135```136137### Wallet & Balance138139```140blockrun setup # First-time setup instructions141blockrun wallet # Check your wallet address142blockrun balance # Check on-chain USDC balance143```144145### Budget Management146147Control your session spending:148149```150blockrun budget check # View current spending151blockrun budget set $1.00 # Set $1.00 limit152blockrun budget clear # Remove limit153```154155## Supported Models & Pricing156157### Chat Models158159| Provider | Models | Input Price | Output Price |160|----------|--------|-------------|--------------|161| **OpenAI** | GPT-5.2, GPT-5-mini, GPT-4o, o3, o1 | $0.15 - $21/M | $0.60 - $84/M |162| **Anthropic** | Claude Opus 4, Sonnet 4, Haiku | $0.25 - $15/M | $1.25 - $75/M |163| **Google** | Gemini 3 Pro, 2.5 Pro/Flash | Free - $2.50/M | Free - $15/M |164| **DeepSeek** | V3.2, Reasoner | $0.14 - $0.55/M | $0.28 - $2.19/M |165| **xAI** | Grok 3, Grok 3 Mini | $3 - $5/M | $15 - $25/M |166167*M = million tokens. Prices in USD.*168169### Image Models170171| Model | Price per Image |172|-------|-----------------|173| DALL-E 3 (Standard) | $0.04 |174| DALL-E 3 (HD) | $0.08 |175| Flux Schnell | $0.02 |176177### Cost Examples178179| Task | Model | Approx. Cost |180|------|-------|--------------|181| Quick question | Gemini Flash | $0.0001 |182| Code review | Claude Sonnet | $0.003 |183| Complex analysis | GPT-4o | $0.005 |184| Long document | Claude Opus | $0.02 |185| Image generation | DALL-E 3 | $0.04 |186187**$5 gets you approximately:**188- 50,000 Gemini Flash requests, OR189- 1,600 Claude Sonnet requests, OR190- 1,000 GPT-4o requests, OR191- 125 DALL-E 3 images192193## Wallet Management194195### Auto-Generated Wallet196197When you first use BlockRun MCP, a wallet is automatically created and saved to:198```199~/.blockrun/.session200```201202This wallet is:203- Created locally on your machine204- Never transmitted to any server205- Used only for signing payment authorizations206- Persistent across sessions207208### Using Your Own Wallet209210If you prefer to use an existing wallet:211212```bash213# Option 1: Environment variable214export BLOCKRUN_WALLET_KEY=0x...215216# Option 2: Add with Claude Code217claude mcp add blockrun npx @blockrun/mcp --env BLOCKRUN_WALLET_KEY=0x...218```219220### Wallet Priority2212221. Environment variable `BLOCKRUN_WALLET_KEY`2232. Environment variable `BASE_CHAIN_WALLET_KEY`2243. File at `~/.blockrun/.session`2254. Auto-generate new wallet (saved to file)226227## How Payment Works228229```230┌─────────────────────────────────────────────────────────────┐231│ 1. You send a request (e.g., chat with GPT-5) │232│ ↓ │233│ 2. BlockRun calculates cost based on tokens │234│ ↓ │235│ 3. Your wallet signs a payment authorization LOCALLY │236│ (private key NEVER leaves your machine) │237│ ↓ │238│ 4. Payment settles on Base network via USDC │239│ ↓ │240│ 5. You receive your AI response │241└─────────────────────────────────────────────────────────────┘242```243244**Security Guarantees:**245- Private key is used ONLY for local signing246- Key is NEVER transmitted to any server247- Same security model as MetaMask transactions248- You can verify all transactions on [Basescan](https://basescan.org)249250## Comparison with Alternatives251252### vs claude-code-proxy253| | claude-code-proxy | BlockRun MCP |254|---|---|---|255| API Keys | Required (bring your own) | **Not needed** |256| Setup | Configure each provider | **One command** |257| Billing | Multiple subscriptions | **Unified wallet** |258259### vs gemini-mcp260| | gemini-mcp | BlockRun MCP |261|---|---|---|262| Models | Gemini only | **30+ models, 6 providers** |263| API Key | Required | **Not needed** |264| Payment | Google billing | **Pay-per-use crypto** |265266### vs Direct API Keys267| | Direct APIs | BlockRun MCP |268|---|---|---|269| Accounts | 5+ accounts needed | **One wallet** |270| Minimums | $20-100/mo per provider | **$0 minimum** |271| Management | Complex | **Simple** |272273## Troubleshooting274275### "Payment was rejected"276Your wallet needs funding. Say `blockrun setup` to get your address and funding instructions.277278### "Wallet key required"279The MCP couldn't find or create a wallet. Check that `~/.blockrun/` directory is writable.280281### Model not responding282Some models have rate limits. Try `blockrun smart cheap` or `blockrun smart fast` to use alternative models.283284### Check wallet balance285Say `blockrun balance` to check your on-chain USDC balance, or visit: `https://basescan.org/address/YOUR_ADDRESS`286287### Budget limit reached288If 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.289290## Configuration291292### Claude Code Setup293294```bash295# Basic (recommended)296claude mcp add blockrun npx @blockrun/mcp297298# With explicit wallet299claude mcp add blockrun npx @blockrun/mcp --env BLOCKRUN_WALLET_KEY=0x...300301# Project-specific302claude mcp add blockrun --scope project npx @blockrun/mcp303304# User-wide (all projects)305claude mcp add blockrun --scope user npx @blockrun/mcp306```307308### Environment Variables309310| Variable | Description |311|----------|-------------|312| `BLOCKRUN_WALLET_KEY` | Your wallet private key (hex, starts with 0x) |313| `BASE_CHAIN_WALLET_KEY` | Alternative name for wallet key |314315## Development316317```bash318# Clone319git clone https://github.com/blockrunai/blockrun-mcp320cd blockrun-mcp321322# Install dependencies323npm install324325# Development mode (auto-reload)326npm run dev327328# Build for production329npm run build330331# Test locally332echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | node dist/index.js333```334335## Links336337- **Website:** [blockrun.ai](https://blockrun.ai)338- **Documentation:** [GitHub Docs](https://github.com/BlockRunAI/awesome-blockrun/tree/main/docs)339- **Pricing:** [blockrun.ai/pricing](https://blockrun.ai/pricing)340- **GitHub:** [github.com/blockrunai](https://github.com/blockrunai)341- **Twitter:** [@BlockRunAI](https://x.com/BlockRunAI)342343## Support344345- **Issues:** [GitHub Issues](https://github.com/blockrunai/blockrun-mcp/issues)346- **Telegram:** [Join our Telegram](https://t.me/+mroQv4-4hGgzOGUx)347- **Email:** hello@blockrun.ai348349## License350351MIT352
Full transparency — inspect the skill content before installing.