blockrunai/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 or Base, 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.
 
 
 
 
 
Wallet auto-created on first run. Fund with $5 USDC — or get a key at user.blockrun.ai , top up by card, and call through api.blockrun.ai . Ask Claude anything.
Every MCP server costs you this. Almost none of them tell you. How we measure it, and how to measure anyone else →
---
> **BlockRun MCP** is an open-source Model Context Protocol server that gives Claude — and any MCP-compatible agent — 19 tools for real-time data and real actions: 88 LLMs, image & video generation, prediction-market data, live web/X search, on-chain queries across 40 chains, and **the ability to place real, USDC-settled bets on Polymarket**.
You pay per call, and you choose how. **Wallet mode** authenticates with a signature and settles each call in USDC via the x402 protocol — no account, no credit card, no subscription, on Solana or Base. **Account mode** authenticates with a BlockRun API key (brk_live_…) from user.blockrun.ai, routes service calls through api.blockrun.ai, and draws down card- or wire-funded account credit at exact usage. Same 19 tools either way. MIT licensed.
🏆 First of its kind — the signal → trade loop in Claude Code
Read live Polymarket odds *and* place the bet, from one self-custody wallet, pay-per-call. Jump to Polymarket trading →
---
Why BlockRun MCP exists
Every other data integration was built for **human developers** — create an account, copy an API key into .env, add a credit card, repeat for every vendor.
**BlockRun gives you both payment rails without rebuilding the integration.** Use a wallet when the agent should self-custody funds, or use an account key when a team wants card-funded credits and a dashboard.
- **One wallet, every source** — 19 tools behind a single self-custody wallet. No per-vendor signups.
- **One account key, every source** — mint a key at user.blockrun.ai, top up by card or wire, then the MCP calls api.blockrun.ai with that key.
- **No API key required in wallet mode** — your wallet signature *is* authentication.
- **No credit card required in wallet mode** — pay per request in USDC via x402, fractions of a cent each.
- **Starts free** — the free tier (blockrun_chat mode:"free", blockrun_dex, crypto blockrun_price, blockrun_models) costs $0.
- **Reads *and* acts** — most tools deliver data; blockrun_polymarket places real, confirm-gated trades.
- **Human-in-the-loop payments** — turn on BLOCKRUN_CONFIRM_SPEND=on and the agent pauses before any paid call above your threshold; nothing is signed until you approve. Details ↓
- **Generative UI** — on Claude Desktop, claude.ai, VS Code and Cursor the Polymarket preview is a live order card with a Place button, and the wallet is a panel with balances, QR and card top-up. MCP Apps ↓
- **Self-custody** — your key never leaves your machine (~/.blockrun/.session, 0600 — or the OS keychain once you opt into BLOCKRUN_KEYCHAIN=strict). BlockRun can't move your funds.
---
How it compares
| | Raw provider APIs | Typical single-vendor MCP | **BlockRun MCP** |
| ------------------- | -------------------------------- | ------------------------- | ----------------------------------------- |
| **Setup** | Account + API key *per vendor* | Account/key for 1 vendor | **Wallet auto-created — or one BlockRun key for everything** |
| **Payment** | Credit card, monthly minimums | Credit card / vendor plan | **USDC per-call via x402, or card/wire-funded account credit** |
| **Data sources** | One per integration | One vendor | ** 19 tools — LLMs, media, markets, chain**|
| **Place real bets** | Build it yourself | Rare | **Yes — Polymarket CLOB, confirm-gated** |
| **Pay-chain** | — | — | **Solana + Base, or api.blockrun.ai with no chain at all** |
| **Agent budgets** | Manual | — | **Built-in per-agent delegation** |
| **Spend approval** | — | — | **Ask-before-pay dialog (MCP elicitation)** |