Package Exports

@blockrun/mcp
@blockrun/mcp/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@blockrun/mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

BlockRun MCP

Real-time data for Claude — markets, research, X/Twitter, crypto. No API keys. Pay per call.

claude mcp add blockrun -s user -- 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 -s user -- npx -y @blockrun/mcp@latest

The -s user flag installs globally (available in every project). The -- separator ensures -y is passed to npx, not parsed by claude mcp add.

Claude Desktop — add to claude_desktop_config.json:

{
  "mcpServers": {
    "blockrun": {
      "command": "npx",
      "args": ["-y", "@blockrun/mcp"]
    }
  }
}

Hosted (no install, always latest)

claude mcp add blockrun -s user --transport http 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