blockrun-mcp

Start here. Pay-per-call access to AI models, real-time data, media generation and multi-chain RPC over x402 — which tool to reach for, how the wallet works, and how to get a first call working without spending anything.

1 skill

Use when BlockRun MCP is installed but misbehaving — Failed to connect, spawn npx ENOENT, HTTP 402, fetch failed, media timeouts, missing spend dialogs, or a Polymarket order failing after funding. Symptom → cause → fix, plus what never to do.

1 skill

Use when asked to install, add, or set up the BlockRun MCP server in Claude Code, Cursor, Codex or another client — the nvm/Homebrew PATH fix, first-run wallet, funding with USDC, profiles, and proving the install works.

1 skill

Use when the server prints 'Update available', when asked to upgrade, pin or roll back @blockrun/mcp, when a fix should be in the new version but the client still runs the old one, or when refreshing skills copied into a project.

1 skill

Use for any crypto data question — token prices, FX, commodities, stock ticker catalog, OHLC history, DEX pairs, DeFi TVL and yields, on-chain SQL, wallet labels and net worth, social mindshare. Routes across five overlapping tools and says which one to use and which are free.

1 skill

Use when the user wants typed judgments over their own data — yes/no probabilities, a labelled choice, or a rubric score over text or images. BlockRun Decisions (OpenAI Decisions-compatible, gpt-6-luna): served only at api.blockrun.ai/v1/decisions, free with a key (no x402 rail). Not an MCP tool; called with curl.

1 skill

Use when researching products, finding academic papers, discovering competitors, reading webpage content, or getting cited answers grounded in real web sources.

1 skill

GenTech Labs' integration patterns for BlockRun from Hermes Agent — daily usage patterns, cost-optimized workflows, multi-tool pipelines and error handling across the full toolset.

1 skill

Use when generating or editing images — turns a vague request ("make me a cool poster") into a structured, text-accurate prompt that renders what was actually asked for.

1 skill

Use when the user needs to run code remotely in a disposable container, wants optional GPU access, or needs a safer place for untrusted or heavy compute.

1 skill

Use when the user wants phone-number intelligence (carrier, line type, SIM-swap and call-forwarding fraud signals), US/CA number provisioning, or outbound AI voice calls.

1 skill

Use when the user wants to actually place, manage, or redeem real bets on Polymarket via blockrun_polymarket — setup, funding, confirm-gated orders, positions, redemption.

1 skill

Use when user asks about event probabilities, prediction market odds, what people are betting on, Polymarket or Kalshi prices, or wants to find markets on a specific topic.

1 skill

Use when the user needs raw blockchain JSON-RPC — contract reads, native balances, blocks, transactions, logs, gas estimates — across 40 chains through one gateway, with no node and no API key.

1 skill

Use when the user wants real-time web or news results with AI-summarized answers and citations — the cheapest path for "what just happened" questions where freshness beats semantic ranking.

1 skill

Build a presentation-ready live Polymarket signal from price, probability history, smart-money, and liquidity evidence, then produce a safe order preview and verify state.

1 skill

Surf data endpoints were retired by the gateway on 2026-09-06 — this skill redirects each former Surf question to the tool that still serves it (blockrun_price, blockrun_defi, blockrun_markets, blockrun_dex, blockrun_rpc) and names what has no replacement yet.

1 skill