Nuluvium
OfficialProvides AI-agent tools for privately trading tokenized stocks on Robinhood Chain testnet, including shielded USDG deposits, routing and cancelling stock token orders, and checking balances, orders, and fills.
Nuluvium
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.
Site and app (testnet): https://nuluvium.com
Reviewing the code? Start with docs/review.md: how to build and test everything, what each claim rests on, who holds which key, and the known gaps.
Testnet only, not audited. Everything here runs on Robinhood Chain testnet with test tokens. Do not use it with real funds.
How it works
Shield. USDG is deposited into a shielded pool, a fork of Privacy Pools v1.3.0 whose contracts and circuits are used unchanged.
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.
Prove. For each piece of an order, the client makes a zero-knowledge proof that it owns an approved deposit, without saying which one.
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.
Related MCP server: hoodr MCP Server
Repository
Folder | What it is |
| Foundry project: |
| Approved-set provider, a Cloudflare Worker (cron screening, approved set, root posting). |
| Relayer, a Cloudflare Worker with a Durable Object queue ( |
| Public stats, a Cloudflare Worker: every 10 minutes it counts pool and Router events, the approved set and the relayer into totals ( |
| 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. |
|
|
| MCP server for AI agents (stdio), runs on the agent's machine. |
| Site, docs and web app: Next.js on Cloudflare Workers (OpenNext). |
| Scripts that drove the testnet runs, with their records in |
| Technical notes: |
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 nuluviumEverything 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 checkContracts:
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 testCircuit files for proofs (copied from the Privacy Pools submodule, once):
cd testnet && npm install && node setup-artifacts.mjsWeb app (http://localhost:3000 by default):
cd web && npm install && npm run devUse 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.comFrom 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.
Available Tools
6 toolscancel_orderCancel an orderA
Cancels the pieces of an order that have not been sent yet. A piece already being sent may still complete.
Inputs: orderId (required).
depositDeposit USDG into the shielded balanceA
Moves USDG from the agent's deposit wallet (see get_balance) into its shielded balance as a new note. The deposit itself is public: anyone can see this wallet deposited this amount; what the note pays for later is not linked to it. Sends two transactions (approve, deposit) and waits for them. The new note can pay for orders once the clean-funds check approves it, usually within a minute. Up to 1,000 USDG per deposit until the audit.
Inputs: usdgAmount (required).
get_balanceShielded balanceA
Shows the agent's shielded USDG balance on Nuluvium, per note, and the deposit wallet that funds new deposits. One order is paid from one note, so the largest note is the largest order you can route right now.
Inputs: no named parameters.
get_fillsExecuted piecesB
Shows executed pieces: USDG spent, tokens received, the fresh address holding them, and the transaction link.
Inputs: orderId.
get_ordersList ordersB
Lists this agent's orders with the status of every piece (scheduled, sending, done, failed, cancelled).
Inputs: onlyOpen.
route_orderRoute a private buy orderA
Buys a stock token with shielded USDG, split into pieces of random size sent at random times inside the window. Each piece goes to its own fresh address, so the trades do not trace back to the agent's wallet. Returns at once; pieces are sent in the background (check with get_orders / get_fills). Privacy is from other readers of the chain, not from Robinhood.
Inputs: token (required), usdgAmount (required), pieces, windowMinutes, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool maps to a clearly distinct action in the private order flow: balance inspection, funding, order routing, cancellation, order status, and fill history. The potential overlap between get_orders and get_fills is well resolved by their descriptions, with one covering all piece statuses and the other covering only executed pieces.
Most tools follow a clear verb_noun snake_case pattern: get_balance, route_order, cancel_order, get_orders, get_fills. The only minor deviation is deposit, which uses a bare verb, but it remains readable and unambiguous.
Six tools is well-scoped for a focused private stock-order workflow. Each tool earns its place by covering a necessary step: funding, routing, cancelling, and inspecting orders and fills.
The order lifecycle from deposit through routing, cancellation, and fill inspection is covered, but there is no withdrawal tool to move shielded USDG back out or manage received stock tokens. These are notable gaps for a balance-bearing financial workflow, though the core buying flow is coherent.
Maintenance
Related MCP Connectors
Non-custodial limit, stop-loss and DCA trading on Epsilon (Robinhood Chain) for AI agents
Agent-to-agent escrow on Robinhood Chain. Post quests with ETH/USDG bounties and settle on-chain.
Real Uniswap liquidity on Robinhood Chain for your wallet, plus a play-money arena for AI agents.
Stock options market for AI agents on Robinhood Chain: RFQ quotes, buy/close, P&L, x402 deposits.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI agents to interact with Robinhood Chain via USDG payments, offering tools for balance, pricing, trading, and more.1848MIT

hoodr MCP Serverofficial
AlicenseNot gradedqualityCmaintenanceEnables AI agents to trade tokenized stocks (e.g., NVDA, TSLA) on Robinhood Chain via MCP, with non-custodial keys and spending caps.21 npmMIT
Stocklayer MCPofficial
AlicenseNot gradedqualityBmaintenanceEnables AI agents to discover tokenized Stock Tokens, read reference prices and wallet balances on Robinhood Chain, create quotes, simulate transactions, and build policy-checked trade plans that return an explainable verdict plus unsigned transactions for a wallet to sign.MIT- AlicenseNot gradedqualityBmaintenanceEnables an agent to quote swaps and get unsigned transaction calldata for trading on Robinhood Chain, with best-price routing checked against a spending policy (caps, allowlists, slippage, price impact, pinned contracts, simulation) before anything is returned. Also provides simulation, hook-pool and hook-risk inspection, token price lookups, verified stock-token listing, and rolling spend status, while never holding keys, signing, or sending.MIT