Blockrun MCP
Overview
Description from the maker (original English)
Web search, deep research, prediction markets & crypto data for AI agents. Pay per call via x402.
What you can do with it
We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.
- Connection: Runs on your computer
- Transport: stdio
- Category: Search & AI memory
- You need to fill in: BLOCKRUN_WALLET_KEY, SOLANA_WALLET_KEY, BLOCKRUN_API_KEY
Install
Pick the AI app you use, then copy the settings.
Passed 3/3 checks · Runs on your computer
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude, with some setup first
You need a Blockrun MCP key (sign up on the maker’s site, may cost money) · Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
Install Node.js
One time only; it works for every server that needs Node.js
Sign up and create a Blockrun MCP key
Open the maker’s site, sign up and create an API key for the next step. It may cost money.
How to get a key is in the maker’s README below
Open the Claude desktop app’s settings file
SettingsDeveloperEdit Config
Paste these settings and save the file
{ "mcpServers": { "blockrun": { "command": "npx", "args": [ "-y", "@blockrun/mcp" ], "env": { "BLOCKRUN_WALLET_KEY": "your-value", "SOLANA_WALLET_KEY": "your-value", "BLOCKRUN_API_KEY": "your-value" } } } }Paste the key only into the app’s field, never into a chat or to anyone
Quit Claude and open it again
Try it
Use Blockrun MCP and tell me what you can do for me, then show me one thing✓ If Claude says it is using Blockrun MCP or shows a Blockrun MCP tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect Blockrun MCP yet
Blockrun MCP runs on your computer, but ChatGPT can only connect servers that run on the web
What you can do instead
A · Use an app that can connect Blockrun MCP
- You need a Blockrun MCP key (sign up on the maker’s site, may cost money) · Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
- You need a Blockrun MCP key (sign up on the maker’s site, may cost money) · Install Node.js on your computer first (one time)
- You need a Blockrun MCP key (sign up on the maker’s site, may cost money) · Install Node.js on your computer first (one time)
- You need a Blockrun MCP key (sign up on the maker’s site, may cost money) · Install Node.js on your computer first (one time)
B · Others in Search & AI memory that work with ChatGPT
Picked from the most used in the same category, only ones that connect by address with no key
- AIHOT✓ ChatGPT
- Sui Knowledge Base (kapa.ai)✓ ChatGPT
- Exa✓ ChatGPT
Works with Claude Code, with some setup first
You need a Blockrun MCP key (sign up on the maker’s site, may cost money) · Install Node.js on your computer first (one time)
Install Node.js
One time only; it works for every server that needs Node.js
Sign up and create a Blockrun MCP key
Open the maker’s site, sign up and create an API key for the next step. It may cost money.
How to get a key is in the maker’s README below
Open Terminal
Mac: press Command+Space and type Terminal · Windows: open PowerShell
Paste this command and press Enter
claude mcp add blockrun --env BLOCKRUN_WALLET_KEY=your-value --env SOLANA_WALLET_KEY=your-value --env BLOCKRUN_API_KEY=your-value -- npx -y @blockrun/mcpReplace “your-value” with your key before pressing Enter
Paste the key only into the app’s field, never into a chat or to anyone
Type /mcp in Claude Code
You should see Blockrun MCP listed as connected
Try it
Use Blockrun MCP and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using Blockrun MCP or shows a Blockrun MCP tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor, with some setup first
You need a Blockrun MCP key (sign up on the maker’s site, may cost money) · Install Node.js on your computer first (one time)
Install Node.js
One time only; it works for every server that needs Node.js
Sign up and create a Blockrun MCP key
Open the maker’s site, sign up and create an API key for the next step. It may cost money.
How to get a key is in the maker’s README below
Fill in your key
In the Blockrun MCP settings, BLOCKRUN_WALLET_KEY, SOLANA_WALLET_KEY, BLOCKRUN_API_KEY is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Open the AI chat in Cursor in Agent mode
Try it
Use Blockrun MCP and tell me what you can do for me, then show me one thing✓ If Cursor says it is using Blockrun MCP or shows a Blockrun MCP tool in the answer, you are connected
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code, with some setup first
You need a Blockrun MCP key (sign up on the maker’s site, may cost money) · Install Node.js on your computer first (one time)
Install Node.js
One time only; it works for every server that needs Node.js
Sign up and create a Blockrun MCP key
Open the maker’s site, sign up and create an API key for the next step. It may cost money.
How to get a key is in the maker’s README below
Fill in your key
In the Blockrun MCP settings, BLOCKRUN_WALLET_KEY, SOLANA_WALLET_KEY, BLOCKRUN_API_KEY is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Open the AI chat in VS Code in Agent mode
Try it
Use Blockrun MCP and tell me what you can do for me, then show me one thing✓ If VS Code says it is using Blockrun MCP or shows a Blockrun MCP tool in the answer, you are connected
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.
JSON settings are under “For developers” below
For developers: Terminal commands and JSON settings
Installed on your computer
Claude Code
claude mcp add blockrun --env BLOCKRUN_WALLET_KEY=your-value --env SOLANA_WALLET_KEY=your-value --env BLOCKRUN_API_KEY=your-value -- npx -y @blockrun/mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"blockrun": {
"command": "npx",
"args": [
"-y",
"@blockrun/mcp"
],
"env": {
"BLOCKRUN_WALLET_KEY": "your-value",
"SOLANA_WALLET_KEY": "your-value",
"BLOCKRUN_API_KEY": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"blockrun": {
"command": "npx",
"args": [
"-y",
"@blockrun/mcp"
],
"env": {
"BLOCKRUN_WALLET_KEY": "your-value",
"SOLANA_WALLET_KEY": "your-value",
"BLOCKRUN_API_KEY": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"blockrun": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@blockrun/mcp"
],
"env": {
"BLOCKRUN_WALLET_KEY": "your-value",
"SOLANA_WALLET_KEY": "your-value",
"BLOCKRUN_API_KEY": "your-value"
}
}
}
}Values you fill in
BLOCKRUN_WALLET_KEYsecret envOptional: 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 envOptional: 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 envOptional: BlockRun account API key; bills your prepaid balance instead of a wallet (no per-call network fee). Takes priority over a wallet when set.
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
At a glance
Which apps can use it
Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Related guides
What it can do
Runs on your computer; the tool list appears in your AI app after you install it.
Basic checksi
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 12, 2026
- ✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account BlockRunAI, which owns the repo
- ✓ Pass
Still maintained
Code last changed 2 days ago
- ✓ Pass
Has a licence
Uses MIT
- – Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
- – Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
- … Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints
Discussion
Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
User reviews
No reviews yet
Compared with others in Search & AI memoryi
- More stars than 99% of the other 5962 servers in this category
- Published to the registry more recently than 94% of the other 5962 servers in this category
- Basic checks equal to or better than 100% of the other 5962 servers in this category
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
Common questions
Is Blockrun MCP safe?
It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
What keys or codes does it need?
You need to fill in: BLOCKRUN_WALLET_KEY, SOLANA_WALLET_KEY, BLOCKRUN_API_KEY
Does it run on my computer or in the cloud?
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
Is it still maintained?
The GitHub repo last changed 2 days ago, and the latest version (0.55.8) reached the registry 2 days ago.
Which apps can use it?
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.
What can I use instead?
In the same category: Ruflo, Context7, Metabase
Alternatives
Servers in the same category from other makers, sorted by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
README from the maker
Open the README
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
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.
claude mcp add blockrun -s user -- npx -y @blockrun/mcp@latest
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: 90 LLMs, image & video generation, prediction-market data, live web + news 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, Base or Arc. 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, cryptoblockrun_price,blockrun_models) costs $0. - **Reads *and* acts** — most tools deliver data;
blockrun_polymarketplaces real, confirm-gated trades. - Human-in-the-loop payments — turn on
BLOCKRUN_CONFIRM_SPEND=onand 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 intoBLOCKRUN_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) |
| Generative UI | — | Rare | Order card + wallet panel (MCP Apps) |
| Open source | Varies | Varies | Yes (MIT) |
✓ One wallet or one account key · ✓ Pay-per-call · ✓ Reads and trades · ✓ Multi-chain · ✓ Agent-ready · ✓ Open source
What changes
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 can place the trade, not just read the odds.
After BlockRun, it can. Each query costs fractions of a cent — billed from a local USDC wallet, or from card-funded credit on a BlockRun account through api.blockrun.ai. No subscriptions, no per-vendor signups.
Quick Start
0. Choose how you pay
| Wallet *(default)* | API key | |
|---|---|---|
| Setup | Nothing — a wallet is created on first run | Sign in at user.blockrun.ai, mint a key, use it against api.blockrun.ai |
| Funding | Send USDC (Solana, Base or Arc) | Credit card / wire → account credit |
| Billing | Per call, settled on-chain, + $0.001 network fee | Exact-usage account credit, no per-call network fee, no minimum |
| Identity | A keypair on your machine | An account with members, credits, and a usage ledger |
| Best for | Agents, solo devs, anything self-custody | Teams, companies, anyone who can't run a wallet |
| Trade on Polymarket | ✅ | ❌ — needs a keypair to sign |
Both modes reach the same 19 tools. Account mode sends service calls to https://api.blockrun.ai by default. You can switch at any time; setting BLOCKRUN_API_KEY takes priority over a wallet, and unsetting it hands the wallet back.
1. Install
Claude Code (recommended)
claude mcp add blockrun -s user -- npx -y @blockrun/mcp@latest
-s user installs globally (available in every project). The -- separator ensures -y is passed to npx, not parsed by claude mcp add.
💡 Homebrew / nvm users: if the server doesn't connect, Claude Code likely can't find
node/npxon its launcher PATH. Pass your shell PATH through — works on CLI and desktop:
`bash
claude mcp add blockrun -s user -e PATH="$PATH" -- npx -y @blockrun/mcp@latest
`
See Troubleshooting if it persists.
Every MCP client — one command or one JSON block. *Verified* = we ran the published package on that client and saw the tools listed (client version · date). *Documented* = install path from the client's own docs; not run by us yet — tell us if it works. The Spend dialog column is whether the client renders the human-in-the-loop payment prompt; on ❌ clients paid calls proceed without asking and BLOCKRUN_BUDGET_LIMIT is the guard.
| Client | Status | Spend dialog | Install |
|---|
| Claude Code | ✅ Verified · 2.1.251