Blockrun MCP Server

by blockrunaiio.github.BlockRunAI/blockrun-mcpv0.54.1

Access AI models such as GPT-5, Claude, Gemini, Grok and DeepSeek, paid per use via x402 micropayments in USDC on Base.

391Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active1d ago

Install Blockrun MCP server

claude mcp add blockrun -e BLOCKRUN_WALLET_KEY='<blockrun-wallet-key>' -e SOLANA_WALLET_KEY='<solana-wallet-key>' -e BLOCKRUN_API_KEY='<blockrun-api-key>' -- npx -y @blockrun/mcp

{
  "mcpServers": {
    "blockrun": {
      "command": "npx",
      "args": [
        "-y",
        "@blockrun/mcp"
      ],
      "env": {
        "BLOCKRUN_WALLET_KEY": "<blockrun-wallet-key>",
        "SOLANA_WALLET_KEY": "<solana-wallet-key>",
        "BLOCKRUN_API_KEY": "<blockrun-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "blockrun": {
      "command": "npx",
      "args": [
        "-y",
        "@blockrun/mcp"
      ],
      "env": {
        "BLOCKRUN_WALLET_KEY": "<blockrun-wallet-key>",
        "SOLANA_WALLET_KEY": "<solana-wallet-key>",
        "BLOCKRUN_API_KEY": "<blockrun-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "blockrun": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@blockrun/mcp"
      ],
      "env": {
        "BLOCKRUN_WALLET_KEY": "<blockrun-wallet-key>",
        "SOLANA_WALLET_KEY": "<solana-wallet-key>",
        "BLOCKRUN_API_KEY": "<blockrun-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "blockrun": {
      "command": "npx",
      "args": [
        "-y",
        "@blockrun/mcp"
      ],
      "env": {
        "BLOCKRUN_WALLET_KEY": "<blockrun-wallet-key>",
        "SOLANA_WALLET_KEY": "<solana-wallet-key>",
        "BLOCKRUN_API_KEY": "<blockrun-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
BLOCKRUN_WALLET_KEY	—	yes	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	—	yes	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	—	yes	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.

Freshness

Active — last maintenance signal 1d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-08 · 1d ago · GitHub
Latest release
2026-10-08 · 1d ago · GitHub · v0.54.2
Package published
no data · npm/PyPI
Registry entry updated
2026-10-07 · 2d ago · official registry · v0.54.1

FAQ

›How do I install the Blockrun MCP server in Claude Code?

Run: claude mcp add blockrun -e BLOCKRUN_WALLET_KEY='<blockrun-wallet-key>' -e SOLANA_WALLET_KEY='<solana-wallet-key>' -e BLOCKRUN_API_KEY='<blockrun-api-key>' -- npx -y @blockrun/mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Blockrun require an API key?

Yes. It expects BLOCKRUN_WALLET_KEY, SOLANA_WALLET_KEY, BLOCKRUN_API_KEY, of which 3 are secrets.

›Can I use Blockrun as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Blockrun in the official MCP registry?

Yes, as io.github.BlockRunAI/blockrun-mcp.