# Blockrun MCP (MCP server)

> 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.

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.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/BlockRunAI/blockrun-mcp |
| GitHub stars | 392 |
| License | MIT |
| Language | TypeScript |
| Transport | stdio |
| Packages | npm: @blockrun/mcp |
| Remote URL | none |
| Needs API key | no |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | AI & search |
| Latest release | v0.54.0 (Oct 2, 2026) |
| Last commit | Oct 2, 2026 |
| MCP registry name | io.github.BlockRunAI/blockrun-mcp |

## Install

### Claude Desktop (claude_desktop_config.json)

```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

```sh
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)

```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)

```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 2026-10-07.

## Environment variables

- `BLOCKRUN_WALLET_KEY` (secret): Optional: 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_KEY` (secret): Optional: 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_KEY` (secret): Optional: 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

- `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

## Similar MCP servers

- [Context7](https://appsgit.com/mcp-servers/context7): Up-to-date code docs for any prompt. (62,752 stars, MIT, needs API key)
- [FunASR](https://appsgit.com/mcp-servers/funasr): Transcribe local audio with FunASR and SenseVoice using private, on-device inference. (20,596 stars, MIT)
- [Bifrost](https://appsgit.com/mcp-servers/bifrost): Fastest enterprise AI gateway (50x faster than LiteLLM) with adaptive load balancer, cluster mode, guardrails, 1000+ models support & <100 µs overhead at 5k RPS. (8,591 stars, Apache-2.0)
- [Honcho](https://appsgit.com/mcp-servers/honcho): Memory that reasons: continual learning for stateful agents. (7,494 stars, AGPL-3.0, needs API key)
- [Semble](https://appsgit.com/mcp-servers/semble): Fast and Accurate Code Search for Agents. (6,185 stars, MIT)
- [Exa](https://appsgit.com/mcp-servers/exa): Connect AI agents to Exa for web search, content fetching, and multi-step research. (5,088 stars, MIT, official)

---

Canonical page: https://appsgit.com/mcp-servers/blockrun-mcp
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.