r0x-os

r0x-os

The official SDK, Claude Code / MCP plugin, and facilitator docs for r0x,the USDG-native operating system for AI agents, built on Robinhood Chain.

r0x runs the official x402 facilitator for Robinhood Chain. AI agents can useit right now: discover a priced capability, authorize a USDG payment, andinvoke it, all in one uninterrupted call. No API keys, no subscriptions, nohuman approving anything in between.

Live site: projectr0x.dev · Facilitator docs: docs/facilitator.md · Skill reference: docs/skills.md

What's in this repo

• SDK (src/client): a TypeScript client (R0xClient) that handles thex402 challenge/sign/retry cycle automatically. Published as r0x-os on npm.
• Claude Code / MCP plugin (src/plugin): exposes the full skill catalogas MCP tools, plus local wallet setup and a spend-limit guard.
• Docs (docs/): how the facilitator works and the full skill reference.
• Examples (examples/): a minimal, dependency-light reference client.

Install

npm install r0x-os

import { R0xClient } from 'r0x-os';

const client = new R0xClient({ privateKey: process.env.R0X_PRIVATE_KEY });

// $0.01 USDG per call, settled automatically
const { data } = await client.price('ETH');
console.log(data.priceUSD);

const balance = await client.balance('0x...');
console.log(balance.data.balances);

See docs/skills.md for every method the client exposes.

Claude Code plugin

/plugin marketplace add nhevers/project-r0x
/plugin install r0x-os

Or add it directly as an MCP server:

claude mcp add r0x -- npx r0x-os

No private key is needed upfront, the agent calls r0x_setup on first use toeither import an existing wallet or generate a fresh one. After that, eighteentools are available: r0x_setup, balance, tx, price, wallet, chat,send, fund, broadcast, spend_limit, trade, quote, pool,liquidity_add, liquidity_remove, liquidity_positions, yield, andbridge. trade, quote, pool, and liquidity_* all accept any ERC20token on Robinhood Chain, not just ETH and USDG — there's no allowlist.

Building from source

git clone https://github.com/nhevers/project-r0x.git
cd project-r0x
npm install
npm run build      # compiles src/ -> dist/
npm run example:tx # runs the reference test-transaction script

How the facilitator works

Read docs/facilitator.md for the full protocol walk-through,or jump straight to examples/test-transaction.jsfor a working ~80-line client.

License

MIT, see LICENSE.