Blockrun Mcp

blockrunai/blockrun-mcp

A wallet-based MCP server that routes requests to 55+ AI models, live market data, and web APIs through pay-per-use USDC micropayments on Base. Skip API key management for Exa neural search, Polymarket predictions, Twitter/X data, DEX prices via DexScreener, and model endpoints from OpenAI to DeepSeek. Each call costs fractions of a cent billed from a local wallet. Fund once with $5 USDC and query real-time crypto prices, generate images with DALL-E or Flux, search recent research papers, or pull Twitter mentions without subscriptions or rate limit negotiations. Useful when you want Claude to access live data sources without juggling multiple API accounts.

GitHub stars: 390
tools: 18
auth: Secret needed
transport: STDIO
env vars: 3
last updated: Nov 12, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp @blockrun/mcp --name blockrun-mcp --env 'BLOCKRUN_WALLET_KEY=${BLOCKRUN_WALLET_KEY}' --env 'SOLANA_WALLET_KEY=${SOLANA_WALLET_KEY}' --env 'BLOCKRUN_API_KEY=${BLOCKRUN_API_KEY}'

Run in your terminal. add-mcp asks which agents to add it to, then asks for each value it needs. Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add blockrun-mcp --env BLOCKRUN_WALLET_KEY=YOUR_BLOCKRUN_WALLET_KEY --env SOLANA_WALLET_KEY=YOUR_SOLANA_WALLET_KEY --env BLOCKRUN_API_KEY=YOUR_BLOCKRUN_API_KEY -- npx -y @blockrun/mcp

Run in your terminal. Replace YOUR_* placeholders with real values; add --scope user to install for every project.

Tools

Verified live · 18 tools

Verified live against the running server on Jun 11, 2026.

blockrun_walletCall 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 bef...6 params

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 bef...

Parameters* required

actionstring

What to doone of status · setup · qr · chain · budget · delegatedefault: status

agent_idstring

Agent identifier for delegate/revoke/report actions

agent_limitnumber

Budget limit in USD for this agent (required for delegate action)

budget_actionstring

Budget action (for action='budget')one of set · check · clear

budget_amountnumber

Budget limit in USD (for budget_action='set')

chainstring

Target chain for action='chain'. Omit to view the current active chain.one of base · solana

blockrun_chatGet a second opinion from another AI model, or use a specialized model for a specific task. Notable modes: - mode:"glm" → Zhipu GLM-5 / GLM-5-Turbo ($0.001/call, excellent for coding tasks, pays via USDC on BlockRun) - mode:"coding" → GLM-5 first, then code-specialized models...13 params

Get a second opinion from another AI model, or use a specialized model for a specific task. Notable modes: - mode:"glm" → Zhipu GLM-5 / GLM-5-Turbo ($0.001/call, excellent for coding tasks, pays via USDC on BlockRun) - mode:"coding" → GLM-5 first, then code-specialized models...

Parameters* required

agent_idstring

Agent identifier. If a budget was delegated for this agent_id via blockrun_wallet action:'delegate', spending is tracked and enforced. The agent is hard-stopped when its budget is exhausted.

max_tokensnumber

Max tokens in responsedefault: 1024

message*string

Your message to the AI

messagesarray

Conversation history for multi-turn context. When provided, 'message' is appended as the final user turn. Use with explicit 'model' param (defaults to 'openai/gpt-5.5' if not specified). Note: if y...

modestring

Routing mode: glm = Zhipu GLM-5/GLM-5-Turbo ($0.001/call, great for coding), coding = GLM-5 + code models, cheap = GLM-5 + budget, free = NVIDIA only (ignored if model specified)one of fast · balanced · powerful · cheap · reasoning · free

modelstring

Specific model ID (e.g., 'zai/glm-5', 'openai/o3')

response_formatstring

Set to 'json_object' to force valid JSON output (no markdown fences). Works across all providers.one of text · json_object

routingstring

Set to "smart" to auto-select the optimal model via ClawRouter (14-dimension AI routing)one of smart

routing_profilestring

Cost/quality profile for ClawRouter: "free" (zero cost NVIDIA), "eco" (budget), "auto" (balanced, default), "premium" (best quality) (only applies when routing: "smart")one of free · eco · auto · premiumdefault: auto

stoparray

Up to 4 stop sequences; generation halts when any is produced

systemstring

Optional system prompt

temperaturenumber

Creativity 0-2default: 1

thinkingobject

Anthropic extended thinking. Only honored for anthropic/claude-* models — these go direct to the native /v1/messages endpoint and the response includes verbatim type:'thinking' blocks with their or...

blockrun_modelsList available AI models with pricing. Use to discover models and compare costs.2 params

List available AI models with pricing. Use to discover models and compare costs.

Parameters* required

categorystring

Filter by categoryone of all · chat · reasoning · image · embeddingdefault: all

providerstring

Filter by provider (e.g., 'openai', 'anthropic')

blockrun_imageGenerate or edit images via BlockRun. Pays with USDC — no separate API keys needed. Actions: - generate (default): Create image from text prompt - edit: Transform an existing image using img2img Generation models (1024x1024 base price; larger sizes cost more on gpt-image-*): -...7 params

Generate or edit images via BlockRun. Pays with USDC — no separate API keys needed. Actions: - generate (default): Create image from text prompt - edit: Transform an existing image using img2img Generation models (1024x1024 base price; larger sizes cost more on gpt-image-*): -...

Parameters* required

actionstring

generate: create from text; edit: transform existing imageone of generate · editdefault: generate

agent_idstring

Agent identifier for budget tracking and enforcement.

imagestring

Source image for edit action: base64-encoded image or URL

modelstring

Model to use (default: openai/gpt-image-2 for both generate and edit). gpt-image-2 renders on-image text best; nano-banana-pro for 4K photorealism; cogview-4 / grok-imagine-image for cheap drafts.one of

zai/cogview-4 · google/nano-banana · google/nano-banana-pro · openai/gpt-image-1 · openai/gpt-image-2 · xai/grok-imagine-image

prompt*string

Image description or edit instructions

qualitystring

one of standard · hddefault: standard

sizestring

Image size. Common values: 1024x1024 (all models), 1536x1024 / 1024x1536 (gpt-image-*), 2048x2048 / 4096x4096 (nano-banana-pro)default: 1024x1024

blockrun_musicGenerate music tracks via BlockRun x402. Generates a full-length ~3 minute MP3 track. Takes 1-3 minutes to complete. Models: minimax/music-2.5+ ($0.1575), minimax/music-2.5 ($0.1575) Returns a time-limited CDN URL — download immediately if you need to keep the file.5 params

Generate music tracks via BlockRun x402. Generates a full-length ~3 minute MP3 track. Takes 1-3 minutes to complete. Models: minimax/music-2.5+ ($0.1575), minimax/music-2.5 ($0.1575) Returns a time-limited CDN URL — download immediately if you need to keep the file.

Parameters* required

agent_idstring

Agent identifier for budget tracking and enforcement.

instrumentalboolean

Generate without vocals (default: true)default: true

lyricsstring

Custom lyrics. Cannot be used with instrumental: true

modelstring

Music model to useone of minimax/music-2.5+ · minimax/music-2.5default: minimax/music-2.5+

prompt*string

Music style, mood, or description. E.g. 'upbeat synthwave with neon pads', 'chill lo-fi beats', 'epic orchestral film score'

blockrun_speechElevenLabs voice via BlockRun x402 — speak text aloud, generate sound effects, list voices. Actions: - speak (default): text-to-speech. E.g. "speak this with the sarah voice". Price = chars/1000 × rate (min $0.001), quoted before payment. - sound_effect: cinematic sound effect...9 params

ElevenLabs voice via BlockRun x402 — speak text aloud, generate sound effects, list voices. Actions: - speak (default): text-to-speech. E.g. "speak this with the sarah voice". Price = chars/1000 × rate (min $0.001), quoted before payment. - sound_effect: cinematic sound effect...

Parameters* required

actionstring

speak: text-to-speech (default). sound_effect: generate a sound effect. voices: list voices (free).one of speak · sound_effect · voicesdefault: speak

agent_idstring

Agent identifier for budget tracking and enforcement.

duration_secondsnumber

Sound effect length in seconds (sound_effect only; default: auto)

inputstring

speak: text to synthesize. sound_effect: description of the sound, e.g. 'rain on a tin roof, distant thunder' (max 1000 chars).

modelstring

Speech model (speak only)one of elevenlabs/flash-v2.5 · elevenlabs/turbo-v2.5 · elevenlabs/multilingual-v2 · elevenlabs/v3default: elevenlabs/flash-v2.5

prompt_influencenumber

How literally to follow the prompt, 0-1 (sound_effect only)

response_formatstring

Audio formatone of mp3 · opus · pcm · wavdefault: mp3

speednumber

Playback speed 0.7-1.2 (speak only)

voicestring

Voice alias (sarah, george, laura, charlie, river, roger, callum, harry) or raw ElevenLabs voice_id. Default: sarah.

blockrun_videoGenerate 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...6 params

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...

Parameters* required

agent_idstring

Agent identifier for budget tracking and enforcement.

duration_secondsinteger

Duration to bill for (defaults to the model's default — 8s for xAI, 5s for Seedance; Seedance supports up to 10s).

image_urlstring

Optional seed image URL for image-to-video generation

modelstring

Video model to useone of

azure/sora-2 · xai/grok-imagine-video · bytedance/seedance-1.5-pro · bytedance/seedance-2.0-fast · bytedance/seedance-2.0

default: xai/grok-imagine-video

prompt*string

Text description of the video to generate. E.g. 'a red apple slowly spinning on a wooden table', 'a hummingbird hovering near a red flower, ultra slow motion'

real_face_asset_idstring

BytePlus RealFace asset id (from blockrun_realface enroll/list) to generate video of a specific real person. Seedance 2.0 / 2.0-fast only. Mutually exclusive with image_url.

blockrun_realfaceEnroll 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. Enrollment is a mul...5 params

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. Enrollment is a mul...

Parameters* required

action*string

What to doone of init · status · enroll · portrait · list

agent_idstring

Agent identifier for budget tracking and enforcement (enroll only).

group_idstring

Asset-group id from init (required for status and enroll; pass to init to refresh an expired H5 link). Not used by portrait.

image_urlstring

Public HTTPS URL to a clear front-facing face image (JPG/PNG/WEBP, ≤10MB). Required for enroll and portrait.

namestring

Display name for the person/character (required for init, enroll, and portrait).

blockrun_searchGrok Live Search — real-time web + X/Twitter + news with AI-summarized results and citations. $0.025 per returned source (max_results × $0.025; default max_results=10 → $0.25). Common shape: - body: { query: "...", sources: ["web","x","news"], max_results: 10, from_date: "YYYY...3 params

Grok Live Search — real-time web + X/Twitter + news with AI-summarized results and citations. $0.025 per returned source (max_results × $0.025; default max_results=10 → $0.25). Common shape: - body: { query: "...", sources: ["web","x","news"], max_results: 10, from_date: "YYYY...

Parameters* required

agent_idstring

Agent identifier for budget tracking and enforcement.

bodyvalue

Request body. At minimum { query: '...' }. Sent as POST.

pathstring

Endpoint sub-path under /v1/search/ (default empty = root /v1/search). Reserved for future surfaces.default:

blockrun_exaNeural web search via Exa — understands meaning, not just keywords. Great for research. Common paths (all POST, body shapes documented in the exa-research skill): - search — body: { query, numResults?, category?, includeDomains?, excludeDomains? } ($0.01/call) - answer — body:...3 params

Neural web search via Exa — understands meaning, not just keywords. Great for research. Common paths (all POST, body shapes documented in the exa-research skill): - search — body: { query, numResults?, category?, includeDomains?, excludeDomains? } ($0.01/call) - answer — body:...

Parameters* required

agent_idstring

Agent identifier for budget tracking and enforcement.

bodyvalue

JSON body for the call. Sent as POST. Required for all four endpoints.

path*string

Endpoint name under /v1/exa/, e.g. 'search', 'answer', 'contents', 'find-similar'

blockrun_marketsPrediction market + derivatives data via Predexon aggregator. Tier 1 = $0.001/call, Tier 2 = $0.005/call. CANONICAL CROSS-VENUE (Tier 1) — Predexon v2 unified data layer: - markets — list canonical market/question containers with cross-venue Predexon IDs - markets/listings — v...4 params

Prediction market + derivatives data via Predexon aggregator. Tier 1 = $0.001/call, Tier 2 = $0.005/call. CANONICAL CROSS-VENUE (Tier 1) — Predexon v2 unified data layer: - markets — list canonical market/question containers with cross-venue Predexon IDs - markets/listings — v...

Parameters* required

agent_idstring

Agent identifier for budget tracking and enforcement.

bodyvalue

JSON body for POST queries (triggers pmQuery — most endpoints are GET)

paramsobject

Query parameters for GET requests (e.g. { limit: '20', active: 'true' })

path*string

Endpoint path, e.g. 'polymarket/events', 'kalshi/markets/KXBTC-25MAR14', 'polymarket/wallet/0xabc...', 'markets/search'

blockrun_priceRealtime quotes and OHLC history for crypto, FX, commodities and 12 global stock markets (Pyth-backed). - action="price" — realtime quote for a symbol - action="history" — OHLC bars between from/to (unix seconds) - action="list" — discovery: list available symbols (free) Prici...11 params

Realtime quotes and OHLC history for crypto, FX, commodities and 12 global stock markets (Pyth-backed). - action="price" — realtime quote for a symbol - action="history" — OHLC bars between from/to (unix seconds) - action="list" — discovery: list available symbols (free) Prici...

Parameters* required

action*string

Which endpoint to hit: price, history, or list.one of price · history · list

agent_idstring

Agent identifier for budget tracking and enforcement.

category*string

Market category.one of crypto · fx · commodity · usstock · stocks

fromnumber

History window start (unix seconds).

limitinteger

Max items for list (default 100, max 2000).

marketstring

Stock market code — required when category='stocks'.one of us · hk · jp · kr · gb · de

querystring

Free-text filter for list.

resolutionstring

Bar resolution for history (default D).one of 1 · 5 · 15 · 60 · 240 · D

sessionstring

Equity session hint (pre/post/on); ignored for non-equity.one of pre · post · on

symbolstring

Ticker (required for price+history). e.g. BTC-USD, AAPL, EUR-USD.

tonumber

History window end (unix seconds).

blockrun_dexGet real-time DEX data from DexScreener. FREE - no payment required. Use for: - Token prices and liquidity across chains - Trading volume and price changes - Finding token pairs and contracts Examples: blockrun_dex({ query: "SOL" }) -> Search for SOL pairs blockrun_dex({ token...4 params

Get real-time DEX data from DexScreener. FREE - no payment required. Use for: - Token prices and liquidity across chains - Trading volume and price changes - Finding token pairs and contracts Examples: blockrun_dex({ query: "SOL" }) -> Search for SOL pairs blockrun_dex({ token...

Parameters* required

chainstring

Filter by chain (ethereum, solana, base, etc.)

querystring

Search query (token name, symbol, or address)

symbolstring

Token symbol to search

tokenstring

Token address for direct lookup

blockrun_modalRun isolated code in a BlockRun-hosted Modal sandbox — disposable remote container, optional GPU. Use when you need: a clean ephemeral environment, GPU access (T4/L4/A10G/A100/A100-80GB/H100), or a safer place for untrusted code. Prefer local tools for normal repo work. Common...3 params

Run isolated code in a BlockRun-hosted Modal sandbox — disposable remote container, optional GPU. Use when you need: a clean ephemeral environment, GPU access (T4/L4/A10G/A100/A100-80GB/H100), or a safer place for untrusted code. Prefer local tools for normal repo work. Common...

Parameters* required

agent_idstring

Agent identifier for budget tracking and enforcement.

bodyvalue

JSON body. Sent as POST.

path*string

Endpoint under /v1/modal/, e.g. 'sandbox/create', 'sandbox/exec'

blockrun_phonePhone-number intelligence, US/CA number provisioning, and outbound AI voice calls. Common paths (path = everything after /v1/): - phone/lookup POST body: { phoneNumber } ($0.01) - phone/lookup/fraud POST body: { phoneNumber } — SIM-swap + call-forwarding signals ($0.05) - phon...3 params

Phone-number intelligence, US/CA number provisioning, and outbound AI voice calls. Common paths (path = everything after /v1/): - phone/lookup POST body: { phoneNumber } ($0.01) - phone/lookup/fraud POST body: { phoneNumber } — SIM-swap + call-forwarding signals ($0.05) - phon...

Parameters* required

agent_idstring

Agent identifier for budget tracking and enforcement.

bodyvalue

JSON body. Sent as POST. Omit for the free GET poll (voice/call/{call_id}).

path*string

Endpoint after /v1/. Use 'phone/...' for lookup + number ops, 'voice/call' for outbound AI calls, 'voice/call/{id}' (no body) to poll status.

blockrun_surfUnified crypto data via Surf (asksurf.ai) — 84 endpoints, one API. Coverage: CEX market data (16 exchanges), on-chain SQL across 13 chains, 100M+ labeled wallets, prediction markets (Polymarket + Kalshi), social mindshare / CT intelligence, news, unified search, and Surf-1.5 c...4 params

Unified crypto data via Surf (asksurf.ai) — 84 endpoints, one API. Coverage: CEX market data (16 exchanges), on-chain SQL across 13 chains, 100M+ labeled wallets, prediction markets (Polymarket + Kalshi), social mindshare / CT intelligence, news, unified search, and Surf-1.5 c...

Parameters* required

agent_idstring

Agent identifier for budget tracking and enforcement.

bodyvalue

JSON body for POST endpoints. Provide for: onchain/query, onchain/sql, chat/completions. When set, the call is sent as POST; otherwise GET with params.

paramsobject

Query parameters for GET endpoints, e.g. { symbol: 'BTC' } or { address: '0x...', chain: 'ethereum' }

path*string

Endpoint path under /v1/surf/, e.g. 'market/price', 'prediction-market/polymarket/ranking', 'wallet/detail', 'onchain/sql', 'chat/completions'

blockrun_rpcRaw JSON-RPC against 40+ blockchains — one endpoint, no node, no API key. $0.002 per call (batch charges per element). Use when you need data the higher-level tools don't cover: contract reads (eth_call), balances, blocks, txs, logs, gas, or any chain-native RPC method. Networ...5 params

Raw JSON-RPC against 40+ blockchains — one endpoint, no node, no API key. $0.002 per call (batch charges per element). Use when you need data the higher-level tools don't cover: contract reads (eth_call), balances, blocks, txs, logs, gas, or any chain-native RPC method. Networ...

Parameters* required

agent_idstring

Agent identifier for budget tracking and enforcement.

bodyvalue

Full JSON-RPC 2.0 body or an array of them (batch). Overrides method/params when set.

methodstring

JSON-RPC method, e.g. 'eth_blockNumber', 'eth_call', 'getSlot' (Solana), 'getblockchaininfo' (Bitcoin). Required unless 'body' is set.

network*string

Chain key, e.g. 'ethereum', 'base', 'solana', 'bitcoin', 'arbitrum', 'polygon'. Unknown slugs pass through to the Tatum gateway.

paramsvalue

JSON-RPC params array for the method, e.g. ['0xabc...', 'latest'].

blockrun_defiDeFi fundamentals via DefiLlama — protocol TVL, chain TVL, yield pools (APY), token prices. Pays per call in USDC, no API key. Paths (GET only): - protocols ($0.005) — all DeFi protocols ranked by TVL - protocol/{slug} ($0.005) — one protocol's TVL history + chain breakdown, e...2 params

DeFi fundamentals via DefiLlama — protocol TVL, chain TVL, yield pools (APY), token prices. Pays per call in USDC, no API key. Paths (GET only): - protocols ($0.005) — all DeFi protocols ranked by TVL - protocol/{slug} ($0.005) — one protocol's TVL history + chain breakdown, e...

Parameters* required

agent_idstring

Agent identifier for budget tracking and enforcement.

path*string

Endpoint under /v1/defillama/, e.g. 'protocols', 'protocol/aave-v3', 'chains', 'yields', 'prices/coingecko:ethereum'

Configuration

BLOCKRUN_WALLET_KEYsecret

Optional: EVM private key (0x-prefixed hex) for USDC payments on Base; also the Polymarket signer. If not set, a wallet is auto-generated.

SOLANA_WALLET_KEYsecret

Optional: Solana private key (bs58) for USDC payments on Solana. Setting it selects the Solana chain. If not set, a wallet is auto-generated.

BLOCKRUN_API_KEYsecret

Optional: BlockRun account API key; bills your prepaid balance instead of a wallet (no per-call network fee). Takes priority over a wallet when set.

Readme

BlockRun MCP

Real-time data — and real trades — for Claude and any AI agent.

Agents can pay like agents: sign transactions from a wallet.
Teams can pay like teams: get a BlockRun API key at user.blockrun.ai, add credit by card or wire, and let the MCP call api.blockrun.ai.

BlockRun MCP gives your agent 19 tools — markets, research, web search, images, video, on-chain data, and live Polymarket trading — paid per call.

Two ways to pay, same tools: a self-custody wallet (USDC on Solana, Base or Arc, no account needed) — or a BlockRun API key backed by account credit. Sign up at user.blockrun.ai →

Read the odds and place the bet, from one self-custody wallet.

View the full README on GitHub

Details

Repository: github.com/blockrunai/blockrun-mcp
Categories: Search & Web Crawling, Data & Analytics, Finance & Commerce
Package: @blockrun/mcp
Transport: STDIO
Auth: Required
Registry: MCP registry, active
Resources: 2
Tools verified: Jun 11, 2026

Related Search & Web Crawling MCP servers

View all

Google Surf Mcpharimxchoi/google-surf-mcpWeb, academic and code search with graph RAG, data lineage, ontology and cross-project schema links.291stars

Alfanous - Quranic Search Enginealfanous-team/alfanousSearch and explore the Holy Qur'an with Arabic text, transliteration, and advanced search support.286stars

Openbrowser Aibilly-enrizky/openbrowser-aiAI browser automation. Write async Python to navigate, click, type, and extract data.279stars

reMarkable MCP Serversammorrowdrums/remarkable-mcpRead, render, search, and manage reMarkable documents through MCP263stars

RAG Documentationhannesrudolph/mcp-ragdocsAn MCP server implementation that provides tools for retrieving and processing documentation through vector search, enabling AI assistants to augment their resp261stars

jDocmunch MCPjgravelle/jdocmunch-mcpSection-level doc search for .md, .rst, .adoc, .org, .ipynb, .html, .yaml, .json, and OpenAPI specs.206stars