project-r0x

mcp
Security Audit
Warn
Health Pass
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 122 GitHub stars
Code Warn
  • process.env — Environment variable access in examples/test-transaction.js
  • network request — Outbound network request in examples/test-transaction.js
  • crypto private key — Private key handling in examples/test-transaction.js
  • network request — Outbound network request in src/client/R0xClient.ts
  • crypto private key — Private key handling in src/client/R0xClient.ts
  • crypto private key — Private key handling in src/client/types.ts
  • crypto private key — Private key handling in src/plugin/config.ts
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

Official SDK, Claude Code plugin and facilitator docs for r0x, the x402 facilitator for Robinhood Chain.

README.md

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 · Facilitator docs: docs/facilitator.md · Skill reference: 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.
  • 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 to
either import an existing wallet or generate a fresh one. After that, fifteen
tools are available: r0x_setup, balance, tx, price, wallet, chat,
send, fund, broadcast, spend_limit, trade, quote, pool, yield,
and bridge.

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.js
for a working ~80-line client.

License

MIT, see LICENSE.

Reviews (0)

No results found