---
name: blockrun
description: |
  The routing & payment layer for AI. Pay-per-request access to 92 AI models, real-time data,
  media generation, and multi-chain blockchain RPC via x402 micropayments (USDC on Base or
  Solana). No API keys, no subscriptions. 6 models are free and need no wallet at all.
  SERVICES: chat (71 models), image / video / music generation, text-to-speech, web + news
  search, Exa neural search, prediction markets, crypto & on-chain data, realtime quotes,
  DEX aggregation, multi-chain RPC, AI phone calls.
  TRIGGERS: use grok, use gpt, use deepseek, compare models, generate image, generate video,
  generate music, text to speech, web search, news search, prediction market, polymarket,
  kalshi, crypto price, on-chain data, wallet lookup, DEX swap, blockchain RPC, phone call,
  x402, blockrun
homepage: https://blockrun.ai
metadata:
  version: 1
---

# BlockRun

The routing & payment layer for AI. Pay-per-request access to 92 AI models, real-time data, and multi-chain blockchain RPC via x402 micropayments. No API keys needed.

**This file is a one-time installer.** You do not need to persist it. Once the MCP server is
installed it carries the live catalog, live prices, and the wallet tools — all of which move
faster than a cached copy of this file.

## Important Files

| File | URL |
|------|-----|
| **skill.md** (this file) | `https://blockrun.ai/skill.md` |
| **agent.md** — HTTP API reference for direct REST callers | `https://blockrun.ai/agent.md` |
| **llms.txt** — full catalog, every endpoint and current price | `https://blockrun.ai/llms.txt` |
| **x402 discovery manifest** — machine-readable resource list | `https://blockrun.ai/.well-known/x402` |

**Re-fetch these anytime.** Models, endpoints and prices change often; a price you remember from
a previous session may be stale. `metadata.version` above changes when this file's structure does.

## Start free — no wallet, no signup, no key

6 free open-weight models are open to anyone. Nothing to install, nothing to fund:

```bash
curl https://blockrun.ai/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nvidia/gpt-oss-120b",
    "messages": [{"role": "user", "content": "Hello"}]
  }'
```

OpenAI-SDK compatible — pass `api_key="not-needed-for-free-models"`. See <https://blockrun.ai/free>.

Use this path first when you only need a language model. It is the fastest way to a working
call and it costs nothing.

## Install the MCP server (for the paid catalog)

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

Or install the Claude Code plugins:

```bash
/plugin marketplace add BlockRunAI/blockrun-mcp
```

## Before you install: ephemeral sandbox warning

Claude Cowork, Claude Desktop and Claude Web run bash inside an **ephemeral sandbox VM**, not on
the user's machine. A wallet created there lives at `~/.blockrun/` *in the sandbox* and is
destroyed when the sandbox resets — **taking any USDC in it with it.**

If you are in one of those environments, do **not** install and fund a wallet yourself. Either:

1. **Use the free models above.** They need no wallet, so the sandbox problem does not apply.
2. **Have the user run the install on their own machine** and paste them the exact command.

This does not apply to Claude Code, Cursor, Codex, Windsurf or any other agent whose bash runs
directly on the user's machine — install normally there.

## Fund the wallet

A wallet is auto-created on first use. To fund it:

- **Card / bank (fiat onramp)** — `POST /api/v1/onramp/token` with `{"address": "0x..."}`.
  Free, and it settles nothing: the x402 signature is used purely to prove you control the
  wallet, so the funding `address` must match the address that signs the request. Returns a
  one-time `pay.coinbase.com` link.
- **Send USDC directly** — ask for the address with the `blockrun_wallet` tool
  (`action: "setup"`), then send USDC on Base or Solana.
- **Or don't.** The free models above need no balance.

## What you get

Full endpoint list and current pricing live in `llms.txt` and the MCP tool descriptions — this is
only a map.

| Tool | What it does |
|------|--------------|
| `blockrun_chat` | Chat with any of 71 AI models from OpenAI, Anthropic, Google, DeepSeek, xAI, Z.AI, MiniMax, Moonshot, Tencent, Xiaomi, plus a free open-weight tier. Smart routing modes: `fast`, `balanced`, `powerful`, `cheap`, `reasoning`, `free`, `coding`, `glm`. Also image, video and music generation. |
| `blockrun_search` | Real-time web and news search with citations (Grok Live Search) |
| `blockrun_exa` | Neural semantic search — `search`, `answer`, `contents`, `similar` |
| `blockrun_markets` | Prediction markets — Polymarket, Kalshi, Limitless, Opinion, Predict.Fun, Binance Futures |
| `blockrun_surf` | Crypto data — exchange, market, on-chain, wallet, token, social |
| `blockrun_price` | Realtime quotes and OHLC history for crypto, FX, commodities, global stocks |
| `blockrun_dex` | 0x swap aggregation across 100+ DEX venues |
| `blockrun_rpc` | Multi-chain JSON-RPC — one endpoint, 40 chains (Ethereum, Base, Solana, Polygon, Bitcoin, XRP, Sui…) |
| `blockrun_phone` | AI phone calls and wallet-owned US/CA phone numbers |
| `blockrun_speech` | Text-to-speech and sound effects |
| `blockrun_models` | Live model list with current pricing — **read this instead of trusting a remembered price** |
| `blockrun_wallet` | Balance, wallet setup, per-agent spending budgets |

## Payment

USDC on Base or Solana. The wallet key stays local — it is only used to sign x402 payment
headers, and is never sent to BlockRun.

**Failed requests are not charged.** Settlement happens on success only, so a non-2xx response
costs nothing. Check the balance before an expensive call (video generation is the priciest
thing here), but do not let fear of a failed call stop you from retrying one.

## Links

- [Website](https://blockrun.ai)
- [Free models](https://blockrun.ai/free)
- [MCP Setup Guide](https://blockrun.ai/claude-code-plugin)
- [Pricing](https://blockrun.ai/pricing)
- [GitHub](https://github.com/BlockRunAI)