LABSCO SUMMARY

One funded wallet stands in for a drawer full of provider accounts.

A model call, a video render, a neural search and a chain RPC read all settle against the same USDC balance, so adding a capability does not mean adding a billing relationship. Prices sit in the tool descriptions rather than behind a pricing page, and the per-agent budget is what makes handing this to a child agent survivable — it stops at the limit you set, not at your balance.

What it is

An x402 payment gateway behind twenty tools: model chat and media generation, web and crypto data, prediction markets, sandboxed code execution and raw JSON-RPC, each billed per call in USDC. The wallet is created on your machine on first run and the key never leaves it — payments and orders are signed locally.

What you get

A second model on demand: chat routed by mode — powerful, reasoning, coding, cheap — or by model name, with a listing of what exists and what each costs
Media in four shapes: images generated or edited, music tracks of roughly three minutes, ElevenLabs speech and sound effects, and short MP4 video, with RealFace enrollment for driving video with a real person's likeness
Two search engines with different bills: Grok Live Search over web, X and news priced per source returned, and Exa neural search at a flat rate
Market and chain data: DexScreener pairs at no charge, Pyth-backed quotes and OHLC across crypto, FX, commodities and 12 global stock markets, DefiLlama TVL and yields, and Surf's 83 crypto endpoints
Prediction markets from data to order: cross-venue markets through Predexon, position and open-order reads, and signed Polymarket orders from a gasless deposit wallet
Raw JSON-RPC against 40+ blockchains at $0.002 per call, and a disposable Modal sandbox with an optional GPU
Spending control before the spending starts: budgets and per-agent limits set on the wallet, so a child agent is blocked at zero rather than at your balance
A trimmed tool set when you do not need all twenty — media, trading, research or chat, chosen by profile

Requirements

Node.js 20.19 or newer and a USDC balance — the wallet is created on first run and funded by you, on Base or Solana, with no per-service API keys anywhere. Back up the key at ~/.blockrun/.session: it signs both the payment wallet and the Polymarket deposit wallet, and losing it loses both. Some calls carry no charge: DexScreener data, voice listing, and the wallet tool itself. Polymarket trading moves real money separately from the API budget, needs an explicit confirmation on every order, and is capped per order — $25 by default — with an optional session cap on top. MIT licensed.

Setup effort

One command — npx -y @blockrun/mcp@latest

See installation options

USE CASES

Getting a second opinion from another model

Route the question by mode or by name, after checking what the alternatives cost per call.

blockrun_modelsblockrun_chat

Making media without five separate accounts

Image, speech, music and video all bill against the same wallet, with no provider key to obtain first.

blockrun_imageblockrun_speechblockrun_video

Researching something happening right now

Live search over the web and X for the news, neural search for the depth — with each call's price visible before you spend it.

blockrun_searchblockrun_exa

Reading a market before betting on it

Look at the odds across venues and your existing positions, and take the dry run before any order is signed.

blockrun_marketsblockrun_polymarket_readblockrun_polymarket

Querying a chain without running a node

Raw JSON-RPC against forty-plus chains through one endpoint, priced per call, plus DEX and DeFi data alongside.

blockrun_rpcblockrun_dexblockrun_defi

Letting a sub-agent spend, but only so much

Delegate a budget to the agent id, then pass that id on every downstream call — it stops when the allocation runs out.

blockrun_wallet

20 tools

Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.

`blockrun_chat`

Get a second opinion from another AI model, or use a specialized model for a specific task.

Notable modes:

mode:"powerful" → Claude Opus 4.8, GPT-5.6-sol, Claude Fable 5 (frontier, 1M context)
mode:"reasoning" → Claude Opus 4.8, GPT-5.6-sol, Kimi K3, Grok 4.3, deepseek-v4-pro
mode:"coding" → Claude Opus 4.8, GPT-5.3-codex, Kimi K3, Grok Build, GLM-5.2
mode:"cheap" → deepseek-v4-pro, MiniMax M3, GLM-5, NVIDIA free
mode:"glm" → Zhipu GLM-5 / 5.2 / 5.1 / 5-Turbo (cheap, strong at coding)
mode:"free" → NVIDIA models (no cost)

Pick directly: model:"moonshot/kimi-k3", model:"openai/gpt-5.6-sol", model:"anthropic/claude-opus-4.8", model:"xai/grok-4.5", model:"nvidia/deepseek-v4-flash" (free).

Run blockrun_models to see all available models with pricing.

`blockrun_markets`

Prediction market + derivatives data via Predexon aggregator. Flat $0.0095/call (every endpoint) — $0.0075 base + $0.002 tx fee.

CANONICAL CROSS-VENUE (Tier 1) — Predexon v2 unified data layer:

markets — list canonical market/question containers with cross-venue Predexon IDs
outcomes/:predexon_id — resolve a canonical outcome ID to its market context + venue listings Filter with ?venue=polymarket|kalshi|limitless|opinion|predictfun, ?status=, ?category=, ?league=, ?event_id=, ?pagination_key=

POLYMARKET (Tier 1):

polymarket/events, polymarket/markets — list events/markets (filter, sort, paginate)
polymarket/markets/keyset, polymarket/events/keyset — same data, cursor-based keyset pagination (use ?pagination_key=)
polymarket/crypto-updown — crypto up/down markets
polymarket/market-price/:token_id — current/historical price
polymarket/candlesticks/:condition_id — OHLCV by market
polymarket/candlesticks/token/:token_id — OHLCV by single outcome token
polymarket/volume-chart/:condition_id — volume w/ YES/NO split
polymarket/orderbooks, polymarket/trades, polymarket/activity
polymarket/markets/:token_id/volume, polymarket/markets/:condition_id/open_interest
polymarket/positions — user positions
polymarket/leaderboard, polymarket/leaderboard/market/:condition_id
polymarket/cohorts/stats, polymarket/market/:condition_id/top-holders
polymarket/uma/markets, polymarket/uma/market/:condition_id — UMA oracle questions/timeline

POLYMARKET (Tier 2 — wallet/smart-money analytics):

polymarket/wallet/:wallet — full smart-wallet profile
polymarket/wallet/:wallet/markets, .../similar
polymarket/wallet/pnl/:wallet, .../positions/:wallet, .../volume-chart/:wallet
polymarket/wallets/profiles, polymarket/wallets/filter — batch + AND/OR filter
polymarket/market/:condition_id/smart-money, polymarket/markets/smart-activity

WALLET IDENTITY & CLUSTERING (Tier 2) — cross-context labels + on-chain relationship graph:

polymarket/wallet/identity/:wallet — fetch identity + profile metadata for one wallet
polymarket/wallet/identities — POST { addresses: [...] } for bulk lookup (up to 200 wallets)
polymarket/wallet/:address/cluster — discover wallets connected via on-chain transfers + identity proofs

SPORTS (Tier 1):

sports/categories — list available sports categories
sports/markets — list sports markets grouped by game (filter ?league=, ?sport_type=, ?status=, ?venue=)
sports/markets/:game_id — single sports game with all venue outcomes
sports/outcomes/:predexon_id — equivalent sports outcomes across venues for a Predexon ID

KALSHI: kalshi/markets, kalshi/trades, kalshi/orderbooks LIMITLESS / OPINION / PREDICT.FUN: {platform}/markets, {platform}/orderbooks BINANCE FUTURES: binance/candles/:symbol, binance/ticks/:symbol

CROSS-PLATFORM:

matching-markets, matching-markets/pairs — equivalent markets across Polymarket+Kalshi
markets/search — search across all platforms in one call

REQUEST CONTRACTS:

Discover current markets with markets/search (its search term is "q"), then resolve the chosen Polymarket market with polymarket/markets/keyset and condition_id.
On polymarket/markets{,/keyset} the free-text filter is "search" (NOT "q"), and status:"open"/"closed" replaces Gamma's active/closed. "sort", "end_after", and "end_before" are supported; "order"/"ascending" are not.
Candlesticks interval is integer minutes ("1440", not "1h"); it is OPTIONAL (the server defaults). Which intervals a market serves varies — 1440 may work where 60 does not. start_time/end_time are Unix seconds.
polymarket/orderbooks requires token_id plus start_time/end_time in Unix milliseconds.
Smart-money needs a smart-wallet CRITERION (min_trades, min_volume, min_roi, min_*_pnl, min_win_rate, min_profit_factor). "window" only scopes time and is NOT sufficient on its own. Default: { window: "30d", min_trades: "100" }.

Pass query params via 'params' (GET). Use 'body' only for POST endpoints (e.g. polymarket/wallet/identities).

`blockrun_realface`

Enroll a real person's face as a BytePlus RealFace asset, then drive Seedance 2.0 video with it (blockrun_video real_face_asset_id).

A RealFace asset (ta_xxxx) lets Seedance 2.0 / 2.0-fast generate video of a SPECIFIC real person — not a generic seed image. Only those two models: seedance-2.5 is numerically newer but does NOT accept ta_ assets, and seedance-1.5-pro never did. Enrollment is a multi-step flow because BytePlus requires a live phone liveness check (the real person nods + blinks on camera) before a face photo can be uploaded.

Actions:

init: FREE. Create an asset group + a phone H5 link. The tool renders the link as a QR code and opens it; the real person scans it on their phone and completes the ~1 min liveness check. Pass group_id to refresh an expired link.
status: FREE. Poll a group until status:"active" (ready_to_finalize:true). The H5 link is valid ~120s — re-init if it expires.
enroll: PAID ($0.01 USDC, Base only). After the group is active, upload a clear front-facing photo (image_url) of the SAME person. Returns the ta_xxxx asset id.
portrait: PAID ($0.01 USDC, Base only). Virtual Portrait — enroll an AI-GENERATED character from an image URL directly, NO liveness needed (one step: name + image_url → ta_xxxx). For fictional/AI characters only; for a real person use the init→status→enroll liveness flow.
list: FREE. List the RealFace + Virtual Portrait assets enrolled by this wallet (their ta_xxxx ids + names) so you can pick one for blockrun_video.

Typical flow:

blockrun_realface action:"init" name:"Alice" → scan QR on phone, do liveness
blockrun_realface action:"status" group_id:"legacy_rf_…" → repeat until ready_to_finalize:true
blockrun_realface action:"enroll" name:"Alice" group_id:"legacy_rf_…" image_url:"https://…/alice.jpg" → ta_xxxx
blockrun_video model:"bytedance/seedance-2.0" real_face_asset_id:"ta_xxxx" prompt:"…"

Privacy: BlockRun does not store face/liveness data — only the asset id, name, and the photo URL you supply.

`blockrun_video`

Generate short AI videos via BlockRun x402 (async, client-polled).

Turns a text prompt (and optional seed image) into a short MP4 clip. The tool submits the job, then polls until the video is ready (typical total wall-time 60-180s; 5 min hard cap). Payment is settled only when upstream returns a finished video — if the job fails or we give up, you are not charged.

Models. Every rate below is what you are CHARGED (margin and transaction fee included), at the 720p baseline Seedance renders by default with synced audio:

azure/sora-2 (~$0.105/sec, 720p + synced audio, text-to-video) — OpenAI Sora 2 via Azure AI Foundry. duration_seconds must be 4, 8, or 12 (4s default -> ~$0.42/clip). No image_url / RealFace.
xai/grok-imagine-video (~$0.053/sec, 8s default -> ~$0.42/clip, 1-15s) — stylized, fast
bytedance/seedance-1.5-pro (~$0.071/sec, 4-12s, 5s default -> ~$0.35/clip) — cheapest Seedance, token-priced upstream
bytedance/seedance-2.0-fast (~$0.165/sec, 4-15s, ~60-80s gen) — sweet-spot price/quality; supports BytePlus RealFace assets
bytedance/seedance-2.0 (~$0.227/sec, 4-15s, up to 4K) — highest quality, and the ONLY model that renders true 4K; supports RealFace, first/last-frame and reference media
bytedance/seedance-2.5 (~$0.315/sec, 4-30s, 5s default) — long-form: double 2.0's length ceiling, multilingual. NOT a strict upgrade — it caps at 720p and does NOT support RealFace or first/last-frame. Use 2.0 for 1080p/4K or real-person video.

Image-to-video is NOT cheaper than text-to-video on Seedance — same per-second rate. Higher resolutions ARE more expensive (token-priced: 1080p ~2.25x, 4K ~9x the 720p rate); the 402 quote is authoritative and is what gets charged.

RealFace: to generate video of a SPECIFIC real person, first enroll them with blockrun_realface (returns a ta_xxxx asset id), then pass real_face_asset_id here with seedance-2.0 or seedance-2.0-fast. Mutually exclusive with image_url.

Returns a permanent blockrun-hosted MP4 URL (the gateway mirrors the asset to GCS so URLs don't expire).

`blockrun_wallet`

Call this tool to manage the BlockRun payment wallet and control agent spending budgets.

Call this FIRST if any other blockrun_* tool returns a payment/balance error. Call this to check your current USDC balance before expensive operations. Call this to set spending limits before spawning child agents.

The server holds TWO wallets — one on Base, one on Solana — but pays on ONE active chain at a time. status shows both addresses/balances and which is active. Default chain is Base.

To pay on Solana (no env vars, no file editing, no restart):

action:"chain" chain:"solana" → provisions + activates the Solana wallet
action:"setup" → Solana address + funding QR (send USDC SPL on Solana)

Switch back with action:"chain" chain:"base". Base-only — these ignore Solana and need Base: blockrun_music, blockrun_speech, blockrun_video, blockrun_realface, paid blockrun_price, blockrun_chat routing:"smart", and native Anthropic (claude-*). blockrun_image pays on either chain.

Actions:

status (default): Both wallet addresses + USDC balances, active chain, session spending
deposit: Buy USDC with a card — mints a one-time Coinbase Onramp link and opens it in the browser (Base only; funds settle into your own wallet). Paid tools auto-open this on an out-of-funds failure; call it directly to fund up front.
setup: Get funding instructions + QR code for the ACTIVE chain (call this when balance is 0)
qr: Open QR code (active chain) in system viewer
chain + chain:"base"|"solana": Switch the active payment chain (omit chain: to just see the current one)

Budget controls:

budget + budget_action:"set" + budget_amount:1.00 → Set global spend cap
budget + budget_action:"clear" → Remove global spend cap

Multi-agent orchestration:

delegate + agent_id:"research" + agent_limit:2.00 → Allocate $2 to a child agent
revoke + agent_id:"research" → Remove a child agent's budget
report → See per-agent spending breakdown

Usage pattern for multi-agent systems:

blockrun_wallet action:"delegate" agent_id:"worker-1" agent_limit:1.00
Pass agent_id:"worker-1" to all blockrun_chat/search/etc calls for that agent
blockrun_wallet action:"report" to audit spending

Do NOT call this for actual AI queries — use blockrun_chat for that.

INSTALLATION

Connect your client

Server setup

TERMINAL

npx -y @blockrun/mcp@latest

MCP Clients

Claude Code

CLAUDE CODE · TERMINAL

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

Claude Desktop

CLAUDE DESKTOP · JSON

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

Cursor, Windsurf

JSON

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

Codex

CODEX · TERMINAL

codex mcp add blockrun-trading -- npx -y @blockrun/mcp@latest --profile trading

BlockRun MCP

One funded wallet stands in for a drawer full of provider accounts.

What it is

What you get

Requirements

Setup effort

Getting a second opinion from another model

Making media without five separate accounts

Researching something happening right now

Reading a market before betting on it

Querying a chain without running a node

Letting a sub-agent spend, but only so much

20 tools

blockrun_chat

blockrun_defi

blockrun_dex

blockrun_exa

blockrun_image

blockrun_markets

blockrun_modal

blockrun_models

blockrun_music

blockrun_phone

blockrun_polymarket

blockrun_polymarket_read

blockrun_price

blockrun_realface

blockrun_rpc

blockrun_search

blockrun_speech

blockrun_surf

blockrun_video

blockrun_wallet

What to know first

Tools you get

Requires

Where it runs

Heavy Standing cost

Connect your client

Server setup

MCP Clients

Claude Code

Claude Desktop

Cursor, Windsurf

Codex

Same category

Unichat

PAL MCP

Consult7 Large-Context Analysis

MCP Bench Router

`blockrun_chat`

`blockrun_defi`

`blockrun_dex`

`blockrun_exa`

`blockrun_image`

`blockrun_markets`

`blockrun_modal`

`blockrun_models`

`blockrun_music`

`blockrun_phone`

`blockrun_polymarket`

`blockrun_polymarket_read`

`blockrun_price`

`blockrun_realface`

`blockrun_rpc`

`blockrun_search`

`blockrun_speech`

`blockrun_surf`

`blockrun_video`

`blockrun_wallet`