Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ description: BlockRun is the routing and payment layer for AI agents — one end

**Agents that pay, spend, and trade.**

BlockRun is economic infrastructure for the agent era. AI agents discover services, pay in USDC over the [x402 protocol](x402/how-it-works.md), and execute autonomously — **no API keys, no subscriptions, no credit card.** One funded wallet unlocks 88 LLMs, media generation, real-time data, and on-chain execution.
BlockRun is economic infrastructure for the agent era. AI agents discover services, pay in USDC over the [x402 protocol](x402/how-it-works.md), and execute autonomously — **no API keys, no subscriptions, no credit card.** One funded wallet unlocks 89 LLMs, media generation, real-time data, and on-chain execution.

:::tip{title="In a hurry?"}
Jump to the [5-Minute Quickstart](getting-started/quickstart.md) and make your first paid call.
Expand Down Expand Up @@ -38,7 +38,7 @@ Pick the path that matches how you work.
::::cards

:::card{title="I want an autonomous agent" href="products/franklin.md" icon="Rocket"}
Franklin — the AI agent with a wallet. Writes code and spends USDC across 88 models and paid APIs. Free to start.
Franklin — the AI agent with a wallet. Writes code and spends USDC across 89 models and paid APIs. Free to start.
:::

:::card{title="I use Claude Code / Cursor" href="getting-started/quickstart.md" icon="Terminal"}
Expand All @@ -62,7 +62,7 @@ Four product families, one payment layer.
::::cards

:::card{title="Intelligence" href="products/intelligence/overview.md" icon="Brain"}
88 LLMs (GPT, Claude, Gemini, DeepSeek, Grok, Kimi, Llama) through one OpenAI-compatible API. Pay per request.
89 LLMs (GPT, Claude, Gemini, DeepSeek, Grok, Kimi, Llama) through one OpenAI-compatible API. Pay per request.
:::

:::card{title="Routing" href="products/routing/clawrouter.md" icon="Route"}
Expand Down
4 changes: 2 additions & 2 deletions docs/api-reference/chat-completions.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Chat Completions
description: OpenAI-compatible Chat Completions endpoint for 88 LLMs, paid per request in USDC over x402 — no API keys, no subscriptions.
description: OpenAI-compatible Chat Completions endpoint for 89 LLMs, paid per request in USDC over x402 — no API keys, no subscriptions.
---

# Chat Completions
Expand Down Expand Up @@ -369,7 +369,7 @@ console.log(result.choices[0].message.content);
::::cards

:::card{title="Browse all models" href="models.md" icon="Brain"}
88 chat models with live pricing — pick the right model and ID for your call.
89 chat models with live pricing — pick the right model and ID for your call.
:::

:::card{title="Error handling" href="errors.md" icon="Code"}
Expand Down
2 changes: 1 addition & 1 deletion docs/api-reference/exa-search.md
Original file line number Diff line number Diff line change
Expand Up @@ -393,7 +393,7 @@ Real-time web and news search via Grok Live Search.
:::

:::card{title="Chat Completions" href="chat-completions.md" icon="Brain"}
Feed grounded search results into any of 88 LLMs for synthesis.
Feed grounded search results into any of 89 LLMs for synthesis.
:::

:::card{title="Error handling" href="errors.md" icon="Code"}
Expand Down
7 changes: 4 additions & 3 deletions docs/api-reference/models.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ Only models that are currently available are returned — there is no `available
## Available Models (chat / image / video / music / speech / sound effects)

:::note
**88 chat / LLM models** are publicly listed on mainnet, plus **12 image**, **8 video**, **1 music**, **5 text-to-speech**, and **1 sound-effects** model — covering chat, image, video, music, speech, and sound-effects generation from one API. Additional deprecated / superseded LLM IDs remain routable for backwards compatibility but are hidden from the catalog. Call `GET /api/v1/models` for the exact live list.
**89 chat / LLM models** are publicly listed on mainnet, plus **12 image**, **8 video**, **1 music**, **5 text-to-speech**, and **1 sound-effects** model — covering chat, image, video, music, speech, and sound-effects generation from one API. Additional deprecated / superseded LLM IDs remain routable for backwards compatibility but are hidden from the catalog. Call `GET /api/v1/models` for the exact live list.
:::

All prices shown are provider rates — and, for per-token chat, also the billed rates: BlockRun adds **no platform margin** on chat tokens, only the flat $0.001/request transaction fee. Media and Live Search still carry a 5% platform fee.
Expand Down Expand Up @@ -201,8 +201,9 @@ Grok bills a **long-context tier** at 2x the rates above once a request's prompt
|----------|------|-------------|--------------|---------|
| `deepseek/deepseek-v4-pro` | DeepSeek V4 Pro | $1.32/M | $3.96/M | 1M |
| `deepseek/deepseek-v4-flash-vision-exp` | DeepSeek V4 Flash Vision (image input) | $0.30/M | $1.20/M | 1M |
| `deepseek/deepseek-chat` | DeepSeek V4 Flash Chat | $0.14/M | $0.28/M | 1M |
| `deepseek/deepseek-reasoner` | DeepSeek V4 Flash Reasoner | $0.14/M | $0.28/M | 1M |
| `deepseek/deepseek-v4.1-flash` | DeepSeek V4.1 Flash (non-thinking) | $0.14/M | $0.28/M | 1M |
| `deepseek/deepseek-chat` | DeepSeek Chat (V4.1 Flash) — compatibility id, same model as `deepseek/deepseek-v4.1-flash` | $0.14/M | $0.28/M | 1M |
| `deepseek/deepseek-reasoner` | DeepSeek Reasoner (V4.1 Flash) — same model with thinking on | $0.14/M | $0.28/M | 1M |

### Z.AI

Expand Down
4 changes: 2 additions & 2 deletions docs/frameworks/agentkit.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: AgentKit Integration
description: Pair Coinbase AgentKit with BlockRun so your agents both hold on-chain assets and pay per request for 115 AI models.
description: Pair Coinbase AgentKit with BlockRun so your agents both hold on-chain assets and pay per request for 116 AI models.
---

# AgentKit Integration
Expand All @@ -21,7 +21,7 @@ AgentKit provides:
- Framework extensions (`coinbase-agentkit-langchain`, …)

BlockRun adds:
- 88 chat models (115 in the full catalog)
- 89 chat models (116 in the full catalog)
- Pay-per-request intelligence
- No API key management

Expand Down
6 changes: 3 additions & 3 deletions docs/frameworks/elizaos.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,17 @@
---
title: ElizaOS Integration
description: Add the BlockRun plugin to ElizaOS so your agents reach 115 AI models via x402 micropayments — no per-provider API keys.
description: Add the BlockRun plugin to ElizaOS so your agents reach 116 AI models via x402 micropayments — no per-provider API keys.
---

# ElizaOS Integration

Use BlockRun as an LLM provider in ElizaOS agents — one plugin unlocks 88 models paid per request over x402.
Use BlockRun as an LLM provider in ElizaOS agents — one plugin unlocks 89 models paid per request over x402.

:::note{title="Community integration"}
BlockRun's primary paths are [Franklin](../products/franklin.md), the [BlockRun MCP](../mcp/blockrun-mcp.md), and the [SDKs](../sdks/python.md). Framework integrations like this one are community-maintained.
:::

[ElizaOS](https://github.com/elizaOS/eliza) is an open-source agent framework. The BlockRun plugin gives your ElizaOS agents access to 115 AI models via x402 micropayments.
[ElizaOS](https://github.com/elizaOS/eliza) is an open-source agent framework. The BlockRun plugin gives your ElizaOS agents access to 116 AI models via x402 micropayments.

## Setup

Expand Down
6 changes: 3 additions & 3 deletions docs/frameworks/goat.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
---
title: GOAT SDK Integration
description: Combine GOAT SDK's cross-chain execution with BlockRun's 115 AI models, paid per request over x402 — until the official plugin ships.
description: Combine GOAT SDK's cross-chain execution with BlockRun's 116 AI models, paid per request over x402 — until the official plugin ships.
---

# GOAT SDK Integration

Use BlockRun with [GOAT SDK](https://github.com/crossmint/goat) (Great Onchain Agent Toolkit) for cross-chain AI agents. GOAT handles blockchain interactions, BlockRun provides AI intelligence via 88 models with x402 micropayments.
Use BlockRun with [GOAT SDK](https://github.com/crossmint/goat) (Great Onchain Agent Toolkit) for cross-chain AI agents. GOAT handles blockchain interactions, BlockRun provides AI intelligence via 89 models with x402 micropayments.

:::note{title="Community integration — pre-release"}
No official `@goat-sdk/plugin-blockrun` yet; use BlockRun alongside GOAT via the [TypeScript SDK](../sdks/typescript.md) as shown below. BlockRun's primary paths are [Franklin](../products/franklin.md), the [MCP](../mcp/blockrun-mcp.md), and the SDKs.
Expand Down Expand Up @@ -129,7 +129,7 @@ const { text } = await generateText({
| GOAT Provides | BlockRun Adds |
|---------------|---------------|
| Cross-chain execution | AI decision making |
| Protocol integrations | 88 chat models (115 total) |
| Protocol integrations | 89 chat models (116 total) |
| Wallet management | Pay-per-request AI |
| Transaction building | No API key hassle |

Expand Down
2 changes: 1 addition & 1 deletion docs/frameworks/langchain.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: LangChain Integration
description: Wrap BlockRun in a custom LangChain LLM class that handles x402 payments automatically — chains, agents, and RAG over 88 models.
description: Wrap BlockRun in a custom LangChain LLM class that handles x402 payments automatically — chains, agents, and RAG over 89 models.
---

# LangChain Integration
Expand Down
4 changes: 2 additions & 2 deletions docs/getting-started/agent-developers.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
---
title: Agent Developers
description: Build AI agents that pay for their own intelligence — 88 models via x402 micropayments. Use Franklin, the SDKs or the MCP, or the framework you already use.
description: Build AI agents that pay for their own intelligence — 89 models via x402 micropayments. Use Franklin, the SDKs or the MCP, or the framework you already use.
---

# Agent Developers

Build AI agents that pay for their own intelligence.

This guide is for agent developers. The primary paths are **[Franklin](../products/franklin.md)** (our autonomous agent), the **[SDKs](../sdks/python.md)**, and the **[BlockRun MCP](../mcp/blockrun-mcp.md)** — all on one wallet, 88 models via x402 micropayments. Already using a framework (ElizaOS, AgentKit, GOAT, LangChain)? See [Community integrations](../frameworks/elizaos.md).
This guide is for agent developers. The primary paths are **[Franklin](../products/franklin.md)** (our autonomous agent), the **[SDKs](../sdks/python.md)**, and the **[BlockRun MCP](../mcp/blockrun-mcp.md)** — all on one wallet, 89 models via x402 micropayments. Already using a framework (ElizaOS, AgentKit, GOAT, LangChain)? See [Community integrations](../frameworks/elizaos.md).

:::tip{title="Fastest path: Franklin"}
Want an agent that already spends autonomously? [Franklin](../products/franklin.md) is one install (`npm install -g @blockrun/franklin`) and runs free out of the box — fund a wallet to unlock everything.
Expand Down
4 changes: 2 additions & 2 deletions docs/getting-started/claude-code.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Claude Code Users
description: Install BlockRun MCP in Claude Code, fund a wallet with USDC on Base or Solana, and give your agent 88 models, images, and live data.
description: Install BlockRun MCP in Claude Code, fund a wallet with USDC on Base or Solana, and give your agent 89 models, images, and live data.
---

# Claude Code Users
Expand Down Expand Up @@ -273,7 +273,7 @@ Create images via micropayments with `blockrun_image`.
:::

:::card{title="Explore all models" href="../products/intelligence/overview.md" icon="Brain"}
88 LLMs with live pricing, plus smart routing to cut costs automatically.
89 LLMs with live pricing, plus smart routing to cut costs automatically.
:::

::::
2 changes: 1 addition & 1 deletion docs/getting-started/quickstart.md
Original file line number Diff line number Diff line change
Expand Up @@ -108,7 +108,7 @@ The full list of 19 `blockrun_*` tools — chat, image, video, search, markets,
:::

:::card{title="Explore the models" href="../products/intelligence/overview.md" icon="Brain"}
88 LLMs with live pricing, plus smart routing to cut costs automatically.
89 LLMs with live pricing, plus smart routing to cut costs automatically.
:::

:::card{title="How payment works" href="../x402/how-it-works.md" icon="Zap"}
Expand Down
4 changes: 2 additions & 2 deletions docs/mcp/blockrun-mcp.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
---
title: BlockRun MCP
description: A Model Context Protocol server that gives Claude Code 88 models, crypto data, voice calls, media generation, and prediction markets with zero API keys.
description: A Model Context Protocol server that gives Claude Code 89 models, crypto data, voice calls, media generation, and prediction markets with zero API keys.
---

# BlockRun MCP

Give Claude Code access to 115 AI models, 66 crypto data endpoints, voice calls, image/video/music generation, prediction markets (read *and* trade), multi-chain RPC, and a sandbox runtime — all with zero API keys.
Give Claude Code access to 116 AI models, 66 crypto data endpoints, voice calls, image/video/music generation, prediction markets (read *and* trade), multi-chain RPC, and a sandbox runtime — all with zero API keys.

BlockRun MCP is a Model Context Protocol server that connects Claude Code to BlockRun's intelligence, trading, and creation capabilities.

Expand Down
4 changes: 2 additions & 2 deletions docs/products/franklin.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Franklin Agent
description: Franklin is the AI agent with a wallet. It writes code and spends USDC autonomously across 88 models and paid APIs, settling per outcome over x402. No API keys.
description: Franklin is the AI agent with a wallet. It writes code and spends USDC autonomously across 89 models and paid APIs, settling per outcome over x402. No API keys.
---

# Franklin Agent
Expand Down Expand Up @@ -116,7 +116,7 @@ Inside a session: `/model`, `/plan` / `/execute`, `/ultrathink`, `/compact`, `/c

Franklin is the autonomous agent on top of the BlockRun stack — it uses the same pieces you can use directly:

- **Models & routing** — picks the best model per task via [ClawRouter](routing/clawrouter.md)'s scoring, across 88 chat models. Four profiles: `auto`, `eco`, `premium`, `free`.
- **Models & routing** — picks the best model per task via [ClawRouter](routing/clawrouter.md)'s scoring, across 89 chat models. Four profiles: `auto`, `eco`, `premium`, `free`.
- **Paid APIs** — search, market data, media, RPC, prediction markets and more, paid per call over [x402](../x402/how-it-works.md).
- **One wallet** — the wallet is the identity; fund it on Solana or Base ([Wallet Setup](../getting-started/wallet-setup.md)).

Expand Down
7 changes: 4 additions & 3 deletions docs/products/intelligence/overview.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
---
title: Intelligence
description: BlockRun Intelligence gives your agent 88 LLMs through one OpenAI-compatible API, paid per request in USDC — no API keys, no subscriptions.
description: BlockRun Intelligence gives your agent 89 LLMs through one OpenAI-compatible API, paid per request in USDC — no API keys, no subscriptions.
---

# Intelligence

AI accesses any LLM. 88 models, pay-per-request.
AI accesses any LLM. 89 models, pay-per-request.

BlockRun's Intelligence product gives your AI agent access to models from OpenAI, Anthropic, Google, xAI, DeepSeek, Z.AI, Moonshot, MiniMax, and more — without managing API keys or subscriptions.

Expand Down Expand Up @@ -92,7 +92,8 @@ Provider rates per 1M tokens. Since 2026-08-07 these are also the BILLED rates
### DeepSeek
| Model | Input | Output |
|-------|-------|--------|
| DeepSeek V4 Flash Chat | $0.14/M | $0.28/M |
| DeepSeek V4.1 Flash | $0.14/M | $0.28/M |
| DeepSeek Chat / Reasoner (V4.1 Flash, compatibility ids) | $0.14/M | $0.28/M |
| DeepSeek V4 Pro | $1.32/M | $3.96/M |

### Free tier
Expand Down
9 changes: 5 additions & 4 deletions docs/products/intelligence/pricing.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ Media generation and Live Search still carry a 5% platform margin, which covers:
| Model | Approximate Usage |
|-------|------------------|
| GPT-5.5 | ~200K input tokens |
| DeepSeek V4 Flash Chat | ~7M input tokens |
| DeepSeek V4.1 Flash | ~7M input tokens |
| Gemini 3.5 Flash | ~635K input tokens |
| Image generation | ~10–65 images |
| **Free tier** (8 models — reasoning, coding, and vision) | **Unlimited (FREE)** |
Expand Down Expand Up @@ -157,8 +157,9 @@ Grok doubles the per-token rates above 200K prompt tokens (the whole request rep

| Model | Input (per 1M) | Output (per 1M) | Cached input (per 1M) |
|-------|----------------|-----------------|-----------------------|
| DeepSeek V4 Flash Chat | $0.14 | $0.28 | $0.028 |
| DeepSeek V4 Flash Reasoner | $0.14 | $0.28 | $0.028 |
| DeepSeek V4.1 Flash | $0.14 | $0.28 | $0.028 |
| DeepSeek Chat (V4.1 Flash, compatibility id) | $0.14 | $0.28 | $0.028 |
| DeepSeek Reasoner (V4.1 Flash, thinking on) | $0.14 | $0.28 | $0.028 |
| DeepSeek V4 Flash Vision (image input) | $0.30 | $1.20 | $0.006 |
| DeepSeek V4 Pro | $1.32 | $3.96 | $0.044 |

Expand Down Expand Up @@ -199,7 +200,7 @@ Other media: video from **$0.05/sec**, music **$0.15/track**, text-to-speech **$
| Anthropic Claude Sonnet 5.5 | $2.00/$10.00 | $2.00/$10.00 | 0% + $0.001/request |
| Anthropic Claude Sonnet 5 | $2.00/$10.00 | $2.00/$10.00 | 0% + $0.001/request |
| Anthropic Claude Sonnet 4.6 | $3.00/$15.00 | $3.00/$15.00 | 0% + $0.001/request |
| DeepSeek V4 Flash Chat | $0.14/$0.28 | $0.14/$0.28 | 0% + $0.001/request |
| DeepSeek V4.1 Flash | $0.14/$0.28 | $0.14/$0.28 | 0% + $0.001/request |

Chat is billed at the provider's list rate with no margin, plus a flat $0.001 transaction fee per request, and you get:
- No API key management
Expand Down
6 changes: 3 additions & 3 deletions docs/products/routing/clawrouter.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ description: ClawRouter is a smart LLM router for OpenClaw that picks the optima

**84% cheaper than pinning one flagship for every request — 98% on `eco`. Automatically.**

ClawRouter is a smart LLM router for OpenClaw that routes every request to the cheapest model that can handle it. One wallet, 88 models, zero API keys.
ClawRouter is a smart LLM router for OpenClaw that routes every request to the cheapest model that can handle it. One wallet, 89 models, zero API keys.

:::tip{title="In a hurry?"}
Install, fund a wallet, then run `/model blockrun/auto` in any OpenClaw conversation — that's it. Current release: **v0.12.253** (August 29, 2026).
Expand Down Expand Up @@ -228,7 +228,7 @@ Note the second row: the REASONING primary is Grok 4.1 Fast Reasoning, but the p
- No external API calls for routing decisions
- Full privacy - your prompts never leave your machine for routing

### 88 Models
### 89 Models

Access all major providers through one wallet:

Expand Down Expand Up @@ -585,7 +585,7 @@ No. AI model access requires internet. But routing decisions are made locally.
::::cards

:::card{title="View all models" href="../intelligence/overview.md" icon="Brain"}
88 LLMs across OpenAI, Anthropic, Google, xAI, DeepSeek, Z.AI, Moonshot, MiniMax, and the free tier.
89 LLMs across OpenAI, Anthropic, Google, xAI, DeepSeek, Z.AI, Moonshot, MiniMax, and the free tier.
:::

:::card{title="Check pricing" href="../intelligence/pricing.md" icon="Zap"}
Expand Down
2 changes: 1 addition & 1 deletion docs/resources/examples.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ Run any GPT-Image-2 or Seedance prompt as a one-liner — `/headshot`, `/dance`,
:::

:::card{title="lobster.cash skill" href="https://github.com/BlockRunAI/lobstercash-blockrun-skill" icon="Zap"}
BlockRun skill for the lobster.cash OpenClaw plugin — 88 models paid with Solana USDC.
BlockRun skill for the lobster.cash OpenClaw plugin — 89 models paid with Solana USDC.
:::

:::card{title="blockrun-claude-plugin" href="https://github.com/BlockRunAI/blockrun-claude-plugin" icon="Wallet"}
Expand Down
2 changes: 1 addition & 1 deletion docs/resources/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -121,7 +121,7 @@ Yes — a flat $0.001 transaction fee on every paid call, which covers on-chain

### Which AI models are available?

88 models including:
89 models including:
- OpenAI (GPT-6 Astra, GPT-6 Sol, GPT-6 Luna, GPT-5.6 Sol, GPT-5.5, GPT-5.4, GPT-5.4 Pro, GPT-5.2)
- Anthropic (Claude Fable 5.1, Opus 5.5, Opus 5, Opus 4.8, Sonnet 5.5, Sonnet 5, Sonnet 4.6, Haiku 4.5)
- Google (Gemini 3.1 Pro, Gemini 3.5 Flash)
Expand Down
Loading
Loading