@blockrun/mcp

🏆 First of its kind — the signal → trade loop in Claude Code

Every other data integration was built forhuman developers— create an account, copy an API key into.env, add a credit card, repeat for every vendor.

Agents can't do any of that.BlockRun MCP is built for the agent-first world:

✓ One wallet · ✓ Pay-per-call · ✓ Readsandtrades · ✓ Multi-chain · ✓ Agent-ready · ✓ Open source

Before BlockRun, Claude can't answer:

- "What's the current Polymarket probability that Bitcoin hits $100k this year?"
- "Find me the top 5 papers on RAG published in the last 30 days."
- "What are people saying about @sama on X right now?"
- "What's the 24h volume on the PEPE/ETH pair on Uniswap?"
- "Polymarket has the Fed holding at 73% — put $2 on it."← and now it canplace the trade, not just read the odds.

After BlockRun, it can. Each query costs fractions of a cent, billed from a local USDC wallet. No subscriptions. No API dashboards. No key rotation.

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

-s userinstalls globally (available in every project). The--separator ensures-yis passed tonpx, not parsed byclaude mcp add.

💡Homebrew / nvm users:if the server doesn't connect, Claude Code likely can't findnode/npxon its launcher PATH. Pass your shell PATH through — works on CLI and desktop:

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

Claude Desktop— add toclaude_desktop_config.json:

$5 covers~525 market queries · ~500 Exa searches · ~250 image generations · ~14 Seedance 1.5-pro clips.

"What's Polymarket saying about the next Fed decision? If 'hold' is above 70%, put $2 on it."

Claude reads the odds withblockrun_marketsand — with your confirmation — places the trade withblockrun_polymarket. One wallet. Gasless. Confirm-gated.

User:What's Polymarket saying about the Fed rate decision next month?

Claude:According to Polymarket, the market puts a73% probabilityon the Fed holding rates steady, 24% on a 25bp cut, 3% on a hike. 24h volume: $2.1M. The "Hold" contract last traded at $0.73.

User:Polymarket has Hawley at ~13% to announce a 2026 presidential run — put $1 on Yes.

Claude:Done — bought7.63 shares of Yes at $0.131($1.00, market FOK). Real on-chain order, settled in pUSD from your gasless Polymarket deposit wallet; I'm tracking the position now.

(signal viablockrun_markets, trade viablockrun_polymarket— one self-custody wallet, gasless · on-chain tx0x7ca8…)
- Prediction-market consensus→"Polymarket's odds for the next Fed decision?"—blockrun_markets
- Signal → trade(the full loop, self-custody)→"If 'hold' is under 30%, put $2 on Yes."—blockrun_marketsreads,blockrun_polymarket action:"buy"places. Gasless, confirm-gated.
- On-chain forensics→"This wallet — what's it labeled, what does it hold, when did it whale up?"—blockrun_surf
- Cited research→"5 most-cited papers on speculative decoding, last 90 days."—blockrun_exa
- Image generation with on-image text→"Poster announcing GPT-5.5, retro-futuristic, headline 'NOW LIVE'."—blockrun_image
- Give your agent a voice→"Speak this with the sarah voice."—blockrun_speech
- Voice phone-out→"Call +1-415-… and confirm Friday at 3pm."—blockrun_phone
- Multi-agent research, capped→"Spawn 3 agents on competing L1 narratives. Cap each at $0.50."—blockrun_wallet delegate × 3
- Cross-chain SQL→"Top 10 tokens by DEX volume on Base, last 24h."—blockrun_surfonchain/sql

Architecture— the official "deposit wallet" path (signature type POLY_1271): a smart-contract vault on Polygon, CREATE2-derived from your key (only your key can authorize it), holds betting funds inpUSD(Polymarket's 1:1 collateral wrapper). Deployment, approvals, and redemptions all rungaslessthrough Polymarket's relayer — you never need POL.

# 1. Provision your deposit wallet (idempotent, gasless) blockrun_polymarket action:"setup" # 2. Fund it from your Base USDC in one call (gasless; $0.01 fee, non-custodial) blockrun_polymarket action:"fund" amount_usd:5 confirm:true # 3. Sign the one-time gasless approval batch blockrun_polymarket action:"setup" confirm:true # 4. Find a market, preview safely, then place only after exact user approval 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 # 5. Manage → positions · orders · cancel · sell · redeem · withdraw

Safety rails(server-side; an agent cannot bypass them):confirm:truerequired for every order/approval/redeem,POLYMARKET_MAX_BET_USDper-order cap (default $25), optionalPOLYMARKET_MAX_SESSION_USDsession cap, and bets never draw from the x402 API budget.

Regions:Polymarket geoblocks order placement by IP (US/UK + many regions).Handled by default— the MCP routes CLOB traffic through BlockRun's hosted Finland egress (a fully unrestricted region under Polymarket's policy), so trading works out of the box;setupreports your status. OverridePOLYMARKET_CLOB_HOSTto go direct or run your own egress, optionally reached viaHTTPS_PROXY/POLYMARKET_CLOB_PROXY(a proxy alone doesn't change the Polymarket-facing egress). Complying with Polymarket's terms for your jurisdiction is your responsibility.

⚠️Back up your signer key(~/.blockrun/.sessionby default; aBLOCKRUN_WALLET_KEYenv var or an existing agentwallet.jsontakes precedence —setupprints the actual signer address). It is the only key to both the payment wallet and the Polymarket deposit wallet.

Runblockrun_walletto see your address. The server pays onBaseby default.

$5 covers ~525 market queries, ~500 Exa searches, ~250 image generations, or ~14 Seedance 1.5-pro clips (5s @ 720p+audio, ~$0.35 each).

Two tool calls — no env vars, no file editing, no restart:

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 theSolananetwork — from Coinbase (pick "Solana"), Phantom, Solflare, or Backpack. Switch back withblockrun_wallet action:"chain" chain:"base". The server keeps both wallets; switching just changes which one pays.

Base-only— these fall back to Base regardless of active chain:blockrun_music,blockrun_speech,blockrun_video,blockrun_modal,blockrun_defi, paidblockrun_realface, paid stockblockrun_price, and native Anthropic (claude-) passthrough. In Solana mode they return a "switch to Base" message instead of charging.blockrun_imagepays on either chain.

- Insufficient balance/ HTTP 402 after retry→ Runblockrun_wallet action:"setup", send USDC on Base (or Solana).
- blockrundoesn't connect / "MCP server failed" /spawn npx ENOENT→ Almost always aPATH issue: Claude Code can't findnode/npxon its launcher PATH (common with Homebrew / nvm, on CLIand*desktop). Fix by passing your shell PATH at install:

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

What is BlockRun MCP?An open-source MCP server that gives Claude and other agents <!-- -->20<!-- --> tools for real-time data and real actions (trading, media, on-chain), paid per call in USDC. No accounts, no API keys.

Do I need API keys or accounts?No. A wallet is auto-created locally on first run; you fund it with USDC. No signups, no dashboards, no key rotation.

How much does it cost?Pay-per-call — fractions of a cent to a few cents. The free tier (blockrun_chat mode:"free",blockrun_dex, cryptoblockrun_price,blockrun_models) is $0. $5 of USDC covers thousands of queries.

Is it safe / non-custodial?Yes. Your private key never leaves your machine (~/.blockrun/.sessionby default,0600). x402 payments and Polymarket orders are signed locally — BlockRun forwards signed payloads and cannot move your funds.

Which clients work?Claude Code, Claude Desktop, Cursor, Windsurf, and any MCP-compatible client.

Can it really place real bets?Yes.blockrun_polymarketplaces real, USDC-settled orders on Polymarket's CLOB — confirm-gated and capped. Read the odds withblockrun_markets, place withblockrun_polymarket.

Base or Solana?Both. Switch instantly withblockrun_wallet action:"chain". A few media/paid tools settle on Base only (noted above).

BlockRun is agent-native AI infrastructure — one wallet, x402 USDC micropayments, across every surface:

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

Remote Streamable HTTP MCP gateway for GPT-5.5 chat plus 92 text, web, JSON, and x402 discovery tools with Base USDC pay-per-call.

Deploy and serve Haystack pipelines as REST APIs, MCP Tools, and OpenAI-compatible chat completion backends.

JCode Harness Cloud is a paid remote MCP endpoint for OpenAI Codex harness MCP. It exposes structured JSON tools, a public server card, token-based access, usage receipts, and audit-ready wo

Provides educational content, model information, and read-only API interactions for Lerian developers.

A command-line interface wrapper for the Google Gemini API, enabling interaction with Gemini's Search and Chat tools.

A backend service providing tools, resources, and prompts for AI models using the Model Context Protocol (MCP).

A bridge API service connecting Ollama with Model Context Protocol (MCP) servers.

MCP server for OpenRouter — chat with any model through one API key

An MCP client for Cursor that uses OpenRouter.ai to access multiple AI models. Requires an OpenRouter API key.