# Nuluvium

> Nuluvium is an open-source MCP server for crypto and web3. MCP server that routes AI agent stock-token trades on Robinhood Chain via fresh addresses. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, Self-hosted
- **Website:** https://nuluvium.com
- **Repository:** https://github.com/nuluviumhq/nuluvium/tree/HEAD/mcp
- **MCP Registry name:** com.nuluvium/mcp
- **Categories:** [crypto and web3](https://ai-powered.com/categories/crypto-and-web3)
- **Listing updated:** 2026-11-20

## About

The README says the server gives an AI agent a shielded USDG balance and splits each buy order into pieces of random size, sent at random times, each bought from a fresh address through a relayer. The agent's secret, notes and order schedule stay on the machine running the server.

The site describes the same flow for people as well as agents, with NVDA, TSLA and SPY as the launch markets. Six tools cover reading the balance, depositing USDG, routing and cancelling orders, and listing orders and fills. Privacy is aimed at other readers of the chain; the README states Robinhood is not excluded from that.

It currently runs only on Robinhood Chain testnet with test tokens, and deposits are capped at 1,000 USDG each until an independent audit is published. It suits developers experimenting with agent trading who want to test order privacy before any real funds are involved.

## Features

- **Shielded USDG balance:** Agents hold USDG in a shielded balance funded by deposits from a wallet they control.
- **Orders split into pieces:** A buy is cut into pieces of random size and sent over a chosen time window.
- **Fresh address per piece:** Each piece swaps from its own new address funded through the relayer.
- **Order cancellation:** Pieces that have not been sent yet can be cancelled with a tool call.
- **Local secret handling:** The mnemonic is read from the environment and never returned; the schedule stays local.
- **Circuit prefetch step:** A one-time prepare command downloads the circuit files so the first start is quicker.

## Good for

- Test how an agent's stock-token buys look on chain without exposing its wallet history
- Prototype agent trading strategies on Robinhood Chain testnet
- Split a large buy order over time to spread out its public footprint
- Review fills and transaction hashes for pieces an agent has executed

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp --env NULUVIUM_MNEMONIC='<NULUVIUM_MNEMONIC>' -- npx -y @nuluvium/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@nuluvium/mcp"
      ],
      "env": {
        "NULUVIUM_MNEMONIC": "<NULUVIUM_MNEMONIC>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@nuluvium/mcp"
      ],
      "env": {
        "NULUVIUM_MNEMONIC": "<NULUVIUM_MNEMONIC>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@nuluvium/mcp"
      ],
      "env": {
        "NULUVIUM_MNEMONIC": "<NULUVIUM_MNEMONIC>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@nuluvium/mcp"
      ],
      "env": {
        "NULUVIUM_MNEMONIC": "<NULUVIUM_MNEMONIC>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@nuluvium/mcp"
      ],
      "env": {
        "NULUVIUM_MNEMONIC": "<NULUVIUM_MNEMONIC>"
      }
    }
  }
}
```

## Tools

- `get_balance`: Read the agent's shielded balance
- `deposit`: Move USDG from the agent's wallet into its shielded balance
- `route_order`: Route a buy in pieces over a time window
- `cancel_order`: Stop the pieces that have not gone out yet
- `get_orders`: List the agent's own orders
- `get_fills`: Read the pieces that went out and their transactions

## FAQ

### What does Nuluvium cost?

Each piece pays the relayer the larger of 0.10 USDG and its gas cost plus 20%, which is 0.10 USDG today. The relayer covers gas, so fresh addresses do not need ETH.

### Is this real money?

No. It runs on Robinhood Chain testnet with test USDG and test stock tokens, and it has not been audited yet.

### Who can see the trades?

Anyone can see each piece as an ordinary swap, but other chain readers cannot see that the pieces belong together or to the depositor. The README says Robinhood is not one of the parties kept private from.

### What are the deposit limits?

Until an audit is published, each deposit is capped at 1,000 USDG and the total across deposits at 25,000 USDG. The smallest deposit is 1 USDG.

### How do I add Nuluvium to Claude Code?

Run this command in your terminal: claude mcp add mcp --env NULUVIUM_MNEMONIC='<NULUVIUM_MNEMONIC>' -- npx -y @nuluvium/mcp

### What are the best alternatives to Nuluvium?

The closest alternatives to Nuluvium are Agentcity Robinhood Chain Research, NLYRA — the risk layer of Robinhood Chain, Polypad, MCPify and Rushr.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Agentcity Robinhood Chain Research](https://ai-powered.com/mcp/agentcity-robinhood-chain-research): Agentcity Robinhood Chain Research is an open-source MCP server for crypto and web3.
- [NLYRA — the risk layer of Robinhood Chain](https://ai-powered.com/mcp/nlyra-the-risk-layer-of-robinhood-chain): NLYRA — the risk layer of Robinhood Chain is a freemium MCP server for crypto and web3.
- [Polypad](https://ai-powered.com/mcp/polypad): Polypad is an MCP server for crypto and web3.
- [MCPify](https://ai-powered.com/mcp/mcpify-2): MCPify is an MCP server for crypto and web3.
- [Rushr](https://ai-powered.com/mcp/rushr): Rushr is an open-source MCP server for crypto and web3.
- [Agent Bank](https://ai-powered.com/mcp/agent-bank): Agent Bank is an open-source MCP server for finance and payments.
- [Semiosis](https://ai-powered.com/mcp/semiosis): Semiosis is a free MCP server for crypto and web3.
- [XCP](https://ai-powered.com/mcp/xcp): XCP is an open-source MCP server for crypto and web3.

---
Source: https://ai-powered.com/mcp/nuluvium
