About io.github.BlockRunAI/blockrun-mcp
io.github.BlockRunAI/blockrun-mcp is an MCP server published by BlockRunAI in the Blockchain category: blockRun MCP Server - Access 30+ AI models via x402 micropayments. No API keys needed.
The repository has 392 stars and 41 forks, with the last commit 2 days ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
claude mcp add io-github-blockrunai-blockrun-mcp -- npx -y @blockrun/mcpnpx -y @blockrun/mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (19)
blockrun_chat<!-- br:models.chatVisible -->78<!-- /br:models.chatVisible --> LLMs (GPT, Claude, Gemini, DeepSeek, Kimi K3, GLM, NVIDIA free tier, …) with `mode` tier routing
Parameters not published.
blockrun_defiDefiLlama — protocol TVL, chain TVL, yield pools (APY), token prices
Parameters not published.
blockrun_dexLive DEX prices via DexScreener
Parameters not published.
blockrun_exaNeural web search (Exa) — research, competitors, papers, URL content
Parameters not published.
blockrun_imageGenerate: openai/gpt-image-2, gpt-image-1, google/nano-banana(-2/-pro), xai/grok-imagine-image(-pro), zai/cogview-4, bytedance/seedream-5-pro. Edit: img2img, inpaint, fusion.
Parameters not published.
blockrun_marketsPolymarket (markets, candles, trades, orderbooks, leaderboards, smart-wallet PnL/clusters, UMA oracle), Kalshi, Limitless, Opinion, Predict.Fun, dFlow, Binance Futures, cross-platform search
Parameters not published.
blockrun_modalIsolated code execution in a BlockRun-hosted Modal sandbox — disposable container, optional GPU (T4 → H100)
Parameters not published.
blockrun_modelsLive catalogue of every LLM/image/video/music model + pricing
Parameters not published.
blockrun_musicMiniMax music generation
Parameters not published.
blockrun_phoneOutbound AI voice calls (Bland) + wallet-owned US/CA numbers (Twilio), carrier + fraud lookups
Parameters not published.
Show all 19 tools
blockrun_polymarket**Trade on Polymarket** (CLOB V2): place/cancel real bets, positions, redeem winnings — signed locally, settled in pUSD from a gasless deposit wallet. Confirm-gated, $25/order default cap. [Details ↓](#-polymarket-trading)
Parameters not published.
blockrun_polymarket_readRead-only Polymarket positions/open orders plus executable live order previews, separated for MCP clients that enforce tool safety annotations
Parameters not published.
blockrun_pricePyth-backed realtime + OHLC — crypto / FX / commodity, plus the ticker catalog for 12 equity markets (equity quotes withdrawn 2026-09-05)
Parameters not published.
blockrun_realfaceEnroll a real person (phone liveness) or AI character (Virtual Portrait) as a `ta_xxxx` asset for Seedance 2.0 / 2.0-fast / 2.0-mini video (not 2.5)
Parameters not published.
blockrun_rpcRaw JSON-RPC on <!-- br:chains.rpc -->40<!-- /br:chains.rpc --> chains (Ethereum, Base, Solana, Bitcoin, Sui, NEAR, …) via Tatum
Parameters not published.
blockrun_searchGrok Live Search — web + X/Twitter + news with citations
Parameters not published.
blockrun_speechElevenLabs TTS (Flash/Turbo/Multilingual/v3, 8 voices) + ByteDance Seed Audio (prompt-directed) + cinematic sound effects; free voice listing
Parameters not published.
blockrun_videoSora 2 + xAI Grok Imagine Video + ByteDance Seedance 1.5/2.0-mini/2.0-fast/2.0/2.5 (720p + audio; 4K on 2.0, up to 30s on 2.5); RealFace asset → real-person video
Parameters not published.
blockrun_walletBalance, spending, agent budgets, setup QR, chain switch
Parameters not published.
Ask AI
Ask AI about io.github.BlockRunAI/blockrun-mcp
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
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, ~250 image generations, or ~30 Seedance 1.5-pro clips (5s).
Tools
| Tool | Data source | Cost |
|---|---|---|
blockrun_chat |
55+ LLMs (GPT, Claude, Gemini, DeepSeek, Kimi K2.6, GLM, NVIDIA free tier, ...) with mode tier routing |
per token |
blockrun_image |
DALL-E 3, GPT Image 1/2, Grok Imagine, Flux, CogView-4, Nano Banana — generation + editing | $0.015–0.12 |
blockrun_video |
xAI Grok Imagine Video + ByteDance Seedance 1.5/2.0/2.0-fast | $0.03–0.30/sec |
blockrun_music |
MiniMax music generation | per track |
blockrun_price |
Pyth-backed realtime + OHLC — crypto / FX / commodity (free), 12 stock markets (paid) | free or $0.001/call |
blockrun_markets |
Polymarket, Kalshi, dFlow, Binance Futures | $0.001/query |
blockrun_x |
X/Twitter — profiles, tweets, followers, mentions, search (AttentionVC) | per call |
blockrun_exa |
Neural web search (Exa) — research, competitors, papers, URL content | $0.01/query |
blockrun_search |
Grok Live Search — web + news with citations | ~$0.025 per source |
blockrun_dex |
Live DEX prices via DexScreener | free |
blockrun_models |
Live catalogue of every LLM/image/video/music model + pricing | free |
blockrun_wallet |
Balance, spending, agent budgets, setup QR | 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.
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.