Onchain Router Get started
Base mainnet · USDC paymentsAny verified wallet can pay. Check every payment term and set a local spending limit before signing.

Documentation

Installation & availability

Install the stable npm and host-native GitHub releases, verify their sources, and understand the remaining integration boundaries.

Fastest safe start

Requirements: Node.js 20.18 or newer, macOS or Linux, and a human-controlled terminal.

bash
npm install --global @onchainrouter/cli@0.2.0
onchain-router --version
onchain-router setup
onchain-router policy show
onchain-router unlock
onchain-router models

Version 0.2.0 is the current stable client release. Pin the exact version so an upstream tag change cannot silently alter your install. Before installation, verify the @onchainrouter scope and the OnchainRouter/onchain-router source repository.

Setup, wallet import, funding, unlock, and policy widening are human-authority actions. Run them yourself in a direct terminal. Never put a private key, seed phrase, passphrase, payment payload, proxy bearer, or receipt capability in a prompt, command argument, environment variable, log, screenshot, or issue.

Choose a public package

ProductInstallStatus
TypeScript SDKnpm install @onchainrouter/client@0.2.0Public npm stable 0.2.0
Buyer CLInpm install --global @onchainrouter/cli@0.2.0Public npm stable 0.2.0
MCP servernpm install --global @onchainrouter/mcp@0.2.0Public npm stable 0.2.0
Local proxynpm install --global @onchainrouter/proxy@0.2.0Public npm stable 0.2.0
Buyer Runtimenpm install @onchainrouter/buyer-core@0.2.0Public npm stable 0.2.0; trusted-adapter authors
Smart routingnpm install @onchainrouter/routing@0.2.0Public npm stable 0.2.0; routing is experimental

The Python SDK remains a source package that delegates paid execution to the matching CLI. It is not on PyPI.

IntegrationBest forAvailabilitySource
Direct APIYou already have an x402 buyerPublic APIUse the public API
TypeScript SDKYou are building a Node.js applicationnpm stable · 0.2.0GitHub
Buyer CLIYou work in a terminalnpm stable · 0.2.0GitHub
MCPYour agent uses native toolsnpm stable · 0.2.0GitHub
Local OpenAI proxyYour app accepts an OpenAI base URLnpm stable · 0.2.0GitHub
Agent SkillYour coding agent follows reusable instructionsMIT source · stable 0.2.0GitHub
OpenClawYou use OpenClaw agentsGitHub stable · 0.2.1GitHub
Hermes AgentYou use Hermes AgentGitHub stable · 0.2.0GitHub

Agent-host integrations

  • OpenClaw 0.2.1 is a stable MIT release installed from its immutable GitHub release with OpenClaw's native Git installer: openclaw plugins install git:github.com/OnchainRouter/onchain-router-openclaw@v0.2.1 --force. It is not yet listed on ClawHub.
  • Hermes Agent 0.2.0 is a stable MIT release installed from OnchainRouter/onchain-router-hermes with Hermes' native Git installer: hermes plugins install OnchainRouter/onchain-router-hermes --enable. It is not a PyPI release, and PyPI is not required for this host-native path.
  • The portable Agent Skill is public in the client repository and requires the matching Buyer CLI.

Verify the exact organization, repository, version, and release commit before installation. Package stability does not prove a funded request in either host; complete the human-owned Buyer Runtime setup and acceptance flow separately.

Browser Workbench

Open Workbench. This build includes the browser UI. A read-only local preview cannot submit paid requests; use only an explicitly enabled deployment for payments.

Update and verify

Pin exact version 0.2.0. Review release notes before updating, rerun onchain-router doctor, and confirm that the local wallet profile, policy, and receipts remain intact. The product manifest records current publication facts; the live models, pricing, and HTTP 402 challenge remain authoritative for service behavior.

Reviewed 2026-09-06Catalog 064e4f81a4ce

Search guides, endpoint references, models, and pricing.