Project R0x

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 use it right now: discover a priced capability, authorize a USDG payment, and invoke it, all in one uninterrupted call. No API keys, no subscriptions, no human approving anything in between.

Live site: [projectr0x.dev](https://projectr0x.dev) · Facilitator docs: [docs/facilitator.md](./docs/facilitator.md) · Skill reference: [docs/skills.md](./docs/skills.md)

What's in this repo

• SDK (src/client): a TypeScript client (R0xClient) that handles the x402 challenge/sign/retry cycle automatically. Published as r0x-os on npm.
• Claude Code / MCP plugin (src/plugin): exposes the full skill catalog as MCP tools, plus local wallet setup and a spend-limit guard.
• Virtuals GAME integration (integrations/virtuals-game): a GAME SDK worker that gives any Virtuals agent the same skill catalog as fifteen callable functions, with optional auto-broadcast of trades and transfers.
• 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](./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 fi