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 economic infrastructure for the agent era — AI agents

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

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

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

:::card{title="Error handling" href="errors.md" icon="Code"}
Expand Down
6 changes: 2 additions & 4 deletions docs/api-reference/models.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Models
description: List and price 72 models across chat, image, video, music, and speech from one unified BlockRun API, with a flat 5% platform fee over provider rates.
description: List and price 71 models across chat, image, video, music, and speech from one unified BlockRun API, with a flat 5% platform fee over provider rates.
---

# Models
Expand Down Expand Up @@ -189,15 +189,13 @@ K3 is the current flagship — a 2.8-trillion-parameter open MoE with a **1M-tok

### Free Tier (open-weight)

Open-weight models served free of charge (no x402 payment), subject to a small per-IP rate limit. The free tier auto-routes around any temporarily unavailable model, so the live set is best read from `GET /api/v1/models` (filter on `billingMode: "free"`). There are **8** free models listed on mainnet; the free tier's fallback workhorse is `nvidia/gpt-oss-120b` (`nvidia/llama-4-maverick` is temporarily offline upstream and auto-redirects to it).
Open-weight models served free of charge (no x402 payment), subject to a small per-IP rate limit. The free tier auto-routes around any temporarily unavailable model, so the live set is best read from `GET /api/v1/models` (filter on `billingMode: "free"`). There are **6** free models listed on mainnet; the free tier's fallback workhorse is `nvidia/gpt-oss-120b`.

| Model ID | Name | Input Price | Output Price |
|----------|------|-------------|--------------|
| `nvidia/mistral-nemotron` | Mistral Nemotron | **FREE** | **FREE** |
| `nvidia/mistral-large-3-675b` | Mistral Large 3 675B (slow upstream) | **FREE** | **FREE** |
| `nvidia/step-3.7-flash` | Step 3.7 Flash | **FREE** | **FREE** |
| `nvidia/deepseek-v4-flash` | DeepSeek V4 Flash | **FREE** | **FREE** |
| `nvidia/seed-oss-36b` | Seed OSS 36B | **FREE** | **FREE** |
| `nvidia/nemotron-3-nano-omni-30b-a3b-reasoning` | Nemotron 3 Nano Omni | **FREE** | **FREE** |
| `nvidia/nemotron-nano-9b-v2` | Nemotron Nano 9B v2 | **FREE** | **FREE** |
| `nvidia/nemotron-nano-12b-v2-vl` | Nemotron Nano 12B v2 VL | **FREE** | **FREE** |
Expand Down
2 changes: 1 addition & 1 deletion 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 93 AI models.
description: Pair Coinbase AgentKit with BlockRun so your agents both hold on-chain assets and pay per request for 92 AI models.
---

# AgentKit Integration
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 93 AI models via x402 micropayments — no per-provider API keys.
description: Add the BlockRun plugin to ElizaOS so your agents reach 92 AI models via x402 micropayments — no per-provider API keys.
---

# ElizaOS Integration

Use BlockRun as an LLM provider in ElizaOS agents — one plugin unlocks 72 models paid per request over x402.
Use BlockRun as an LLM provider in ElizaOS agents — one plugin unlocks 71 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 93 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 92 AI models via x402 micropayments.

## Setup

Expand Down
4 changes: 2 additions & 2 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 93 AI models, paid per request over x402 — until the official plugin ships.
description: Combine GOAT SDK's cross-chain execution with BlockRun's 92 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 72 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 71 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
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 72 models.
description: Wrap BlockRun in a custom LangChain LLM class that handles x402 payments automatically — chains, agents, and RAG over 71 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 — 72 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 — 71 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, 72 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, 71 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
6 changes: 3 additions & 3 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 72 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 71 models, images, and live data.
---

# Claude Code Users
Expand Down Expand Up @@ -85,7 +85,7 @@ Use GPT-5 to get a second opinion on this code
Ask Grok what's trending on X right now
```

Claude automatically routes to 93 AI models and pays via x402.
Claude automatically routes to 92 AI models and pays via x402.

### Trading (alpha-mcp)

Expand Down Expand Up @@ -182,7 +182,7 @@ Create images via micropayments with the nano-banana skill.
:::

:::card{title="Explore all models" href="../products/intelligence/overview.md" icon="Brain"}
72 LLMs with live pricing, plus smart routing to cut costs automatically.
71 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 @@ -98,7 +98,7 @@ The full list of 18 `blockrun_*` tools — chat, image, video, search, markets,
:::

:::card{title="Explore the models" href="../products/intelligence/overview.md" icon="Brain"}
72 LLMs with live pricing, plus smart routing to cut costs automatically.
71 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 72 models, crypto data, voice calls, media generation, and prediction markets with zero API keys.
description: A Model Context Protocol server that gives Claude Code 71 models, crypto data, voice calls, media generation, and prediction markets with zero API keys.
---

# BlockRun MCP

Give Claude Code access to 93 AI models, 80+ crypto data endpoints, voice calls, image/video/music generation, prediction markets, and a sandbox runtime — all with zero API keys.
Give Claude Code access to 92 AI models, 80+ crypto data endpoints, voice calls, image/video/music generation, prediction markets, 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 72 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 71 models and paid APIs, settling per outcome over x402. No subscriptions, no API keys.
---

# Franklin Agent
Expand Down Expand Up @@ -50,7 +50,7 @@ No install? Run it directly with `npx @blockrun/franklin`.

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 72 chat models.
- **Models & routing** — picks the best model per task via [ClawRouter](routing/clawrouter.md)'s scoring, across 71 chat models.
- **Paid APIs** — search, market data, media, RPC, and more, paid per call over [x402](../x402/how-it-works.md).
- **One wallet** — the wallet is the identity; fund it on Base or Solana ([Wallet Setup](../getting-started/wallet-setup.md)).

Expand Down
4 changes: 2 additions & 2 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 72 LLMs through one OpenAI-compatible API, paid per request in USDC — no API keys, no subscriptions.
description: BlockRun Intelligence gives your agent 71 LLMs through one OpenAI-compatible API, paid per request in USDC — no API keys, no subscriptions.
---

# Intelligence

AI accesses any LLM. 72 models, pay-per-request.
AI accesses any LLM. 71 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
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

**87% 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, 72 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, 71 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.
Expand Down Expand Up @@ -173,7 +173,7 @@ Default `auto` profile primaries (cost-balanced; switch to `free` profile for $0
- No external API calls for routing decisions
- Full privacy - your prompts never leave your machine for routing

### 72 Models
### 71 Models

Access all major providers through one wallet:

Expand Down Expand Up @@ -456,7 +456,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"}
72 LLMs across OpenAI, Anthropic, Google, xAI, DeepSeek, Z.AI, Moonshot, MiniMax, and the free tier.
71 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/ecosystem.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ Projects, integrations, and partners building with BlockRun and x402.
| Product | Description | Link |
|---------|-------------|------|
| [alpha-mcp](https://github.com/BlockRunAI/alpha-mcp) | AI crypto trading for Claude | [GitHub](https://github.com/BlockRunAI/alpha-mcp) |
| [blockrun-mcp](https://github.com/BlockRunAI/blockrun-mcp) | MCP server for 93 AI models, images, video, music, voice, prediction markets, crypto data, sandbox runtime, smart routing | [GitHub](https://github.com/BlockRunAI/blockrun-mcp) |
| [blockrun-mcp](https://github.com/BlockRunAI/blockrun-mcp) | MCP server for 92 AI models, images, video, music, voice, prediction markets, crypto data, sandbox runtime, smart routing | [GitHub](https://github.com/BlockRunAI/blockrun-mcp) |
| [nano-banana](https://github.com/BlockRunAI/nano-banana-blockrun) | Image generation skill | [GitHub](https://github.com/BlockRunAI/nano-banana-blockrun) |

## API Products
Expand Down
2 changes: 1 addition & 1 deletion docs/resources/examples.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,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 — 72 models paid with Solana USDC.
BlockRun skill for the lobster.cash OpenClaw plugin — 71 models paid with Solana USDC.
:::

::::
Expand Down
2 changes: 1 addition & 1 deletion docs/resources/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -102,7 +102,7 @@ No. alpha-mcp is free. You only pay for intelligence (sentiment analysis) and ne

### Which AI models are available?

72 models including:
71 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
6 changes: 3 additions & 3 deletions docs/sdks/go.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
---
title: Go SDK
description: The Go SDK for BlockRun — call 93 AI models, generate images, and manage wallets over x402 micropayments with no API keys.
description: The Go SDK for BlockRun — call 92 AI models, generate images, and manage wallets over x402 micropayments with no API keys.
---

# Go SDK

The Go SDK for BlockRun provides access to 93 AI models via x402 micropayments — pay per call in USDC, no API keys.
The Go SDK for BlockRun provides access to 92 AI models via x402 micropayments — pay per call in USDC, no API keys.

**Source:** [github.com/BlockRunAI/blockrun-llm-go](https://github.com/BlockRunAI/blockrun-llm-go) · `go get github.com/BlockRunAI/blockrun-llm-go` · MIT

Expand Down Expand Up @@ -261,7 +261,7 @@ Fund a wallet with USDC and make your first paid call in under five minutes.
:::

:::card{title="Models & pricing" href="../api-reference/models.md" icon="Brain"}
Browse all 72 models with live pricing to pick the right one for each call.
Browse all 71 models with live pricing to pick the right one for each call.
:::

:::card{title="How payment works" href="../x402/how-it-works.md" icon="Zap"}
Expand Down
4 changes: 2 additions & 2 deletions docs/sdks/python.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Python SDK
description: The official BlockRun Python SDK — call 72 LLMs, smart routing, and prediction markets over x402 micropayments with no API keys.
description: The official BlockRun Python SDK — call 71 LLMs, smart routing, and prediction markets over x402 micropayments with no API keys.
---

# Python SDK
Expand Down Expand Up @@ -860,7 +860,7 @@ Fund a wallet with USDC and make your first paid call in under five minutes.
:::

:::card{title="Models & pricing" href="../api-reference/models.md" icon="Brain"}
Browse all 72 models with live pricing to pick the right one for each call.
Browse all 71 models with live pricing to pick the right one for each call.
:::

:::card{title="How payment works" href="../x402/how-it-works.md" icon="Zap"}
Expand Down
4 changes: 2 additions & 2 deletions docs/sdks/typescript.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: TypeScript SDK
description: The official BlockRun TypeScript/JavaScript SDK — call 72 LLMs, smart routing, and prediction markets over x402 micropayments with no API keys.
description: The official BlockRun TypeScript/JavaScript SDK — call 71 LLMs, smart routing, and prediction markets over x402 micropayments with no API keys.
---

# TypeScript SDK
Expand Down Expand Up @@ -731,7 +731,7 @@ Fund a wallet with USDC and make your first paid call in under five minutes.
:::

:::card{title="Models & pricing" href="../api-reference/models.md" icon="Brain"}
Browse all 72 models with live pricing to pick the right one for each call.
Browse all 71 models with live pricing to pick the right one for each call.
:::

:::card{title="How payment works" href="../x402/how-it-works.md" icon="Zap"}
Expand Down
2 changes: 1 addition & 1 deletion docs/x402/endpoints.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ Replace `blockrun.ai` with `sol.blockrun.ai`, `nano.blockrun.ai`, `xrpl.blockrun

## AI Model Gateway

OpenAI-compatible. 72 models across chat, reasoning, coding, and vision — plus image, video, music, and speech generation. Per-model pricing is published live at `/api/v1/models`.
OpenAI-compatible. 71 models across chat, reasoning, coding, and vision — plus image, video, music, and speech generation. Per-model pricing is published live at `/api/v1/models`.

| Method | Path | Purpose | Pricing |
|---|---|---|---|
Expand Down
Loading