# Cubicle

> Cubicle: trading tools for AI agents and the people they work for. Turn a trading rule into a deterministic state machine and rehearse it on real candles, read the tape (NQ, ES, YM, BTC, ETH, SOL), study and follow trading models with verifiable records (copy-trading), hire the house Accumulate strategy to run your own Robinhood Chain vault (spot, USDG) that only you control, and pay for a plan on chain from your own wallet (pro-50: 50 USDG per 30 days, the cheapest plan, no card, no human in the loop).

## Connect an agent

- MCP server (streamable HTTP): https://cubicle.algotrada.com/deck/api/mcp
- Per-service MCP endpoints: studio https://cubicle.algotrada.com/deck/api/mcp/studio; candles https://cubicle.algotrada.com/deck/api/mcp/candles; copy https://cubicle.algotrada.com/deck/api/mcp/copy
- MCP server card: https://cubicle.algotrada.com/.well-known/mcp/server-card.json · A2A agent card: https://cubicle.algotrada.com/.well-known/agent-card.json
- No key needed for: initialize, tools/list, catalogue, plans, strategies, strategy_quote, price
- OpenAPI (HTTP routes): https://cubicle.algotrada.com/deck/api/openapi.json (also .yaml)
- A free key: https://cubicle.algotrada.com/deck/join?from=agent (or POST https://cubicle.algotrada.com/deck/api/join); send it as `Authorization: Bearer <key>`

## Pay for a plan (on chain, no card)

1. Call the `plans` tool with a plan id: it returns the price and the exact USDG transfer on Robinhood Chain (chain 4663).
2. Send it from your own wallet; nothing is signed by Cubicle.
3. Sign the claim message the `plans` tool gives you with the paying wallet and call `plan_claim`.
Plans page: https://cubicle.algotrada.com/deck/plans

## Vaults

- Robinhood Chain vaults (mainnet, USDG): open to any wallet since 2026-10-07 (no invite list, no deposit cap), owner-only control (only the owner deposits, withdraws, revokes or freezes), a hired strategy trades under a signed mandate with per-order and open caps, and the house Accumulate operator is live for hire; the contracts are not externally audited yet, so deposit only what you can afford to lose.
- `vault_prepare` returns the unsigned transactions; the owner's wallet signs them.

## Free tools

- `catalogue`: The whole Cubicle API as data: the studio's eight-state machine and what each gate asks, every tool with the tier that opens it (and whether it is open to the caller), and the flows. Call it first when asked what Cubicle can do.
- `plans`: The Cubicle plans (price per 30 days, what each includes) and exactly how to pay on Robinhood Chain in USDG: the treasury, the token, and — when the subscription vault is live — the two wallet transactions (approve, subscribe) that renew automatically every 30 days. Nothing here moves money: the trader signs in their own wallet.
- `strategies`: The strategies anyone can rent to run a Cubicle spot vault (today: accumulate, which buys a fixed amount of ETH or BTC on an interval up to a budget and never sells): what each does, its parameters, the venues and assets, the limits the vault itself enforces, the fee, how to rent it, and its honest status (not live with real funds yet).
- `price`: FREE, no key, no sign-in: the tape's latest price for one market (NQ, ES, YM, BTC, ETH or SOL) with the time of that 1-minute close and whether the tape is stale. Use it whenever an agent needs a current price; it is the same tape every Cubicle vault checks its orders against. For a window of candles use tape (needs a key).
- `strategy_quote`: A live quote for one accumulate buy on Robinhood Chain: what a USD amount of USDG buys of ETH or BTC on the best Uniswap route right now, the tape's price, the cost against the tape in bps, and whether the vault's own price rule (at most 1% worse than the tape) would accept it. A static call: nothing is signed or sent.

## Tools with a key

- `account`: The caller's Cubicle account: their tier (free, Cubicle Operators holder, pro-50, max premium-99), their plan and until when, and every capability with whether it is open and which tier opens it.
- `plan_claim`: Claim a plan you paid for on chain: give the payment's transaction hash and the paying wallet's EIP-191 signature over the exact message the plans tool returns ("Cubicle plan claim\nagent: <your agent id>\ntx: <tx hash>").
- `models`: The trading LLM models on the Taifoon venue a trader can study and, on the max plan, follow: each with its status (trading or stopped, derived from its last trade), markets, fills, realized PnL and win rate — all read from the venue, never from a model's words.
- `desk_read`: The house Nemotron desk (llm-nemotron-fest) as it is: its last turn (every 30 minutes), each market's decision and which reader decided it (the vote rule the Nemotron answers, or Jev), the facts it read, and the venue's own positions with realised and unrealised PnL.
- `model_record`: One trading model's record from the venue's first-in-first-out paired closes: realized PnL, maximum drawdown, win rate, per market, and the window.
- `follow_quote`: Quote following a trading model (max plan): checks the model is live and followable, validates the follower's sizing (fixed_notional usd, or proportional bps of their balance) and caps (max_notional_usd, max_open_positions, max_daily_loss_usd, markets the model trades), and shows what one mirror would be at the given balance.
- `my_vaults`: The caller's trading vaults, read from the chain: each with whether its funds are devnet (test money) or mainnet (real), what is in it, what is free, what is set aside as margin, the mandate and who administers it..
- `vault_prepare`: The wallet steps for a Cubicle vault as UNSIGNED transactions and EIP-712 typed data for the owner's own wallet.
- `workflow_read`: Read a trading idea the way the studio does: the deterministic reader fills the 7 parts (markets, trigger, direction, stand aside, stop, target, session) from the trader's OWN words and says which required parts are still missing.
- `studio_move`: Move the trader's rule through the studio's state machine when forge is refused: score_parts (Jev scores clarity — needs the trader's own TypeSafe key), accept_parts (the trader accepts the rule as read, without a Jev score), choose_coverage with choice approximate (build from the gates the tape can measure) or stop, reset (start over).
- `forge`: The studio machine's FORGED move: compiles the trader's strategy from the gates the tape can measure.
- `grade`: Grade a forge with Jev (RUBRIC_v1): code checks the facts first, then Jev answers whether the code does what the trader said.
- `rehearse`: Walk a forged machine over the real tape with the canonical stepper (the last week by default): how many trades it took, the R, and a comparison with a random null.
- `tape`: Read real candles from the Taifoon tape for one market.
- `forecast`: The envelope the forecast sidecar had issued for one market and timeframe by a given time: a MAGNITUDE band (how far price may travel over the next 24 bars, as two prices and a width in ATR), the odds of a move of 0.5, 1 and 2 ATR within 6, 12 and 24 bars, and its measured calibration (ece, n, band coverage).
- `chart_state`: What the deck's chart would show for one market, timeframe and window, as ONE JSON object computed in code: the bars (count, first and last, the last candle), the indicators drawn, the trader's own marked levels and zones (theirs — they may be used as levels the trader gave), the envelope under its draw gate and its facts, and the fact sheet of the window (open, close, high, low, range, change, volume, session).
- `chart_image`: The deck's own chart plate for one market, timeframe and window, rendered server-side from the same geometry the screen uses (bars, indicators, the envelope cone when its calibration permits) as a PNG you can look at, together with the chart_state JSON for the same window.
- `image`: Look at a chart the trader attached (the id is in the studio state).
- `skills`: List the Cubicle skill bank: every skill's name, family, grade and status (runnable / stub / concluded).
- `skill_read`: Read one skill's method (its SKILL.md) — only the methodology and engineering skills are readable; strategy, lens, pillar and copy skills are sealed and will be refused..

## Identity

- Cubicle studio: ERC-8004 agent 96558 on Base, card https://cubicle.algotrada.com/deck/api/cards/studio
- Cubicle candles: ERC-8004 agent 96559 on Base, card https://cubicle.algotrada.com/deck/api/cards/candles
- Cubicle copy-trading: ERC-8004 agent 96560 on Base, card https://cubicle.algotrada.com/deck/api/cards/copy