Blockrun MCP

Real-time data - and real trades - for Claude and any AI agent. Agents can pay like agents: sign transactions from a wallet. Its 19 documented tools cover blockrun, polymarket. It runs locally over stdio via the published package.

People who work with blockrun and polymarket and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-09-16 · ★ 394 · #2 OF 51 MAINTAINED SEARCH · VERIFIED 2026-09-18

MIT · TypeScript servers · how we verify → /methodology

01 · Install Blockrun MCP

before you install - you'll need

Set BLOCKRUN_BUDGET_LIMIT, BLOCKRUN_CONFIRM_SPEND, BLOCKRUN_API_KEY, BLOCKRUN_CONFIRM_THRESHOLD before connecting.

Claude Code

claude mcp add blockrunai-blockrun-mcp -- npx -y @blockrun/mcp

Claude Desktop / Cursor / VS Code - add to config

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

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @blockrun/mcp - the @blockrun scope differs from the repo owner (blockrunai); confirm it's the project's official package

registry namespace io.github.BlockRunAI is GitHub-verified and matches the repo owner

03 · What Blockrun MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

An agent gets 19 documented tools spanning blockrun, polymarket, including blockrun_chat, blockrun_image, blockrun_video, blockrun_realface.

The 19 tools it gives your agent

Extracted from the project's README - what blockrun-mcp lets an agent do.

blockrun_chat: - 78 LLMs (GPT, Claude, Gemini, DeepSeek, Kimi K3, GLM, NVIDIA free tier, …) with mode tier routing
blockrun_image: - Generate: 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, in
blockrun_video: - Sora 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 vid
blockrun_realface: - Enroll 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)
blockrun_music: - MiniMax music generation
blockrun_speech: - ElevenLabs TTS (Flash/Turbo/Multilingual/v3, 8 voices) + ByteDance Seed Audio (prompt-directed) + cinematic sound effects; free voice listing
blockrun_price: - Pyth-backed realtime + OHLC - crypto / FX / commodity, plus the ticker catalog for 12 equity markets (equity quotes withdrawn 2026-09-05)
blockrun_markets: - Polymarket (markets, candles, trades, orderbooks, leaderboards, smart-wallet PnL/clusters, UMA oracle), Kalshi, Limitless, Opinion, Predict.Fun, dFlow, Binance
blockrun_polymarket_read: - Read-only Polymarket positions/open orders plus executable live order previews, separated for MCP clients that enforce tool safety annotations
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
blockrun_exa: - Neural web search (Exa) - research, competitors, papers, URL content
blockrun_search: - Grok Live Search - web + news with citations

show all 19 tools

blockrun_dex: - Live DEX prices via DexScreener
blockrun_rpc: - Raw JSON-RPC on 40 chains (Ethereum, Base, Solana, Bitcoin, Sui, NEAR, …) via Tatum
blockrun_defi: - DefiLlama - protocol TVL, chain TVL, yield pools (APY), token prices
blockrun_modal: - Isolated code execution in a BlockRun-hosted Modal sandbox - disposable container, optional GPU (T4 → H100)
blockrun_phone: - Outbound AI voice calls (Bland) + wallet-owned US/CA numbers (Twilio), carrier + fraud lookups
blockrun_models: - Live catalogue of every LLM/image/video/music model + pricing
blockrun_wallet: - Balance, spending, agent budgets, setup QR, chain switch

Latest releases

v0.51.1 · 2026-09-15

Round four, second half. 0.51.0 shipped with seven of round four's ten · finders still unread - they had stalled - and this is what they found once · they finished, plus a regression hunt over 0.51.0's own fixes.…

v0.51.0 · 2026-09-15

Round four went at round three. 0.50.0's changelog said the general sweep · was spent and the surfaces no sweep had opened were where the money was. Round · three opened them - it is the fifty-nine hundred lines behind…

v0.49.0 · 2026-09-09

The error says whether money moved. Issue #132 reported blockrun_markets · and blockrun_price failing with API error after payment: 502 / Request failed · while the wallet balance never changed. The balance was right…

04 · Who maintains Blockrun MCP

blockrun-mcp is maintained by blockrunai. It's the only MCP server we track from this author; the repo dates to Jan 2026.

05 · Facts

repository: github.com/blockrunai/blockrun-mcp
category: search - ranked #2 of 51 actively-maintained search servers as of 2026-09-18.
release cadence: 10+ releases in the last 90 days (latest 2026-09-15)
registry: io.github.BlockRunAI/blockrun-mcp (active, first published 2026-01-14 · 59 versions)
packages: npm:@blockrun/mcp

06 · Blockrun MCP FAQ

Is Blockrun MCP still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-16 and it shipped 10+ releases in the last 90 days. We re-verify nightly.

What can Blockrun MCP do?

An agent gets 19 documented tools spanning blockrun, polymarket, including blockrun_chat, blockrun_image, blockrun_video, blockrun_realface.

How do I install Blockrun MCP?

Run `npx -y @blockrun/mcp`. The README documents 4 environment variables (BLOCKRUN_BUDGET_LIMIT, BLOCKRUN_CONFIRM_SPEND, BLOCKRUN_API_KEY…) to set first. Set BLOCKRUN_BUDGET_LIMIT, BLOCKRUN_CONFIRM_SPEND, BLOCKRUN_API_KEY, BLOCKRUN_CONFIRM_THRESHOLD before connecting. You can also paste the ready-made client config above.

Does Blockrun MCP run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Blockrun MCP

Alternatives to Blockrun MCP

Maintained search servers if Blockrun MCP isn't the fit.

Pairs well with

Servers that cover what Blockrun MCP doesn't - only shown when the pairing reason fits the companion.

head to head · Blockrun MCP vs SearXNG Search

More search MCP servers · Crazy SEO · Tachibot MCP · Open Archives · Bisibility

More TypeScript MCP servers · Bvcc Agent Wallet · Bloomfilter · Kontra MCP · Shopware MCP · Affiliate Networks MCP · see all