BlockRun

The Discovery Layer for AI Agent Payments

---

Table of Contents

• Quick Start
• SDKs
• MCP Tools
• Framework Integrations
• Supported Models
• Projects Built with BlockRun
• Ecosystem
• Research
• Vision
• Community

---

Quick Start

from blockrun_llm import LLMClient

client = LLMClient(private_key="0x...")
response = client.chat("Hello!")
# Payment handled automatically via x402

import { LLMClient } from 'blockrun-llm';

const client = new LLMClient({ privateKey: '0x...' });
const response = await client.chat('Hello!');

---

SDKs

Language	Install	Repository
	pip install blockrun-llm	GitHub
	npm i blockrun-llm	GitHub
	go get github.com/blockrunai/blockrun-llm-go	GitHub
	gem install blockrun	GitHub

---

MCP Tools

Tool	Description
blockrun-mcp	MCP Server for Claude Code - Access 30+ AI models with zero API keys
blockrun-agent-wallet	Agent wallet - Give AI agents a wallet to pay for GPT, Grok, DALL-E and more

---

Framework Integrations

Framework	Status	Integration
ElizaOS	✅ Released	elizaos-plugin-blockrun
Claude Code	✅ Released	blockrun-mcp
GOAT SDK	🔄 In Review	Agent framework integration
AgentKit	🔄 In Review	Coinbase agent framework
Rig	🔄 In Review	Rust LLM framework

---

Supported Models

Category	Models
LLMs	GPT-4o, GPT-5, Claude, Gemini, DeepSeek, Llama, Qwen
Reasoning	o1, o3, Grok
Image	DALL-E, Stable Diffusion, Flux
Voice	ElevenLabs, OpenAI TTS

---

Projects Built with BlockRun

Project	Category	Description
X Portal	LLM Gateway	LLM chat interface powered by BlockRun
PredictOS	Prediction Markets	Prediction market analysis platform with multi-AI provider support
Polymarket AI Agent	Prediction Markets	Autonomous AI trading agent using 3-model LLM consensus
Nano Banana	Image Generation	Claude Code skill for AI image generation via x402
LLM_trader	Crypto Trading	AI crypto trading bot with multi-provider support and chart analysis

Built something with BlockRun? Add it here!

---

Ecosystem

Alliance Partners

Partner	Description
	Official Circle Alliance Partner powering USDC payments on Base

x402 Facilitators

BlockRun aggregates services from the x402 facilitator network:

Facilitator	Network
Coinbase CDP	Base, Ethereum
PayAI	Base, Solana
thirdweb	Base, Ethereum
QuestFlow	Base
AnySpend	Base
AurraCloud	Base

Protocol Partner

Partner	Relationship
x402 Foundation	Protocol development

See ECOSYSTEM.md for full partner directory.

---

Research

State of x402 2025

Format	Link
Full Report (PDF)	State of x402 2025
Web Version	Markdown
Presentation	Deck

Key Findings:

• Average transaction: $0.12 (true micropayments impossible on traditional rails)
• 53% of volume is organic business activity
• Base dominates with 53.3% of services, Solana at 36.6%
• 76% of services priced at $0.10 or below

See research/ for methodology.

---

Vision

AI agents can't pay for services. Traditional payment rails require account creation, credit cards, and KYC verification - none of which agents can do.

But agents have something better: wallets.

The x402 protocol (HTTP 402 "Payment Required") lets any HTTP request include a cryptographic payment. Pay and get response. One step.

Roadmap

Phase	Timeline	Focus
Gateway	Now	Pay-per-request access to AI models
Trust	Q1 2026	Service ratings, uptime tracking, smart routing
Universal Routing	Q2 2026+	Price/latency optimization, automatic failover

See VISION.md | ROADMAP.md for full details.

---

Community

Contributing

Area	What You Can Do
Code	Add features, fix bugs, improve SDKs
Docs	Improve documentation, add examples
Integrations	Build plugins for agent frameworks
Feedback	Report bugs, request features

All contributors will be recognized in ACKNOWLEDGMENTS.md.

See CONTRIBUTING.md for guidelines.

Documentation

Section	Links
Getting Started	Installation • Quick Start • Authentication
API Reference	Chat Completions • Models • Errors
x402 Protocol	How It Works • Payment Flow • Security
Resources	Pricing • FAQ • Changelog

---

BlockRun: Let AI agents pay for AI.