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 · npm · @BlockRunAI

blockrunai/blockrun-mcp