MCP Directory

How to add BlockRun MCP to Claude Desktop

Real-time data for AI agents — markets, research, X/Twitter, crypto. No API keys, pay per call in USDC. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

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

Claude Desktop 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 Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
  2. 2Paste the BlockRun MCP config below under the top-level "mcpServers" key.
  3. 3Fill in any placeholder secrets (API keys, paths) in the snippet.
  4. 4Save the file, then fully quit and reopen Claude Desktop.
  5. 5Open a chat and confirm BlockRun MCP's tools appear under the 🔌 tools menu.

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 Claude Desktop

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 + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the BlockRun MCP config there under the "mcpServers" key and restart the client.

Is BlockRun MCP safe to use with Claude Desktop?

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