BlockRun MCP

Give Claude Code access to 105 AI models, 66 crypto data endpoints, voice calls, image/video/music generation, prediction markets (read and trade), multi-chain RPC, and a sandbox runtime — all with zero API keys.

BlockRun MCP is a Model Context Protocol server that connects Claude Code to BlockRun's intelligence, trading, and creation capabilities.

Always installs the latest version — see npm for the current release.

Installation

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

That's it. Restart Claude Code and the MCP is available. A wallet is auto-created on first run — no signup.

-s user installs globally (available in every project). The -- separator ensures -y is passed to npx, not parsed by claude mcp add. Requires Node.js ≥ 20.19.

claude mcp add blockrun -s user -e PATH="$PATH" -- npx -y @blockrun/mcp@latest

Other clients

The same server runs in any MCP-compatible client.

Tool profiles (optional)

Expose a trimmed tool set so the client loads fewer schemas into context. Pass --profile <name> (or set BLOCKRUN_MCP_PROFILE); omit for the full set.

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

An unknown profile name falls back to full. modal and phone are full-profile only.

Plugins (spend controls)

The bare MCP works everywhere. For Claude Code specifically, the blockrun-media plugin wraps the media profile with a spend-confirmation prompt before every paid call, a running cost meter, a status-line balance, and /blockrun-media:balance · /blockrun-media:report · /blockrun-media:insights commands:

/plugin marketplace add BlockRunAI/blockrun-claude-plugin
/plugin install blockrun-media@blockrun

The Codex port is blockrun-codex-plugin (codex plugin marketplace add BlockRunAI/blockrun-codex-plugin, then codex plugin install blockrun-media). Both read real settled spend from ~/.blockrun/cost_log.jsonl. Knobs: BLOCKRUN_ASK_THRESHOLD (auto-run paid calls at or under this USD amount), BLOCKRUN_SESSION_CAP (soft per-session budget).

Prompt-based skills for every tool family install from a separate marketplace — see Skills.

What It Enables

How It Works

1. You ask Claude to use an external capability
2. Claude calls the BlockRun MCP tool
3. MCP signs a USDC payment locally
4. Request goes to BlockRun with payment signature
5. BlockRun verifies, calls the provider, returns result

Your private key stays on your machine.

Setup

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

blockrun_wallet action:"setup"

blockrun_wallet

Pay on Solana (optional)

The MCP pays on Base by default but holds a Solana wallet too. To pay in USDC on Solana, no env vars, file editing, or restart needed — two tool calls:

blockrun_wallet action:"chain" chain:"solana"   # provisions + activates the Solana wallet
blockrun_wallet action:"setup"                  # shows the Solana address + funding QR

Then send USDC (SPL) on the Solana network — from Coinbase (pick "Solana"), Phantom, Solflare, or Backpack. Switch back anytime with blockrun_wallet action:"chain" chain:"base". The server keeps both wallets; switching just changes which one pays.

Available Tools

The MCP exposes 19 tools to Claude, grouped below by what they do. Every tool description carries its current price — prices are generated from the live catalog, not typed, so read the tool description (or the 402 response) rather than a remembered figure.

Intelligence

blockrun_chat

Get a second opinion from another model, or use a specialised model for a task. Pick by model id or by mode.

Use GPT-5.5 to explain this error
blockrun_chat mode:"reasoning" message:"Prove there are infinitely many primes"
blockrun_chat mode:"free" message:"Draft a commit message for this diff"

Parameters

blockrun_models

List every available LLM, image, video, music and speech model with live pricing, context windows, and categories. Free.

Search & research

blockrun_search

Live web + X/Twitter + news search with AI-summarised results and citations. Body: { query, sources: ["web","x","news"], max_results, from_date, to_date }. sources accepts any subset (default all three; ["x"] for tweets only). max_results is 1–50 and drives the price — pass a small value to cap spend.

blockrun_search body:{query:"what are people saying about @sama", sources:["x"], max_results:5}

blockrun_exa

Neural semantic web search — search, answer (cited), contents (read URLs), find-similar. Best for research, papers, competitors.

Markets & trading

blockrun_markets

Prediction-market and derivatives data via the Predexon aggregator — Polymarket (markets, candles, trades, orderbooks, leaderboards, smart-wallet PnL), Kalshi, Limitless, Opinion, Predict.Fun, dFlow, Binance Futures, sports, and cross-venue search. See Prediction Markets reference.

blockrun_polymarket_read

Read or preview Polymarket state without signing anything — positions, open orders, and a live order preview from the CLOB book. Free; never accepts confirm.

blockrun_polymarket

Trade on Polymarket (CLOB V2, Polygon) — setup, fund, buy, sell, cancel, redeem, withdraw. Orders are signed locally by your BlockRun key and settle in pUSD from a gasless deposit wallet. Real money: every order needs confirm:true, capped per order by POLYMARKET_MAX_BET_USD (default $25). Without confirm you get a dry-run. Discover markets and token ids with blockrun_markets first. See Polymarket funding.

blockrun_polymarket action:"setup"
blockrun_polymarket action:"fund" amount_usd:5 confirm:true
blockrun_polymarket_read action:"preview" side:"buy" token_id:"<id>" amount_usd:5 order_type:"FOK"
blockrun_polymarket action:"buy" token_id:"<id>" amount_usd:5 order_type:"FOK" confirm:true

Crypto & on-chain data

blockrun_price

Pyth-backed realtime quotes and OHLC history — crypto, FX, commodities (free) and 12 global stock markets (paid). Actions: price, history, list.

blockrun_dex

Real-time DEX pair data — token prices, liquidity, volume, pair and contract lookup across chains. Free.

blockrun_defi

DeFi fundamentals — protocol TVL, chain TVL, yield pools (APY), token prices. See DefiLlama reference.

blockrun_rpc

Raw JSON-RPC against 40 blockchains through one endpoint — contract reads, balances, blocks, transactions, logs, gas estimates. No node, no API key. See Multi-chain RPC.

Media

blockrun_image

Generate or edit images (img2img, inpaint, fusion). Models include openai/gpt-image-2, openai/gpt-image-1, google/nano-banana, google/nano-banana-2, google/nano-banana-pro, xai/grok-imagine-image, xai/grok-imagine-image-pro, zai/cogview-4, bytedance/seedream-5-pro. Pays on either chain. Pair with the image-prompting skill for text-accurate prompts.

Generate a poster announcing our launch, retro-futuristic, headline "NOW LIVE"

blockrun_video

Short AI video from a text prompt and optional seed image — azure/sora-2, xai/grok-imagine-video, xai/grok-imagine-video-1.5, and bytedance/seedance-1.5-pro / 2.0-mini / 2.0-fast / 2.0 / 2.5. Async and client-polled (typically 60–180s, 9-minute hard cap); you are charged only when a finished video comes back.

blockrun_realface

Enroll a real person (phone liveness check) or an AI character as a ta_xxxx asset, then drive Seedance 2.0 / 2.0-fast / 2.0-mini video of that specific person via blockrun_video real_face_asset_id. Not supported on Seedance 2.5 or 1.5-pro. See RealFace reference.

blockrun_music

Generate a full-length (~3 minute) MP3 track. Async; payment settles only when a finished track is returned.

blockrun_speech

Text-to-speech (speak, default), cinematic sound_effect clips up to 22s, and a free voices list. Price is quoted before payment. See Text-to-Speech reference.

Actions & compute

blockrun_phone

Phone-number intelligence (carrier, line type, SIM-swap and call-forwarding fraud signals), wallet-owned US/CA number leases, and outbound AI voice calls. See Phone & Voice reference.

Call +14155551234 and ask if Tuesday at 7pm is available for a reservation for two.

blockrun_modal

Run isolated code in a BlockRun-hosted sandbox — a disposable remote container with optional GPU (T4 / L4 / A10G / A100 / H100). The timeout you ask for is the billed lifetime, charged up front and never refunded, so request what you need. See Modal sandbox reference.

Wallet

blockrun_wallet

USDC balance, wallet setup, card on-ramp, chain switching, and per-agent budget delegation.

action (default status):

blockrun_wallet action:"status"
blockrun_wallet action:"budget" budget_action:"set" budget_amount:5.00
blockrun_wallet action:"delegate" agent_id:"researcher" agent_limit:2.00

Call this tool first whenever another blockrun_* tool returns a payment or balance error. Paid tools auto-open the card on-ramp when a call fails for lack of funds.

Mode Routing

mode picks a model by intent in one hop. Each mode is an ordered list; the first entry is tried first and the rest are fallbacks.

An explicit model always wins over mode. There is no prompt-aware "smart" router inside the MCP any more — that lived in the standalone ClawRouter proxy and was dropped from blockrun_chat because every caller here is already a frontier model reaching for something specific.

Configuration

Environment Variables

All optional. The wallet file is created for you; nothing here is required for a first call.

Chain selection priority: .chain preference → SOLANA_WALLET_KEY → first-run auto-pin → .solana-session exists → otherwise Base. The full Polymarket variable list is in the repo README.

The server checks npm at startup and prints an Update available notice to stderr when a newer @blockrun/mcp exists — re-run the install command to upgrade.

Claude Code Settings

View MCP configuration:

claude mcp list

Remove if needed:

claude mcp remove blockrun -s user

Pricing

• Intelligence: Provider cost, no platform margin on chat tokens, plus $0.001 per request
• Images: $0.015-0.15 per image
• Free tier: blockrun_chat mode:"free", blockrun_dex, crypto/FX/commodity blockrun_price, blockrun_models, blockrun_polymarket_read, and blockrun_speech action:"voices" cost $0
• No subscriptions, no minimums

See Intelligence Pricing for details.

Security

Common Commands

# Check balance
blockrun_wallet

# Setup/view wallet + funding QR
blockrun_wallet action:"setup"

# Use a specific model
Use GPT-5.5 to analyze this

# Generate image
Create an image of [description]

# Get second opinion
Ask Claude Opus what it thinks about this approach

# Draft for free
blockrun_chat mode:"free" message:"..."

Troubleshooting

See MCP Troubleshooting for common issues.

Quick Fixes

MCP not loading:

# Restart Claude Code
pkill -f "claude"
claude

# Verify installation
claude mcp list

spawn npx ENOENT / server won't connect: reinstall with your shell PATH passed through (-e PATH="$PATH", see Installation).

Wallet not found:

blockrun_wallet action:"setup"

Insufficient balance / 402:

blockrun_wallet

Fund your wallet on the active chain if needed.

Links

• GitHub: blockrun-mcp
• npm: @blockrun/mcp
• Claude Code plugin: blockrun-claude-plugin
• Codex plugin: blockrun-codex-plugin
• Claude Code Users Guide

What's next?