Repository avatar
AI Tools
v0.1.1
active

mcp

com.nuluvium/mcp

Trade Robinhood Chain stock tokens from an AI agent without the trades tracing back to it

Documentation

Nuluvium

CI

The privacy layer for onchain stocks on Robinhood Chain.

Nuluvium routes stock token orders for people and AI agents through fresh addresses, paid from a shielded USDG balance, so trades do not trace back to the wallet or the strategy behind them.

Testnet only, not audited. Everything here runs on Robinhood Chain testnet with test tokens. Do not use it with real funds.

How it works

  1. Shield. USDG is deposited into a shielded pool, a fork of Privacy Pools v1.3.0 whose contracts and circuits are used unchanged.
  2. Screen. An approved-set provider checks every deposit (sanctions list, the stock token issuer's blocklist, a denylist, deposit caps) and posts the root of the approved set on chain.
  3. Prove. For each piece of an order, the client makes a zero-knowledge proof that it owns an approved deposit, without saying which one.
  4. Route. A relayer sends the proof to the Nuluvium Router, which releases the piece's USDG, swaps it on a public Uniswap v3 pool and sends the stock tokens to a fresh address.

An order is split into pieces of random size at random times within a window. Readers of the chain see the pieces, not that they belong together or to whom.

What Nuluvium does not do: it never matches orders, no contract of it holds stock tokens, and it is private from other readers of the chain, not from Robinhood, which runs the chain and issues the stock tokens. Keys, notes and order schedules stay on the user's device or the agent's machine; no server stores the link between a user and their fresh addresses.

Repository

FolderWhat it is
contracts/Foundry project: NuluviumRouter, test USDG, deploy scripts and tests. Privacy Pools and forge-std are git submodules in contracts/lib/.
asp/Approved-set provider, a Cloudflare Worker (cron screening, approved set, root posting).
relayer/Relayer, a Cloudflare Worker with a Durable Object queue (GET /quote, POST /piece, POST /sell).
stats/Public stats, a Cloudflare Worker: every 10 minutes it counts pool and Router events, the approved set and the relayer into totals (GET /stats), shown on /stats.
faucet/Testnet faucet, a Cloudflare Worker at faucet.nuluvium.com: a little test ETH (only for a wallet with almost none) and 100 test USDG, once a day per wallet.
sdk/@nuluvium/sdk in TypeScript: keys, notes rebuilt from the chain, proofs, planning, routing, ragequit and sells.
mcp/MCP server for AI agents (stdio), runs on the agent's machine.
web/Site, docs and web app: Next.js on Cloudflare Workers (OpenNext).
testnet/Scripts that drove the testnet runs, with their records in testnet/runs/.
docs/Technical notes: router.md, sdk.md, mcp.md, testnet.md (addresses, runs, findings).

Getting started

Requirements: Node.js 22.18 or newer (the SDK and MCP server run TypeScript directly), and Foundry for the contracts.

git clone --recurse-submodules https://github.com/nuluviumhq/nuluvium.git
cd nuluvium

Everything at once (lint, every typecheck and test suite; CI runs the same):

npm ci && for p in contracts sdk mcp relayer asp stats faucet web; do (cd $p && npm ci); done
npm run check

Contracts:

cd contracts && npm install && forge test
FORK_TESTS=true forge test   # also the tests that fork Robinhood Chain (needs network access)

SDK and MCP server:

cd sdk && npm install && npm test
cd ../mcp && npm install && npm test

Circuit files for proofs (copied from the Privacy Pools submodule, once):

cd testnet && npm install && node setup-artifacts.mjs

Web app (http://localhost:3000 by default):

cd web && npm install && npm run dev

Use it from an AI agent

The MCP server is on npm as @nuluvium/mcp. Once: npx -y @nuluvium/mcp --prepare (installs it and downloads the circuit files), then add "command": "npx", "args": ["-y", "@nuluvium/mcp"] to your MCP client (setup in mcp/README.md). Give the agent its own testnet mnemonic in its environment, never in a file:

export NULUVIUM_MNEMONIC="twelve words of a new testnet mnemonic"
export NULUVIUM_RPC_URL="https://your-testnet-rpc"   # optional, if your network blocks robinhood.com

From a clone of this repository, the root .mcp.json runs the server from source instead. The server offers get_balance, deposit, route_order, cancel_order, get_orders and get_fills. Details: docs/mcp.md.

Status

Testnet build complete: shielded pool, approved-set provider, Router, relayer, SDK, MCP server and web app, each checked end to end on Robinhood Chain testnet (docs/testnet.md). Before mainnet: an independent audit, a legal opinion, real stock tokens priced from Uniswap quotes, and the Router owned by a multisig. Deposits are capped until the audit is published.

Security

Not audited. Do not use with real funds.

Found a vulnerability? Please report it privately through Report a vulnerability (GitHub Security tab), not in a public issue.

License

Apache-2.0. The Privacy Pools contracts and circuits in contracts/lib/privacy-pools-core are by 0xbow under Apache-2.0 and are used unchanged.

NPM
@nuluvium/mcp
Install Command
npm install @nuluvium/mcp