Claude Code Users

Get started with BlockRun in 60 seconds. Give your Claude agent superpowers.

In a hurry?

The whole setup is three steps below — install, fund, go. No API keys, no subscription, no signup: the wallet is created for you on first run.

Install, fund, and go

Install the MCP

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

That's it. Restart Claude Code and the MCP server is available. Needs Node.js ≥ 20.19.

Homebrew or nvm user and the server won't connect? Pass your shell PATH through: claude mcp add blockrun -s user -e PATH="$PATH" -- npx -y @blockrun/mcp@latest.

See your wallet

A wallet was created automatically at ~/.blockrun/.session when the server first started. In Claude Code, say:

Set up my BlockRun wallet

Claude calls blockrun_wallet action:"setup" and will:

Show you your wallet address (creating one if it's somehow missing)
Print a funding QR code
Explain how to fund it

Fund your wallet

Send USDC to your wallet address on Base network:

Recommended: $5-20 for regular usage
Minimum: $1 to get started

Get USDC on Base:

Coinbase - Send → USDC → Base network → paste address
Base Bridge - bridge from Ethereum
Uniswap - swap on Base
Card: ask Claude to run blockrun_wallet action:"deposit" — it opens a one-time Coinbase Onramp link that settles into your own wallet

Prefer Solana?

The MCP holds a Solana wallet too. Switch with two tool calls — no env vars, no file editing, no restart:

blockrun_wallet action:"chain" chain:"solana"
blockrun_wallet action:"setup"

Then send USDC (SPL) on the Solana network (Coinbase → pick "Solana", or Phantom/Solflare/Backpack). Switch back with blockrun_wallet action:"chain" chain:"base".

Music, speech, the Modal sandbox, DeFi data, paid RealFace, paid stock prices, and native Anthropic (claude-*) settle on Base only. Image and video generation pay on either chain.

What You Can Do Now

Try it for free first

blockrun_chat mode:"free" message:"Draft a commit message for this diff"

The free tier costs $0 and needs no funded wallet — a good smoke test before you send USDC. DEX data, crypto/FX/commodity prices, and the model list are free too.

Access Other AI Models

Use GPT-5.5 to get a second opinion on this code

Ask Kimi K3 to review this function

Claude routes to the model you name — or picks one by intent with mode:"fast" / "balanced" / "powerful" / "cheap" / "reasoning" / "coding" / "glm" — and pays via x402. Run blockrun_models for the live list with pricing.

Image Generation

Generate a logo for a crypto trading bot

Claude calls blockrun_image — models include google/nano-banana, google/nano-banana-pro, openai/gpt-image-2, xai/grok-imagine-image, zai/cogview-4, and bytedance/seedream-5-pro; edits (img2img, inpaint, fusion) too. ~$0.015-0.15 per image. Install the image-prompting skill for text-accurate prompts (see Skills).

Video, Music, and Speech

Generate a 5-second video of a sunset over Tokyo
Compose a 60-second lo-fi hip-hop loop
Speak this paragraph with the sarah voice

blockrun_video and blockrun_music are async and payment-on-completion — if a job fails or times out you are not charged.

Live Web and X Search

What are people saying about @sama on X right now?
Find me the top 5 papers on speculative decoding from the last 90 days

blockrun_search covers live web, X/Twitter, and news with citations; blockrun_exa does neural research, cited answers, and page reading.

Prediction Markets — read and trade

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

blockrun_markets reads odds across Polymarket, Kalshi and more. blockrun_polymarket places real, USDC-settled orders from a gasless deposit wallet — every order requires your explicit confirmation and is capped per order (default $25). See Polymarket funding.

Crypto and On-chain Data

What's this wallet labeled, and what does it hold?
Top 10 tokens by DEX volume on Base, last 24h
Call eth_getBalance on Arbitrum for 0x...

blockrun_price (Pyth-backed quotes), blockrun_dex, blockrun_defi (TVL, yields), and blockrun_rpc (raw JSON-RPC on 40 chains). The crypto-data skill says which one to use.

Phone Calls and Sandboxed Compute

Call +1-415-555-0100 and confirm Friday at 3pm
Run this benchmark on an H100 in a disposable sandbox

blockrun_phone makes outbound AI voice calls and leases US/CA numbers to your wallet; blockrun_modal runs code in an isolated container with optional GPU.

Trading (Franklin)

Trading — live signals, paper trading with hard exposure caps, Polymarket bets, and a trade-plan gate that keeps real money behind your approval — is built into the Franklin agent. There is no separate trading MCP to install:

npm install -g @blockrun/franklin
franklin setup

Then, in a Franklin session:

what's BTC looking like today?

See Trading Overview for full details.

Check Your Balance

blockrun_wallet

What's my BlockRun wallet balance?

Shows both wallet addresses, USDC balances, the active chain, and what this session has spent.

Spend Controls

Session cap: blockrun_wallet action:"budget" budget_action:"set" budget_amount:5.00 (or BLOCKRUN_BUDGET_LIMIT=5 in the environment)
Sub-agent budgets: blockrun_wallet action:"delegate" agent_id:"researcher" agent_limit:2.00, then pass agent_id:"researcher" on every downstream call — the agent is hard-stopped at zero
Confirm before every paid call: install the blockrun-media plugin, which adds a spend-confirmation prompt, a per-call receipt, and a status-line balance meter:

/plugin marketplace add BlockRunAI/blockrun-claude-plugin
/plugin install blockrun-media@blockrun

Codex users get the same via blockrun-codex-plugin.

Available Skills

BlockRun ships prompt-based skills that teach Claude how to use each tool family. Add the marketplace once, then install what you need:

/plugin marketplace add BlockRunAI/blockrun-mcp
/plugin install blockrun@blockrun-mcp

Skill	What It Does
`blockrun`	Start here — which tool answers what, and how to make a first call free
`image-prompting`	Turns a vague image request into a text-accurate prompt
`search`, `exa-research`	Live search and cited research workflows
`crypto-data`, `rpc`	Routes crypto questions to the right (often free) tool
`prediction-markets`, `polymarket-trading`	Read odds, then place confirm-gated bets
`phone`, `modal`	Voice calls and sandboxed compute

Full list in Skills. Trading is built into Franklin rather than shipped as a skill or a separate MCP server.

Pricing

Intelligence: Provider cost, no platform margin on chat tokens, plus $0.001 per request (no subscriptions)
Images: $0.015-0.15 per image
Free tier: mode:"free" chat, DEX data, crypto/FX/commodity prices, model list, Polymarket reads — $0
Trading tools: Built into Franklin, free and open source — you pay only for the data they buy

$1 gets you approximately:

~500 GPT-5.4 calls
~10,000 DeepSeek calls
~20–65 image generations

Security

Your private key stays on your machine (~/.blockrun/.session, mode 0600; optionally the OS keychain with BLOCKRUN_KEYCHAIN=strict)
Only cryptographic signatures are sent to servers
All payments are verifiable on Basescan (or Solscan on Solana)
You control your wallet — withdraw anytime
Back up ~/.blockrun/.session: it is the only key to both the payment wallet and the Polymarket deposit wallet

Troubleshooting

MCP not loading?

Restart Claude Code after installation:

# Check if MCP is registered
claude mcp list

spawn npx ENOENT? Reinstall with -e PATH="$PATH" (see step 1).

Wallet not found?

# Check wallet location
ls -la ~/.blockrun/

Then blockrun_wallet action:"setup" to (re)create and print the address.

Transaction failed / 402?

Check your USDC balance on the active chain:

blockrun_wallet

For more help, see MCP Troubleshooting.

What's next?

Browse the MCP tools

The full list of 19 blockrun_* tools — chat, image, video, search, markets, Polymarket trading, RPC, and more.

Generate images

Create images via micropayments with blockrun_image.

Explore all models

78 LLMs with live pricing, plus smart routing to cut costs automatically.