Kozu

How to use Kozu

Kozu is an AI agent with a strict allowance. You decide what it may spend, invest and launch, and a contract on Robinhood Chain holds it to that. Setting it up takes about ten minutes.

What you need

  • Your wallet (Rabby or MetaMask) on Robinhood Chain, holding the USDG you want Kozu to be able to use. Your money stays here.
  • A wallet for Kozu. Create a brand-new wallet just for the agent and copy its address. Give it a few dollars of ETH for gas and nothing else. Never use your own wallet as Kozu's.
  • An AI agent that supports MCP, such as Claude Code, Claude Desktop or Cursor, if you want Kozu to act on its own.

Why two wallets? Kozu's key can only spend through your limits. Even if someone stole it, they couldn't touch the rest of your money or send it anywhere you haven't approved.

Set the allowance

  1. Open the app and press Connect wallet. Connecting moves nothing.
  2. Paste Kozu's wallet address into Kozu's wallet address and press Use this address.
  3. Under Spend, choose a per-purchase limit and a daily limit, for example $5 and $20.
  4. Leave Only pay merchants I approve ticked, then press Approve and save limits. Your wallet asks you to sign twice: once to let the contract use your USDG, once to save the limits.
  5. Under Approved merchants, add the addresses Kozu may pay and press Allow these.

The card at the top of the app now shows what Kozu can still spend today. The daily limit resets at midnight UTC.

Invest on autopilot

Kozu can buy assets you choose on a schedule, like $50 of NVDA every week. It can never sell, and everything it buys goes straight to your wallet.

  1. Under Invest on autopilot, set the most per trade, the most per week, and the minimum time between trades.
  2. Press Approve and save plan.
  3. In Approved assets, pick a stock from Popular on Robinhood Chain. It fills in the token, its Chainlink price feed and the right Uniswap pool. Press Allow asset.

Before every buy, the contract checks the price against Chainlink and refuses a bad deal, whatever Kozu asks for. Stock tokens trade around the clock on Robinhood Chain, weekends included. Over the weekend Chainlink holds the last price, and Kozu won't pay more than that plus your slippage, so if a stock jumps on Saturday the buy waits instead of overpaying.

Plug Kozu in

Kozu's tools run next to your AI agent. Download the Kozu project, run npm install inside its mcp folder, then add it to Claude Code:

claude mcp add --transport stdio \
  --env RPC_URL=https://rpc.mainnet.chain.robinhood.com \
  --env AGENT_PRIVATE_KEY=0xKOZU_WALLET_KEY \
  --env OWNER_ADDRESS=0xYOUR_WALLET \
  --env DEPLOYMENT_FILE=/path/to/rhMainnet.json \
  kozu -- node /path/to/kozu/mcp/server.mjs

Use the private key of Kozu's wallet here, never your own. The deployment file is the one from the Deploy page. Give your agent the rules in skill/SKILL.md as well, so it knows to check its budget first and never work around a limit.

Talk to Kozu

Once it's plugged in, just ask:

What's left in my allowance today?
Pay 4.99 USDG to my approved coffee shop, memo "latte".
Put $50 into NVDA, the way my plan says.
Show me what you spent this week.

If something goes over a limit, Kozu tells you which one and stops. It won't split a purchase to sneak under a cap. To change what it can do, raise the limit in the app.

Take it back

  • Revoke spending in the app stops payments right away.
  • Pause autopilot stops investing right away.
  • Set approval to 0, or revoke on revoke.cash, cuts off the contract's access to your USDG entirely.

Raising or lowering a limit never resets what Kozu already spent today, so you can't accidentally give it a second daily budget.

Launch a token

The launchpad is a fair launch priced in USDG: a fixed 1 billion supply, no team allocation, and liquidity locked forever once it graduates to Uniswap.

  • Fill in a name, ticker and image link, and choose whether trading fees go to your wallet or to Kozu's. Sending them to Kozu lets your agent pay its own way.
  • You earn 70% of every trading fee. If you want tokens yourself, buy them at launch like anyone else, up to 5% of supply.
  • For the first 5 minutes the fee starts at 25% and drops to 1%, and each wallet can buy at most 1% of supply. That keeps snipers out.
  • When the curve sells out, anyone can press Graduate to Uniswap and the liquidity is locked for good.
  • Until it graduates, a token can only be bought from and sold back to the curve, not sent between wallets. That stops anyone setting up a fake-priced pool before the real one.

Your token's page

Every token gets its own live page, and you land on it right after launching. It shows the price chart, every trade as it happens, how close it is to graduating, and buy and sell buttons. Anyone can open it, with or without a wallet, so share the link.

After graduation the page keeps going: it follows the Uniswap pool's trades, and a Collect pool fees button sends the pool's trading fees to the fee wallet (70%) and the platform (30%). Anyone can press it, and the liquidity itself never moves.

No adult content, no real person's or company's name or logo, and no promised returns. Tokens that break these rules are hidden from the site.

Questions

Can Kozu empty my wallet?
No. It can only spend through the contract, within your per-purchase and daily limits, to merchants and assets you approved, and only up to the USDG you approved.
What if Kozu's key is stolen?
The thief gets the same limits Kozu had. Revoke Kozu in the app and set up a new agent wallet.
Why did a stock buy wait on a weekend?
On weekends the contract compares the pool's price with the last price Chainlink reported. If the stock token has moved more than your slippage above that, Kozu waits rather than overpay. It goes through once prices line up again. If you set an asset's price-age limit to 26 hours, weekend buys are refused entirely; the default of 4 days allows them.
Does Kozu cost anything?
You pay the network's gas, usually fractions of a cent, plus your AI agent's own costs. Kozu takes nothing from your payments or investments.
Are the contracts audited?
Not yet. They're tested, but start with small amounts until an independent audit is published.