Blockrun MCP
Web search, deep research, prediction markets & crypto data for AI agents.
Connector by BlockRunAI · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/blockrunai-blockrun-mcp
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Use cases: web-search, deep-research, crypto-web3
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.
- Tools
- 8 read · 7 write · 4 delete
- Secrets
- 3 (API keys, tokens or passwords)
- Install scripts
- None found
- Runs as
- Node.js package
Tools by what they do 19
Read from the source code; the running server may list different tools.
Read 8 · Look things up without changing anything.
blockrun_defiblockrun_dexblockrun_exablockrun_marketsblockrun_modelsblockrun_polymarket_readblockrun_priceblockrun_search
Write 7 · Create, change, send or run things.
blockrun_chatblockrun_imageblockrun_musicblockrun_realfaceblockrun_speechblockrun_videoblockrun_wallet
Delete 4 · Delete, drop, revoke or wipe things.
blockrun_modalblockrun_phoneblockrun_polymarketblockrun_rpc
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
BLOCKRUN_API_KEYBLOCKRUN_WALLET_KEYSOLANA_WALLET_KEY
Files it touches
- Any path the agent passes to its tools
Tools (19)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
blockrun_chatGet a second opinion from another AI model, or use a specialized model for a specific task. Notable modes: - mode:"powerful" → Claude Opus 5, Claude Opus 4.8, GPT-5.6-sol, Claude Fable 5 (frontier, 1M context) - mode:"reasoning" → Claude Opus 5, GPT-5.6-sol, Kimi K3, Grok 4.3, deepseek-v4-pro - mode:"coding" → Claude Opus 5, GPT-5.3-codex, Kimi K3, Grok Build, GLM-5.2 - mode:"cheap" → deepseek-v4-pro, Qwen3.7 Flash, MiniMax M3, Gemini 2.5 Flash, DeepSeek Chat / V4.1 Flash - mode:"glm" → Zhipu GLM-5 / 5.2 / 5.1 / 5-Turbo (strong at coding) - mode:"free" → free models (no cost) Pick directly: …
blockrun_defiread-onlyDeFi fundamentals via DefiLlama — protocol TVL, chain TVL, yield pools (APY), token prices. Pays per call in USDC, no API key. Paths (GET only; price = base + the gateway's flat tx fee, $0.001 today — we reserve $0.002; the 402 header carries the exact charge): - protocols ($0.005 base) — all DeFi protocols ranked by TVL - protocol/{slug} ($0.005 base) — one protocol's TVL history + chain breakdown, e.g. protocol/aave-v3 - chains ($0.005 base) — TVL by chain - yields ($0.005 base) — yield pools with APY + TVL …
blockrun_dexread-onlyGet 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: "So11...xxx" }) -> Get specific token data blockrun_dex({ symbol: "PEPE" }) -> Search by symbol
blockrun_exaread-onlyNeural 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.010 base + tx fee) - answer — body: { query } ($0.010 base + tx fee) - contents — body: { urls: [...] } ($0.002/URL + ONE tx fee, up to 100) - find-similar — body: { url, numResults? } …
blockrun_imageGenerate or edit images via BlockRun. Pays with USDC on the ACTIVE chain — Base or Solana (see blockrun_wallet) — 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-*): - openai/gpt-image-2 ($0.06–0.12) — flagship, reasoning-driven, multilingual on-image text + character consistency (default) - openai/gpt-image-2.5-sunburst ($0.28–0.56) — OpenAI's most capable image model, high-precision editing - openai/gpt-image-2.5-flare ($0.…
blockrun_marketsread-onlyPrediction market + derivatives data via Predexon aggregator. Flat $0.0075 base per call (every endpoint) plus the gateway's network fee — $0.001 on Base today, none quoted on Solana; the 402 header carries the exact charge (we reserve $0.0095). 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 (params: { pagination_key }) - polymarket/crypto-updown — crypto up/down markets - polymarket/market-price/:token_id — current/historical price - p…
blockrun_modalcan change or delete dataRun 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/H100 — those five only), or a safer place for untrusted code. Prefer local tools for normal repo work. ⚠️ `timeout` IS THE BILLED LIFETIME — charged upfront in full, NEVER refunded. It is not an idle timeout: you pay for the time you ASK for, not the time you use, and terminating early refunds nothing. Ask for what you need, not a safe-looking ceiling. - timeout ≤ 300s → flat: $0.0120 CPU · $0.0520 T4 · $0.0820 L4 · $0…
blockrun_modelsread-onlyList available AI models with pricing. Use to discover models and compare costs.
blockrun_musicGenerate music tracks via BlockRun x402 (async, client-polled). Generates a full-length ~3 minute MP3 track. Takes 1-3 minutes to complete. The tool submits the job and, for slower tracks, polls until it is ready. On the Base wallet payment settles only when a finished track is returned — if the job fails you are not charged; if this client gives up while a paid request is still in flight the gateway may still settle, and the error text says so. On Solana and on the account rail the job is billed when the gateway ACCEPTS it, so a job that later fails or outlives the poll budget is still charg…
blockrun_phonecan change or delete dataPhone-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) - phone/numbers/buy POST body: { country?: "US"|"CA", areaCode? } — 30-day lease ($5.00) - phone/numbers/renew POST body: { phoneNumber } — extend 30 days ($5.00) - phone/numbers/list POST body: {} — your wall…
blockrun_polymarketcan change or delete dataTrade on Polymarket prediction markets (CLOB V2, Polygon). REAL MONEY — orders spend pUSD held in your Polymarket deposit wallet, signed locally by your BlockRun key. Free tool (no BlockRun API charge); discover markets/prices/token IDs with blockrun_markets first. Run action:"setup" FIRST (and again after funding). It creates a gasless deposit wallet owned by your key, checks pUSD balance + exchange approvals, and prints funding instructions. Zero config — no Polymarket account or API keys; setup bootstraps its credentials from your wallet key. Actions: - setup — create/inspect deposit wall…
blockrun_polymarket_readread-onlyRead or preview Polymarket state without signing or changing anything. Actions: - positions — holdings, current value, PnL, and redeemable status (free Data API) - orders — open CLOB orders, optionally filtered by condition_id - preview — build a live buy/sell order preview from the CLOB book. side plus token_id (or condition_id+outcome) are required. Market buys use amount_usd; limit orders use price+size. This action never accepts confirm and never signs or submits an order. Use blockrun_polymarket only for setup and funds-affecting operations: confirmed buy/sell, cancel, redeem, fund, or …
blockrun_priceread-onlyRealtime quotes and OHLC history for crypto, FX and commodities (Pyth-backed), plus the ticker catalog for 12 stock markets. - action="price" — realtime quote for a symbol - action="history" — OHLC bars between from/to (unix seconds) - action="list" — discovery: list available symbols (free) Pricing: - crypto / fx / commodity: FREE across price, history and list - stocks / usstock: list (ticker catalog) FREE; price/history NOT SERVED — gateway 501 before payment since 2026-09-05, nothing charged, do not retry Stocks markets: us, hk, jp, kr, gb, de, fr, nl, ie, lu, cn, ca (required when cate…
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 / 2.0-mini generate video of a SPECIFIC real person — not a generic seed image. Only those three 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 gr…
blockrun_rpccan change or delete dataRaw JSON-RPC against 40+ blockchains — one endpoint, no node, no API key. $0.002 base per call plus the gateway's flat tx fee ($0.001 today; we reserve $0.002, so budget/confirm show $0.004 per single call). A JSON-RPC batch charges $0.002 per element plus ONE fee — batch when you can. 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. Networks (full catalog in the rpc skill): ethereum, base, arbitrum, optimism, polygon, bsc, avalanche, solana, bitcoin, sui, near, ripple, polkadot, dogecoin, …
Show 4 more tools
blockrun_searchread-onlyGrok Live Search — real-time web + news with AI-summarized results and citations. Flat $0.08 per call plus the gateway's network fee ($0.001 on Base today, none on Solana; we reserve $0.002) — the same price at any max_results, so ask for as many sources as the question needs. Common shape: - body: { query: "...", sources: ["web","news"], max_results: 10, from_date: "YYYY-MM-DD", to_date: "YYYY-MM-DD" } `sources` accepts any subset of ["web","news"] (default ["web"] — pass both for news coverage). There is no X/Twitter source (removed upstream 2026-07-05; asking for it is refused before paym…
blockrun_speechAI voice via BlockRun x402 — speak text aloud (ElevenLabs or ByteDance Seed Audio), 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 effects from a text prompt, up to 22s ($0.0525/clip) - voices: list available voices (free) Models (speak): elevenlabs/flash-v2.5 ($0.05/1k chars, ~75ms, default), elevenlabs/turbo-v2.5 ($0.05/1k), elevenlabs/multilingual-v2 ($0.10/1k, narration), elevenlabs/v3 ($0.10/1k, most expressive), bytedan…
blockrun_videoGenerate short AI videos via BlockRun x402 on the active Base or Solana chain (async, client-polled). Turns a text prompt (and optional seed image) into a short video clip (MP4, or MOV on Seedance 2.5). The tool submits the job, then polls until the video is ready (typical total wall-time 60-180s; 9 min Base / 15 min Solana hard cap). On the wallet rails payment settles only when upstream returns a finished video — if the job fails you are not charged; if this client gives up while a paid poll is still in flight the gateway may still settle, and the error text says so. On the account rail the…
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 before spawning child agents. If this server is running on a BlockRun API key (BLOCKRUN_API_KEY), there is no wallet and no chain: status reports the account, and setup/qr/deposit/chain do not apply. Credit is managed at https://user.blockrun.ai/dashboard/credits. In wallet mode the server holds TWO wallets — one on Solan…
Compare and alternatives
Featured in
Signals
- Stars
- 392
- Forks
- 41
- Open issues
- 7
- Weekly downloads
- 340
- Last commit
- Oct 20, 2026 (8 days ago)
- Last release
- Oct 20, 2026 (8 days ago)
- Last package publish
- Oct 20, 2026 (8 days ago)
From GitHub (fetched Oct 24, 2026) and the package registry.
Details
- Registry name
io.github.BlockRunAI/blockrun-mcp- Version
- 0.54.7
- Auth
- API key
- Packages
- npm @blockrun/mcp
- License
- MIT
- Repository
- github.com/BlockRunAI/blockrun-mcp
- First seen
- Oct 24, 2026
- Last checked
- Oct 25, 2026
More from BlockRunAI
- 0.581score
Franklin
BlockRunAI
AI agent that holds a USDC wallet, pays for each model call and paid API, and runs tasks within a budget.
AgentAFreshness: A★ 563 - 0.565score
CLAUDE.md · BlockRunAI/Franklin
BlockRunAI
CLAUDE.md from BlockRunAI/Franklin: 92 lines covering Commands, Project structure, Key dependencies, Conventions and more.
TemplateAFreshness: A★ 563Claude Code - 0.565score
AGENTS.md · BlockRunAI/Franklin
BlockRunAI
AGENTS.md from BlockRunAI/Franklin: 48 lines covering Commands, Project structure, Key dependencies, Conventions.
TemplateAFreshness: A★ 563Codex +5
Cite this page
Blockrun MCP. Agent Mart. https://agentmart.dev/connectors/blockrunai-blockrun-mcp (last updated 2026-10-25)