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 66 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 65 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 66 models and paid APIs. Free to start.
Franklin — the AI agent with a wallet. Writes code and spends USDC across 65 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"}
66 LLMs (GPT, Claude, Gemini, DeepSeek, Grok, Kimi, Llama) through one OpenAI-compatible API. Pay per request.
65 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 66 LLMs, paid per request in USDC over x402 — no API keys, no subscriptions.
description: OpenAI-compatible Chat Completions endpoint for 65 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"}
66 chat models with live pricing — pick the right model and ID for your call.
65 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 66 LLMs for synthesis.
Feed grounded search results into any of 65 LLMs for synthesis.
:::

:::card{title="Error handling" href="errors.md" icon="Code"}
Expand Down
2 changes: 1 addition & 1 deletion 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 66 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 65 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
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 86 AI models.
description: Pair Coinbase AgentKit with BlockRun so your agents both hold on-chain assets and pay per request for 85 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 86 AI models via x402 micropayments — no per-provider API keys.
description: Add the BlockRun plugin to ElizaOS so your agents reach 85 AI models via x402 micropayments — no per-provider API keys.
---

# ElizaOS Integration

Use BlockRun as an LLM provider in ElizaOS agents — one plugin unlocks 66 models paid per request over x402.
Use BlockRun as an LLM provider in ElizaOS agents — one plugin unlocks 65 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 86 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 85 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 86 AI models, paid per request over x402 — until the official plugin ships.
description: Combine GOAT SDK's cross-chain execution with BlockRun's 85 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 66 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 65 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 66 models.
description: Wrap BlockRun in a custom LangChain LLM class that handles x402 payments automatically — chains, agents, and RAG over 65 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 — 66 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 — 65 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, 66 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, 65 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 66 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 65 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 86 AI models and pays via x402.
Claude automatically routes to 85 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"}
66 LLMs with live pricing, plus smart routing to cut costs automatically.
65 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"}
66 LLMs with live pricing, plus smart routing to cut costs automatically.
65 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 66 models, crypto data, voice calls, media generation, and prediction markets with zero API keys.
description: A Model Context Protocol server that gives Claude Code 65 models, crypto data, voice calls, media generation, and prediction markets with zero API keys.
---

# BlockRun MCP

Give Claude Code access to 86 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 85 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 66 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 65 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 66 chat models.
- **Models & routing** — picks the best model per task via [ClawRouter](routing/clawrouter.md)'s scoring, across 65 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
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 66 LLMs through one OpenAI-compatible API, paid per request in USDC — no API keys, no subscriptions.
description: BlockRun Intelligence gives your agent 65 LLMs through one OpenAI-compatible API, paid per request in USDC — no API keys, no subscriptions.
---

# Intelligence

AI accesses any LLM. 66 models, pay-per-request.
AI accesses any LLM. 65 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 @@ -80,7 +80,7 @@ Reference provider rates per 1M tokens (BlockRun adds a 5% margin at billing —
| DeepSeek V4 Pro | $0.435/M | $0.87/M |

### Free tier
8 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).
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).

*M = million tokens. Reference provider rates; the 5% BlockRun margin is applied at billing.*

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, 66 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, 65 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

### 66 Models
### 65 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"}
66 LLMs across OpenAI, Anthropic, Google, xAI, DeepSeek, Z.AI, Moonshot, MiniMax, and the free tier.
65 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 86 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 85 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 — 66 models paid with Solana USDC.
BlockRun skill for the lobster.cash OpenClaw plugin — 65 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?

66 models including:
65 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 86 AI models, generate images, and manage wallets over x402 micropayments with no API keys.
description: The Go SDK for BlockRun — call 85 AI models, generate images, and manage wallets over x402 micropayments with no API keys.
---

# Go SDK

The Go SDK for BlockRun provides access to 86 AI models via x402 micropayments — pay per call in USDC, no API keys.
The Go SDK for BlockRun provides access to 85 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 66 models with live pricing to pick the right one for each call.
Browse all 65 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 66 LLMs, smart routing, and prediction markets over x402 micropayments with no API keys.
description: The official BlockRun Python SDK — call 65 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 66 models with live pricing to pick the right one for each call.
Browse all 65 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 66 LLMs, smart routing, and prediction markets over x402 micropayments with no API keys.
description: The official BlockRun TypeScript/JavaScript SDK — call 65 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 66 models with live pricing to pick the right one for each call.
Browse all 65 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. 66 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. 65 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