Blockrun MCP

Real-time data - and real trades - for Claude and any AI agent. Agents can't sign up for accounts. Agents can't enter credit cards. Its 20 documented tools cover blockrun, polymarket. It runs locally over stdio via the published package.

People connecting search tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-21 · ★ 388 · #2 OF 47 MAINTAINED SEARCH · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Blockrun MCP

before you install - you'll need

The README does not document required environment variables for a basic install.

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 20 documented tools spanning blockrun, polymarket, including blockrun_chat, blockrun_image, blockrun_video, blockrun_realface.

The 20 tools it gives your agent

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

blockrun_chat: - 71 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 (free), 12 stock markets (paid)
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_surf: - Surf (asksurf.ai) - 83 endpoints: CEX data, on-chain SQL (13 chains, 80+ tables), 100M+ labeled wallets, Polymarket + Kalshi, social mindshare, news, Surf-1.5 c
blockrun_exa: - Neural web search (Exa) - research, competitors, papers, URL content

show all 20 tools

blockrun_search: - Grok Live Search - web + X/Twitter + news with citations
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.40.2 · 2026-08-19

A housekeeping release. One correction users can actually see, and three fixes · to the machinery that was quietly wrong underneath it. · The documentation was misleading Solana users. blockrun_modal and…

v0.40.1 · 2026-08-13

An audit release: no new features, eleven confirmed defects fixed, nearly all of · them found by probing the live gateway rather than by reading the code. Seven · touch money directly. · Provenance is worth stating…

v0.40.0 · 2026-08-12

Catalog sync against the live GET /v1/models (2026-08-12, 91 models on both · chains). The July snapshot had drifted: two free-tier models died by aliasing · (one of them still routed in mode:"cheap"), and the gateway…

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 47 actively-maintained search servers as of 2026-08-25.
release cadence: 10+ releases in the last 90 days (latest 2026-08-19)
registry: io.github.BlockRunAI/blockrun-mcp (active, first published 2026-01-14 · 45 versions)
packages: npm:@blockrun/mcp

06 · Blockrun MCP FAQ

Is Blockrun MCP still maintained?

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

What can Blockrun MCP do?

An agent gets 20 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 does not document required environment variables for a basic install. 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 · BrowseAI Dev · Tachibot MCP · Open Archives

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