BlockRun MCP
Real-time data for Claude — markets, research, X/Twitter, crypto. No API keys. Pay per call.
claude mcp add blockrun npx -y @blockrun/mcp@latest
Wallet auto-created. Fund with $5 USDC. Ask Claude anything.
What changes
Before BlockRun, Claude can't answer:
- "What's the current Polymarket probability that Bitcoin hits $100k this year?"
- "Find me the top 5 papers on RAG published in the last 30 days"
- "What are people saying about @sama on X right now?"
- "What's the 24h volume on the PEPE/ETH pair on Uniswap?"
After BlockRun, it can. Each query costs fractions of a cent, billed from a local USDC wallet. No subscriptions. No API dashboards. No key rotation.
Demo
User: What's Polymarket saying about the Fed rate decision next month?
Claude: According to Polymarket, the market currently puts a 73% probability on the Fed holding rates steady at the May meeting, with 24% on a 25bp cut and 3% on a hike. Volume over the last 24h: $2.1M. The "Hold" contract last traded at $0.73.
(via blockrun_markets · cost: $0.001)
User: Find recent papers on speculative decoding and summarize the key approaches
Claude: I found 8 papers from the last 60 days via neural search. The dominant approaches are: (1) draft model selection — smaller models predicting N tokens ahead for the larger model to verify in parallel...
(via blockrun_exa · cost: $0.01)
Install
Claude Code (recommended)
claude mcp add blockrun npx -y @blockrun/mcp@latest
Claude Desktop — add to claude_desktop_config.json:
{
"mcpServers": {
"blockrun": {
"command": "npx",
"args": ["-y", "@blockrun/mcp"]
}
}
}
Hosted (no install, always latest)
claude mcp add --transport http blockrun https://mcp.blockrun.ai/mcp
Fund your wallet
Run blockrun_wallet to see your address. Send USDC on Base.
| Method | Steps |
|--------|-------|
| Coinbase | Send → USDC → Base network → paste address |
| Bridge from Ethereum | bridge.base.org |
$5 covers ~5,000 market queries, ~500 Exa searches, or ~250 image generations.
Tools
| Tool | Data source | Cost |
|------|-------------|------|
| blockrun_markets | Polymarket, Kalshi, dFlow, Binance Futures | $0.001/query |
| blockrun_exa | Neural web search (Exa) — research, competitors, papers, URL content | $0.01/query |
| blockrun_search | Web + news with citations | ~$0.01 |
| blockrun_twitter | X/Twitter — profiles, tweets, trends, Grok sentiment | per token |
| blockrun_dex | Live DEX prices via DexScreener | free |
| blockrun_image | DALL-E 3, Flux image generation + editing | $0.02–0.08 |
| blockrun_chat | GPT-4o, Gemini, DeepSeek, 30+ models | per token |
| blockrun_wallet | Balance, spending, agent budgets | free |
Why not just use the APIs directly?
| | Direct APIs | BlockRun |
|---|---|---|
| Exa | Sign up, $20/mo minimum | $0.01/call, no subscription |
| Polymarket | Undocumented, rate-limited | $0.001/call, clean JSON |
| Twitter/X API | $100–$5000/month | $0.03/page, no approval |
| Multiple sources | 4 accounts, 4 API keys, 4 billing pages | 1 wallet |
One wallet. All sources. No dashboards.
Multi-agent budget delegation
Delegate a spending budget to a child agent with agent_id. The child is auto-blocked when the budget runs out — useful for autonomous agents that shouldn't run up unbounded costs.
How it works
Pay-per-call via x402 micropayments in USDC on Base. Your wallet lives at ~/.blockrun/.session. Private key never leaves your machine.
[blockrun.ai](ht
... View full README on GitHub