MCP Directory

BlockRun MCP

Official

Real-time data for AI agents — markets, research, X/Twitter, crypto. No API keys, pay per call in USDC.

Unverified
stdio (local)
No auth
TypeScript
View repo 466 Website npm

Add to your client

Copy the config for your MCP client and paste it into its config file.

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

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

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

Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf

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

About BlockRun MCP

BlockRun MCP is a stdio MCP server (npm: @blockrun/mcp) that lets an MCP client reach many live data sources and generative APIs through one pay-per-call USDC wallet, settled via x402 micropayments on Base or Solana. It requires no API keys: the server provisions a wallet on first run and the user funds it with ~$5 USDC. Tools span LLM chat, image/video/music/speech, prediction markets, DEX and stock/FX prices, neural and live web search, on-chain SQL and wallet intelligence, raw JSON-RPC across 40+ chains, DeFi TVL/yields, sandboxed code execution, and outbound voice calls. Optional tool profiles (full/media/trading/research/chat) reduce how many tool schemas the client loads.

Tools & capabilities (18)

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.

blockrun_surf

Surf (asksurf.ai) — 84 endpoints: CEX data, on-chain SQL (13 chains, 80+ ClickHouse tables), 100M+ labeled wallets, Polymarket+Kalshi, social mindshare, news, search, Surf-1.5 chat with citations. $0.001–0.02/call.

blockrun_exa

Neural web search (Exa) for research, competitors, papers, and URL content extraction. $0.01/query.

blockrun_search

Grok Live Search — web + news with citations. $0.025 x max_results (default 10).

blockrun_dex

Live DEX prices via DexScreener. Free.

blockrun_rpc

Raw JSON-RPC on 40+ chains (Ethereum, Base, Solana, Bitcoin, Sui, NEAR, ...) via Tatum gateway — eth_call, balances, blocks, logs. $0.002/call.

blockrun_defi

DefiLlama — protocol TVL, chain TVL, yield pools (APY), token prices. $0.001–0.005/call.

blockrun_modal

Isolated code execution in a BlockRun-hosted Modal sandbox — disposable container, optional GPU (T4 to H100). $0.01 to create; $0.001/op. (full profile only)

blockrun_phone

Outbound AI voice calls (Bland) plus wallet-owned US/CA numbers (Twilio) and carrier/fraud lookups. $0.54/call; $5/number. (full profile only)

blockrun_models

Live catalogue of every LLM/image/video/music model and its pricing. Free.

blockrun_wallet

Wallet balance, spending, agent budget delegation, chain switching (Base/Solana), and funding QR/setup. Free.

When to use it

  • Get live prediction-market consensus (e.g. Polymarket odds on a Fed rate decision) inside Claude
  • Run cited research and neural web search over recent papers, competitors, and URLs
  • On-chain forensics: label a wallet, see holdings/net-worth, run cross-chain SQL over DEX volume
  • Generate images, video, music, and speech as single pay-per-call API calls
  • Multi-agent research with per-agent USDC budget caps that auto-block when exhausted

Security notes

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 FAQ

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.

When should I NOT use BlockRun?

For high-volume single-API workloads (>=10k calls/day to one source), compliance flows needing fiat invoices, sub-100ms latency-critical reads, or if you only ever need one source — direct upstream subscriptions amortize better there.

#x402#crypto#micropayments#usdc#prediction-markets#web-search#on-chain#llm#image-generation#claude-code

Alternatives to BlockRun MCP

Compare all alternatives →
Memory (Knowledge Graph)
AI, Data & Knowledge
74k

Official MCP server providing persistent, file-backed knowledge-graph memory across sessions.

Verified
stdio (local)
No auth
TypeScript
9 tools
Updated 5 months agoRepo
Sequential Thinking
AI, Data & Knowledge
62k

Structured step-by-step reasoning tool for breaking problems into revisable thought sequences.

Verified
stdio (local)
No auth
TypeScript
1 tool
Updated 6 months agoRepo
AWS Knowledge MCP
AI, Data & Knowledge
7.0k

Fully managed remote server for AWS docs, blogs, What's-New and Well-Architected guidance — no key.

Verified
HTTP (remote)
No auth
Hosted
6 tools
Updated 5 months agoRepo

Compare BlockRun MCP with:

vs Memory (Knowledge Graph)vs Sequential Thinkingvs AWS Knowledge MCPvs MCP Server Chart