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
2 changes: 1 addition & 1 deletion ECOSYSTEM.md
Original file line number Diff line number Diff line change
Expand Up @@ -201,7 +201,7 @@ BlockRun routes to these AI providers via x402:
| Qwen | Qwen3.8 Flash (1M context, image input), Qwen3.7 Max (Alibaba flagship), Qwen3.7 Plus, Qwen3.7 Flash | $0.03–$1.48 / $0.13–$4.43 |
| Tencent | Hy3 | $0.132 / $0.528 |
| Xiaomi | MiMo-V2.5, MiMo-V2.5 Pro | $0.14–$0.435 / $0.28–$0.87 |
| Free tier | Nemotron 3 Ultra 550B, Nemotron 3.5 Lightning, Nemotron 3 Nano 30B, Nemotron 3 Nano Omni (vision), Llama 3.2 11B Vision, Cohere North Mini Code, Poolside Laguna XS 2.1 (7 free models, keyless — no wallet needed) | **Free** |
| Free tier | Nemotron 3 Ultra 550B, Nemotron 3.5 Lightning, Nemotron 3 Nano 30B, Nemotron 3 Nano Omni (vision), Llama 3.2 11B Vision, Cohere North Mini Code, Poolside Laguna XS 2.1 (6 free models, keyless — no wallet needed) | **Free** |

### Image Models

Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -141,7 +141,7 @@ Real-time prediction market data powered by Predexon:
| **Qwen** | Qwen3.8 Flash (1M context, image input), Qwen3.7 Max (Alibaba flagship), Qwen3.7 Plus, Qwen3.7 Flash | $0.03–$1.48 / $0.13–$4.43 |
| **Tencent** | Hy3 | $0.132 / $0.528 |
| **Xiaomi** | MiMo-V2.5, MiMo-V2.5 Pro | $0.14–$0.435 / $0.28–$0.87 |
| **Free tier** | Nemotron 3 Ultra 550B, Nemotron 3.5 Lightning, Nemotron 3 Nano 30B, Nemotron 3 Nano Omni (vision), Llama 3.2 11B Vision, Cohere North Mini Code, Poolside Laguna XS 2.1 (7 free models, keyless — no wallet needed) | **Free** |
| **Free tier** | Nemotron 3 Ultra 550B, Nemotron 3.5 Lightning, Nemotron 3 Nano 30B, Nemotron 3 Nano Omni (vision), Llama 3.2 11B Vision, Cohere North Mini Code, Poolside Laguna XS 2.1 (6 free models, keyless — no wallet needed) | **Free** |

### Reasoning

Expand Down
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 79 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 78 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 79 models and paid APIs. Free to start.
Franklin — the AI agent with a wallet. Writes code and spends USDC across 78 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"}
79 LLMs (GPT, Claude, Gemini, DeepSeek, Grok, Kimi, Llama) through one OpenAI-compatible API. Pay per request.
78 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 79 LLMs, paid per request in USDC over x402 — no API keys, no subscriptions.
description: OpenAI-compatible Chat Completions endpoint for 78 LLMs, paid per request in USDC over x402 — no API keys, no subscriptions.
---

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

:::card{title="Browse all models" href="models.md" icon="Brain"}
79 chat models with live pricing — pick the right model and ID for your call.
78 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 79 LLMs for synthesis.
Feed grounded search results into any of 78 LLMs for synthesis.
:::

:::card{title="Error handling" href="errors.md" icon="Code"}
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 103 AI models.
description: Pair Coinbase AgentKit with BlockRun so your agents both hold on-chain assets and pay per request for 102 AI models.
---

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

BlockRun adds:
- 79 chat models (95 in the full catalog)
- 78 chat models (95 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 103 AI models via x402 micropayments — no per-provider API keys.
description: Add the BlockRun plugin to ElizaOS so your agents reach 102 AI models via x402 micropayments — no per-provider API keys.
---

# ElizaOS Integration

Use BlockRun as an LLM provider in ElizaOS agents — one plugin unlocks 79 models paid per request over x402.
Use BlockRun as an LLM provider in ElizaOS agents — one plugin unlocks 78 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 103 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 102 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 103 AI models, paid per request over x402 — until the official plugin ships.
description: Combine GOAT SDK's cross-chain execution with BlockRun's 102 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 79 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 78 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 | 79 chat models (95 total) |
| Protocol integrations | 78 chat models (95 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 79 models.
description: Wrap BlockRun in a custom LangChain LLM class that handles x402 payments automatically — chains, agents, and RAG over 78 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 — 79 models via x402 micropayments. Use Franklin, the SDKs, or the MCP; integrate with frameworks if you already use one.
description: Build AI agents that pay for their own intelligence — 78 models via x402 micropayments. Use Franklin, the SDKs, or the MCP; integrate with frameworks if you already use one.
---

# 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, 79 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, 78 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 79 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 78 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"}
79 LLMs with live pricing, plus smart routing to cut costs automatically.
78 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"}
79 LLMs with live pricing, plus smart routing to cut costs automatically.
78 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 79 models, crypto data, voice calls, media generation, and prediction markets with zero API keys.
description: A Model Context Protocol server that gives Claude Code 78 models, crypto data, voice calls, media generation, and prediction markets with zero API keys.
---

# BlockRun MCP

Give Claude Code access to 103 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 102 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 79 models and paid APIs, settling per outcome over x402. No subscriptions, no API keys.
description: Franklin is the AI agent with a wallet — it writes code and spends USDC autonomously across 78 models and paid APIs, settling per outcome over x402. No subscriptions, 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 79 chat models. Four profiles: `auto`, `eco`, `premium`, `free`.
- **Models & routing** — picks the best model per task via [ClawRouter](routing/clawrouter.md)'s scoring, across 78 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
6 changes: 3 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 79 LLMs through one OpenAI-compatible API, paid per request in USDC — no API keys, no subscriptions.
description: BlockRun Intelligence gives your agent 78 LLMs through one OpenAI-compatible API, paid per request in USDC — no API keys, no subscriptions.
---

# Intelligence

AI accesses any LLM. 79 models, pay-per-request.
AI accesses any LLM. 78 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 @@ -79,7 +79,7 @@ Provider rates per 1M tokens. Since 2026-08-07 these are also the BILLED rates
| DeepSeek V4 Pro | $1.32/M | $3.96/M |

### Free tier
7 free models with no per-token charge (you still need a funded wallet for the x402 handshake, but these calls don't draw it down).
6 free models with no per-token charge (you still need a funded wallet for the x402 handshake, but these calls don't draw it down).

*M = million tokens. Provider rates, billed with no BlockRun margin on chat tokens; a flat $0.001 transaction fee is added per request.*

Expand Down
10 changes: 5 additions & 5 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, 79 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, 78 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 @@ -200,7 +200,7 @@ Curated primaries per tier and profile (prices are input/output $/M tokens, as p
† Withheld from `/v1/models` — the router still calls it by direct ID, but you will not find it on the public pricing page. The published savings claim is priced on visible models only, which makes it conservative.
‡ Not a profile you pick — auto-selected in any profile when the turn actually needs its attached tools; prefers models that keep going instead of stopping to ask. Force or disable with `routing.overrides.agenticMode`.

The primary is where the tier starts, not where the request necessarily lands: the portfolio ranks every capability-eligible candidate for the detected task, so a tool-calling turn and a proof in the same tier resolve to different models. `/model free` is an alias rather than a routed profile: it pins the free default (`free/nemotron-3.5-lightning`, the same model that opens ECO SIMPLE) and walks the other free models as fallbacks, for $0 routing across the 7 free models.
The primary is where the tier starts, not where the request necessarily lands: the portfolio ranks every capability-eligible candidate for the detected task, so a tool-calling turn and a proof in the same tier resolve to different models. `/model free` is an alias rather than a routed profile: it pins the free default (`free/nemotron-3.5-lightning`, the same model that opens ECO SIMPLE) and walks the other free models as fallbacks, for $0 routing across the 6 free models.

### Router Core V3.4: measured, with limits

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

### 79 Models
### 78 Models

Access all major providers through one wallet:

Expand Down Expand Up @@ -558,7 +558,7 @@ openclaw gateway restart

### Do I need API keys?

No. ClawRouter uses x402 micropayments with USDC on Solana or Base. Just fund your wallet — or stay on the 7 free models with no wallet at all.
No. ClawRouter uses x402 micropayments with USDC on Solana or Base. Just fund your wallet — or stay on the 6 free models with no wallet at all.

### How much should I fund my wallet?

Expand All @@ -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"}
79 LLMs across OpenAI, Anthropic, Google, xAI, DeepSeek, Z.AI, Moonshot, MiniMax, and the free tier.
78 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 — 79 models paid with Solana USDC.
BlockRun skill for the lobster.cash OpenClaw plugin — 78 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?

79 models including:
78 models including:
- OpenAI (GPT-5.5, GPT-5.4, GPT-5.4 Pro, GPT-5.2)
- Anthropic (Claude Opus 5, Opus 4.8, Sonnet 5, Sonnet 4.6, Haiku 4.5)
- Google (Gemini 3.1 Pro, Gemini 3.5 Flash)
Expand Down
Loading
Loading