MCP Directory

How to add BlockRun MCP to Cursor

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

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

Cursor 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

  1. 1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
  2. 2Paste the BlockRun MCP config below into the "mcpServers" object.
  3. 3Fill in placeholder secrets, then save.
  4. 4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
  5. 5Ask Cursor to use one of BlockRun MCP's tools to confirm it's connected.

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 Cursor

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 + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the BlockRun MCP config there under the "mcpServers" key and restart the client.

Is BlockRun MCP safe to use with Cursor?

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.

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