Give your AI agent superpowers — web search, deep research, prediction markets, crypto data, X/Twitter intelligence.
BlockRun MCP gives your AI agent access to live data it can't get on its own — real-time web search, neural research, prediction markets, crypto DEX prices, and X/Twitter intelligence. All paid via x402 micropayments in USDC. No API keys. No subscriptions. No accounts.
claude mcp add blockrun -- npx @blockrun/mcpA wallet is automatically created on first use. Fund it with USDC on Base and every tool is immediately available.
claude mcp add blockrun --transport http https://mcp.blockrun.ai/mcpNo Node.js. No npm. Works from any MCP client. Pass your wallet key via X-Wallet-Key header, or run blockrun_wallet for setup instructions.
| Tool | What it does | Cost |
|---|---|---|
blockrun_search |
Real-time web + news search | ~$0.01/search |
blockrun_exa |
Neural research (Exa) — finds papers, competitors, similar products | $0.01/call |
blockrun_twitter |
X/Twitter intelligence via Grok — search, trends, user analysis | per token |
blockrun_markets |
Prediction markets — Polymarket, Kalshi | $0.001/call |
blockrun_dex |
Real-time DEX prices and liquidity via DexScreener | FREE |
blockrun_image |
Image generation and editing (DALL-E 3, Flux) | $0.02–0.08 |
blockrun_chat |
41 AI models — get a second opinion or use a specialized model | per token |
blockrun_wallet |
Wallet balance, agent budgets, spending reports | FREE |
blockrun_models |
List all models with pricing | FREE |
Your AI agent already has an LLM. What it doesn't have: access to the live internet, research tools, market data, or a way to pay for services autonomously.
BlockRun fills this gap. Every tool call is a real micropayment — authorized locally by a wallet the agent controls. No API keys to manage, no vendor accounts to create. Just a wallet and USDC.
For multi-agent systems: parent agents can delegate spending limits to child agents by agent_id. When a child hits its limit, further calls are automatically blocked.
# Check your wallet address
blockrun_wallet action:"status"
Send USDC on Base network to your wallet address. $5 gets you started — that's ~500 Exa searches or ~50,000 Gemini Flash calls.
| Method | Steps |
|---|---|
| Coinbase | Send → USDC → Select "Base" network → Paste address |
| Bridge | bridge.base.org → Bridge USDC to Base |
Every request is paid via the x402 protocol — an open standard for machine-to-machine micropayments. Payments settle in USDC on Base (or Solana). Your wallet is created automatically on first use and stored locally at ~/.blockrun/.session. The private key is used only to sign payment authorizations locally — it is never transmitted to any server.
| Variable | Description |
|---|---|
BLOCKRUN_WALLET_KEY |
Bring your own private key (hex for Base, bs58 for Solana). Optional — a wallet is auto-generated if not set. |
Wallet resolution order:
BLOCKRUN_WALLET_KEYenvironment variableBASE_CHAIN_WALLET_KEYenvironment variable~/.blockrun/.session(auto-created on first use)
- Website: blockrun.ai
- npm: @blockrun/mcp
- Hosted MCP: mcp.blockrun.ai
- GitHub: github.com/blockrunai/blockrun-mcp
- Telegram: t.me/+mroQv4-4hGgzOGUx
- X: @BlockRunAI
MIT