
Installation
Four commands
to a living reef
The first run needs nothing but Node and pnpm. No brokerage account, no API key, no card. CORAL starts in paper mode and stays there until you change one variable.
Clone and install
pnpm workspace, Turborepo. Node 22 or newer, because the engine uses the built-in env loader and AbortSignal.timeout.
git clone https://github.com/tobiazlincoln/CORALAGENT.git coral
cd coral
pnpm installSpawn the reef
Writes .coral/reef.db and a .env template in the directory you ran it from. Nothing is created outside it.
pnpm coral init
# reef spawned at .coral/reef.db
# generation 1 · 0 polypsTake a pass, no key needed
Without a model key CORAL uses a deterministic heuristic reasoner. Same pipeline, same risk gate, same polyps. It is a real strategy, not a mock.
pnpm coral trade NVDA,AAPL --budget 200
# observe · reading 2 symbol(s) from synthetic
# recall · pulling polyps that match today's setup
# reason · no model key, deterministic reasoning
# gate · hard limits, non-negotiable
# fill buy NVDA $100.00 @ $182.44Give it a model
Four providers. CORAL falls back to the heuristic if the call fails, so a dead key never stops the reef.
# .env
CORAL_LLM=anthropic
CORAL_MODEL=claude-sonnet-4-5
ANTHROPIC_API_KEY=sk-ant-...
# or openai | google | xaiWire it into your agent
coral connect --all writes every config on this machine and backs up each original first. Or let each host add it natively; the commands below are the ones their own docs give.
| host | how | after |
|---|---|---|
| Claude Code | claude mcp add robinhood-trading --transport http https://agent.robinhood.com/mcp/trading | Then run /mcp and authenticate. |
| Codex CLI | codex mcp add robinhood-trading --url https://agent.robinhood.com/mcp/trading | Then /mcp to sign in. |
| Cursor | Settings → Cursor Settings → Tools & MCPs → Connect | Paste the MCP URL. OAuth is handled by Cursor. |
| Gemini CLI | gemini mcp add robinhood-trading https://agent.robinhood.com/mcp/trading -t http -s user | Server aliases must not contain underscores. |
| Grok | + → Add connector → Custom → paste the MCP URL | The OAuth prompt appears when the connector connects. |
# Claude Code
claude mcp add coral -- pnpm --filter @coral/cli exec tsx src/index.ts serve
# any host that takes a command
{ "command": "npx", "args": ["-y", "tsx", "packages/cli/src/index.ts", "serve"] }
# then, from the agent:
> coral_status reef health
> coral_scan decisions without orders
> coral_trade gated pass (dry run unless confirm:true)
> coral_ask route a natural-language request to a skillThe whole CLI
Eleven surfaces, no hidden modes.
coral initspawn a reef, write .envcoral connect --allregister the MCP in every detected agent hostcoral statuspolyps, generation, limits, connectivitycoral status --skillswhat CORAL can do, and how strong each skill is right nowcoral scan NVDAobserve, reason, gate, place nothingcoral trade NVDA --budget 200one full gated passcoral evolveadvance a generationcoral historyledger and generation logcoral reef 'NVDA oversold'recall, with --why for the scoring breakdowncoral serverun CORAL as an MCP server on stdiocoral agentswhich hosts are detected on this machineBefore you go live
Live trading needs an Agentic account at Robinhood, a token for the hosted MCP, and two separate switches: CORAL_MODE=live in the environment, and limits.allowLive set in code. One of them alone places nothing. That is deliberate.
Read the safety model