Blockrun MCP Server

BlockRun MCP Server - Give your AI agent web search, deep research, prediction markets, and crypto data. Paid via x402 micropayments.

Remote serverstreamable-httpGo

What is the Blockrun MCP MCP server?

If you already use Blockrun MCP, the blockrun mcp mcp server is the piece that lets your assistant work with it directly. BlockRun MCP Server - Give your AI agent web search, deep research, prediction markets, and crypto data. Paid via x402 micropayments.

What the server does

  • One wallet, every source — — 20 tools behind a single self-custody wallet. No per-vendor signups
  • No API keys — — your wallet signature is authentication
  • No credit cards — — pay per request in USDC via x402, fractions of a cent each
  • Starts free — — the free tier (blockrun_chat mode:"free", blockrun_dex, crypto blockrun_price, blockrun_models) costs $0
  • Reads and acts — — most tools deliver data; blockrun_polymarket places real, confirm-gated trades
  • Self-custody — — your key never leaves your machine (~/.blockrun/.session by default, 0600). BlockRun can't move your funds

Installation

Because this one is hosted, setup is mostly authentication — you point your client at the endpoint and approve access. Nothing runs on your machine, so there is no runtime to keep patched.

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • blockrun_chat — 66 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(-pro), xai/grok-imagine-image(-pro), zai/cogview-4. Edit: img2img, inpaint, fusion
  • blockrun_video — Sora 2 + xAI Grok Imagine Video + ByteDance Seedance 1.5/2.0/2.0-fast (720p + audio); RealFace asset → real-person video
  • blockrun_realface — Enroll a real person (phone liveness) or AI character (Virtual Portrait) as a ta_xxxx asset for Seedance 2.0 video
  • blockrun_music — MiniMax music generation
  • blockrun_speech — ElevenLabs TTS (Flash/Turbo/Multilingual/v3, 8 voices) + 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
  • blockrun_polymarket_read — Read-only Polymarket positions/open orders plus executable live order previews, separated for MCP clients that enforce tool safety annotations
  • blockrun_polymarketTrade on Polymarket (CLOB V2): place/cancel real bets, positions, redeem winnings — signed locally, settled in pUSD from a gasless deposit
  • blockrun_surf — Surf (asksurf.ai) — 83 endpoints: CEX data, on-chain SQL (13 chains, 80+ tables), 100M+ labeled wallets, Polymarket + Kalshi, social mindshare, news
  • blockrun_exa — Neural web search (Exa) — research, competitors, papers, URL content

Credentials and setup notes

Configuration is passed through the environment: POLYMARKET_CLOB_HOST, BLOCKRUN_WALLET_KEY, SOLANA_WALLET_KEY. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Worth knowing first

  • Your data travels to the provider's service, so the usual questions apply about what you send and what they retain.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Blockrun MCP.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Where it fits

Plenty of search and retrieval servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Blockrun MCP's toolset — blockrun_chat, blockrun_image, blockrun_video and 11 more — is a fair guide to whether it matches your workflow. It is maintained by blockrunai; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Available tools

ToolWhat it does
blockrun_chat66 LLMs (GPT, Claude, Gemini, DeepSeek, Kimi K3, GLM, NVIDIA free tier, …) with mode tier routing
blockrun_imageGenerate: openai/gpt-image-2, gpt-image-1, google/nano-banana(-pro), xai/grok-imagine-image(-pro), zai/cogview-4. Edit: img2img, inpaint, fusion.
blockrun_videoSora 2 + xAI Grok Imagine Video + ByteDance Seedance 1.5/2.0/2.0-fast (720p + audio); RealFace asset → real-person video
blockrun_realfaceEnroll a real person (phone liveness) or AI character (Virtual Portrait) as a ta_xxxx asset for Seedance 2.0 video
blockrun_musicMiniMax music generation
blockrun_speechElevenLabs TTS (Flash/Turbo/Multilingual/v3, 8 voices) + cinematic sound effects; free voice listing
blockrun_pricePyth-backed realtime + OHLC — crypto / FX / commodity (free), 12 stock markets (paid)
blockrun_marketsPolymarket (markets, candles, trades, orderbooks, leaderboards, smart-wallet PnL/clusters, UMA oracle), Kalshi, Limitless, Opinion, Predict.Fun, dFlow, Binance Futures, cross-platform search
blockrun_polymarket_readRead-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, $25/order default cap. [Details ↓](#-polymarket-tradin
blockrun_surfSurf (asksurf.ai) — 83 endpoints: CEX data, on-chain SQL (13 chains, 80+ tables), 100M+ labeled wallets, Polymarket + Kalshi, social mindshare, news, Surf-1.5 chat with citations
blockrun_exaNeural web search (Exa) — research, competitors, papers, URL content
blockrun_searchGrok Live Search — web + X/Twitter + news with citations
blockrun_dexLive DEX prices via DexScreener

How to install the Blockrun MCP MCP server

{
  "mcpServers": {
    "blockrun": {
      "command": "npx",
      "args": ["-y", "@blockrun/mcp"],
      "env": {
        "POLYMARKET_CLOB_HOST": "your-value",
        "BLOCKRUN_WALLET_KEY": "your-value",
        "SOLANA_WALLET_KEY": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
POLYMARKET_CLOB_HOSTEndpoint or connection string the server talks to.Optional
BLOCKRUN_WALLET_KEYCredential the server authenticates with.Yes
SOLANA_WALLET_KEYCredential the server authenticates with.Yes

Example prompts to try

  • Use Blockrun MCP to blockrun chat.
  • Use Blockrun MCP to blockrun image.
  • Use Blockrun MCP to blockrun video.

Frequently asked questions

It connects Blockrun MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (blockrun_chat, blockrun_image, blockrun_video, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Blockrun MCP directly.