How to add BlockRun MCP to Windsurf

Real-time data for AI agents — markets, research, X/Twitter, crypto. No API keys, pay per call in USDC. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 466★ · stdio · no auth · official

Windsurf config for BlockRun MCP

claude mcp add blockrun -s user -- npx -y @blockrun/mcp@latest

{
  "mcpServers": {
    "blockrun-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@blockrun/mcp"
      ]
    }
  }
}

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the BlockRun MCP config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5BlockRun MCP's tools become available to Cascade.

Before you start

Node.js >= 18
An MCP client (Claude Code, Claude Desktop, Cursor, Windsurf, or ChatGPT Desktop)
~$5 USDC on Base or Solana to fund the auto-created wallet

What BlockRun MCP can do in Windsurf

blockrun_chat

Chat across 66+ LLMs (GPT, Claude, Gemini, DeepSeek, Kimi, GLM, NVIDIA free tier, ...) with mode tier routing; billed per token.

blockrun_image

Image generation and img2img editing via GPT Image 1/2, Nano Banana/Pro (up to 4K), Grok Imagine, CogView-4. ~$0.015–0.15. Settles on Base only.

blockrun_video

Video generation via Sora 2, xAI Grok Imagine Video, ByteDance Seedance 1.5/2.0; RealFace asset to real-person video. ~$0.05–0.30/sec, payment-on-completion. Base only.

blockrun_realface

Enroll a real person (phone liveness) or AI character (Virtual Portrait) as a ta_xxxx asset for Seedance 2.0 video. Free to use; $0.01 to enroll.

blockrun_music

Music generation via MiniMax. Billed per track, payment-on-completion (no charge on timeout). Base only.

blockrun_speech

ElevenLabs text-to-speech (Flash/Turbo/Multilingual/v3, 8 voice aliases) plus cinematic sound effects; free voice listing. ~$0.05–0.10/1k chars; $0.0525/effect. Base only.

blockrun_price

Pyth-backed realtime + OHLC prices for crypto/FX/commodity (free) and 12 stock markets (paid, Base only). Free or $0.001/call.

blockrun_markets

Prediction-market data: Polymarket, Kalshi, Limitless, Opinion, Predict.Fun, dFlow, Binance Futures — markets, candles, trades, orderbooks, leaderboards, smart-wallet PnL, UMA oracle, cross-platform match/search. $0.001–0.005/query.

Security

Pay-per-call via x402 micropayments in USDC. The server auto-creates a crypto wallet on first run at ~/.blockrun/.session (Base) or ~/.blockrun/.solana-session (Solana); the private key stays on your machine and is used to sign payments. Fund with real USDC (~$5 on Base or Solana) — calls draw down a real balance. No traditional API key is required. For multi-agent setups, allocate per-agent budgets via blockrun_wallet action:"delegate" so child agents are auto-blocked when their cap is hit. On-chain receipts (Basescan/Solscan) are not fiat tax invoices.

BlockRun MCP + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the BlockRun MCP config there under the "mcpServers" key and restart the client.

Is BlockRun MCP safe to use with Windsurf?

Do I need API keys?

No. The server auto-creates a crypto wallet on first run and bills each call as a USDC micropayment via x402. You only need to fund the wallet (~$5 USDC on Base or Solana).

How is it billed?

Pay-per-call in USDC over the x402 protocol. Most reads cost fractions of a cent; media generation costs more. No subscriptions. Run blockrun_wallet to see balance and blockrun_models for live pricing.

Which chains can I pay on?

Base (default) or Solana. Switch with blockrun_wallet action:"chain". Some media and paid stock tools (image, music, speech, video, smart chat routing) settle on Base only and fall back to Base regardless of active chain.

View repo Full BlockRun MCP page