Skip to content
appsgit

Blockrun MCP

Blockrun MCP is an MCP server that adds search and knowledge tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Web search, deep research, prediction markets & crypto data for AI agents. It has 392 GitHub stars, is released under the MIT license and runs locally with npx -y @blockrun/mcp.

github.com/BlockRunAI/blockrun-mcp (opens in a new tab)

Install Blockrun MCP

Generated from the server's MCP registry entry. Replace your-value with your own values.

Claude Desktop

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

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

Claude Code

claude mcp add --env BLOCKRUN_WALLET_KEY=your-value --env SOLANA_WALLET_KEY=your-value --env BLOCKRUN_API_KEY=your-value --transport stdio blockrun-mcp -- npx -y @blockrun/mcp

Cursor

.cursor/mcp.json
{
  "mcpServers": {
    "blockrun-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@blockrun/mcp"
      ],
      "env": {
        "BLOCKRUN_WALLET_KEY": "your-value",
        "SOLANA_WALLET_KEY": "your-value",
        "BLOCKRUN_API_KEY": "your-value"
      }
    }
  }
}

Project file; use ~/.cursor/mcp.json to enable it in every project.

VS Code

.vscode/mcp.json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "blockrun_wallet_key",
      "description": "BLOCKRUN_WALLET_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "solana_wallet_key",
      "description": "SOLANA_WALLET_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "blockrun_api_key",
      "description": "BLOCKRUN_API_KEY",
      "password": true
    }
  ],
  "servers": {
    "blockrun-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@blockrun/mcp"
      ],
      "env": {
        "BLOCKRUN_WALLET_KEY": "${input:blockrun_wallet_key}",
        "SOLANA_WALLET_KEY": "${input:solana_wallet_key}",
        "BLOCKRUN_API_KEY": "${input:blockrun_api_key}"
      }
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Environment variables

Variables the server reads at startup.

NameRequiredDescription
BLOCKRUN_WALLET_KEYsecretNoOptional: EVM private key (0x-prefixed hex) for USDC payments on Base; also the Polymarket signer. If not set, a wallet is auto-generated.
SOLANA_WALLET_KEYsecretNoOptional: Solana private key (bs58) for USDC payments on Solana. Setting it selects the Solana chain. If not set, a wallet is auto-generated.
BLOCKRUN_API_KEYsecretNoOptional: BlockRun account API key; bills your prepaid balance instead of a wallet (no per-call network fee). Takes priority over a wallet when set.

Tools (19)

Parsed from the Tools section of the README; check the repository for the current list.

  • blockrun_chat

    82 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,…

  • 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…

  • blockrun_realface

    Enroll a real person (phone liveness) or AI character (Virtual Portrait) as a taxxxx asset for Seedance 2.0 / 2.0-fast…

  • blockrun_music

    MiniMax music generation

  • blockrun_speech

    ElevenLabs TTS (Flash/Turbo/Multilingual/v3, 8 voices) + ByteDance Seed Audio (prompt-directed) + cinematic sound…

  • blockrun_price

    Pyth-backed realtime + OHLC — crypto / FX / commodity, plus the ticker catalog for 12 equity markets (equity quotes…

  • blockrun_markets

    Polymarket (markets, candles, trades, orderbooks, leaderboards, smart-wallet PnL/clusters, UMA oracle), Kalshi,…

  • blockrun_polymarket_read

    Read-only Polymarket positions/open orders plus executable live order previews, separated for MCP clients that enforce…

  • blockrun_polymarket

    Trade on Polymarket (CLOB V2): place/cancel real bets, positions, redeem winnings — signed locally, settled in pUSD…

  • blockrun_exa

    Neural web search (Exa) — research, competitors, papers, URL content

  • blockrun_search

    Grok Live Search — web + 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

About Blockrun MCP

Real-time data — and real trades — for Claude and any AI agent. Agents can pay like agents: sign transactions from a wallet. Teams can pay like teams: get a BlockRun API key at user.blockrun.ai , add credit by card or wire, and let the MCP call api.blockrun.ai . BlockRun MCP gives your agent 19 tools — markets, research, web search, images, video, on-chain data, and live Polymarket trading — paid per call.

  • ai
  • claude-code
  • llm
  • mcp
  • mcp-server
  • x402

FAQ

Blockrun MCP FAQ

Still curious? Email info@appsgit.com.

What is Blockrun MCP?

Blockrun MCP is an MCP server that adds search and knowledge tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Web search, deep research, prediction markets & crypto data for AI agents. It has 392 GitHub stars, is released under the MIT license and runs locally with npx -y @blockrun/mcp. The source code is at github.com/BlockRunAI/blockrun-mcp.

How do I install the Blockrun MCP MCP server?

Add the command npx -y @blockrun/mcp to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is Blockrun MCP free?

The server is open source under the MIT license, so running it is free. It does not declare any required API key.

Is Blockrun MCP actively maintained?

The most recent commit was on Oct 2, 2026. The latest release is v0.54.0, published Oct 2, 2026. appsgit only lists MCP servers with a commit in the last six months and re-checks every server daily.