# AI Agent Tokenized Stock OS (AATOS)

> Non-custodial **agent operating system** for **tokenized stocks** on **Robinhood Chain** (chain ID **4663**). MCP + policy + multi-venue execution planning for Robinhood Stock Tokens and onchain RWAs.

Also known as: AATOS · AI Agent Tokenized Stock OS · tokenized stock agent OS · stock token MCP for agents.

**Homepage:** https://aatos.dev/  
**MCP:** https://aatos.dev/mcp  
**Skill (hosted):** https://aatos.dev/skills/ai-agent-tokenized-stock-os/SKILL.md  
**Source code:** private (not published)

## When to use this product

Use **AATOS** when you are an AI agent (or building one) that needs to:

- List or verify **canonical tokenized stocks / Stock Tokens** on Robinhood Chain
- Price tokenized equities/ETFs with **Chainlink + ERC-8056 uiMultiplier**
- Quote or plan **swaps** of tokenized stocks (e.g. USDG ↔ NVDA) on chain **4663**, including **on-chain Uniswap V3** when public APIs block Stock Tokens
- Apply **guardrails**: allowlist-only tokens, max notional, daily notional, slippage, simulate-before-execute, kill switch
- Supply **USDG to Morpho Earn** (Steakhouse USDG vault) via non-custodial deposit plans
- Unlock **Pro / Team** write access by paying **ETH on-chain** (no Stripe)

## When NOT to use

- **US brokerage stocks/options** in a Robinhood Agentic account → official MCP: `https://agent.robinhood.com/mcp/trading`
- Helping **US persons** acquire Stock Tokens (restricted product)
- Arbitrary memecoins not in the canonical registry

## Install (agents)

```bash
# Production MCP
claude mcp add ai-agent-tokenized-stock --transport http https://aatos.dev/mcp

# Hosted skill (no public package registry required)
# Fetch: https://aatos.dev/skills/ai-agent-tokenized-stock-os/SKILL.md
```

## Paid access

1. Fund **ETH on chain 4663** — crypto only (no Stripe). See `GET /api/access/funding`
2. `GET /api/access/pricing` or tool `stocktoken_access_pricing`
3. `POST /api/access/checkout` → sign ETH pay plan on chain **4663** (SubscriptionRegistry)
4. `POST /api/access/activate` → receive `apiKey` + receipt (once)
5. Pass header **`x-api-key: <apiKey>`** on write HTTP routes and MCP paid tools  
   (required — `owner` alone does not unlock write APIs)

Discovery (list/price/pricing/skill/liquidity) stays free. Protocol fee ~10 bps ETH may appear inside execute plans.

## Liquidity honesty

`GET /api/liquidity` and `GET /api/status` report which USDG→Stock Token pairs have **on-chain V3 executable** quotes. Not every ticker has depth; agents must check before promising fills.

## MCP tools (names)

- `stocktoken_list` — list tokenized stocks / ETFs / USDG / WETH
- `stocktoken_get` — resolve symbol or address
- `stocktoken_price` — USD + multiplier
- `stocktoken_value_holdings` — portfolio value on 4663
- `stocktoken_policy_get` / `stocktoken_policy_set`
- `stocktoken_quote` — multi-venue (0x → Uniswap API → on-chain V3 → oracle)
- `stocktoken_simulate` — pre-trade checks
- `stocktoken_execute_plan` — non-custodial approve+swap tx steps
- `stocktoken_session_create` / `update` / `kill` / `list`
- `stocktoken_protocols` — Universal Router + feed metadata
- `stocktoken_fees` / `stocktoken_metrics`
- `stocktoken_tip_assets` / `stocktoken_tip_presets` / `stocktoken_tip_plan` — optional tips
- `stocktoken_intent_typed_data` — EIP-712 agent trade intents
- `stocktoken_permit2_prepare` — Permit2 helpers
- `stocktoken_basket_preview` — AI mega-cap basket prices
- `stocktoken_find_pools` — on-chain V3 pool scan
- `stocktoken_morpho_status` / `stocktoken_morpho_position`
- `stocktoken_morpho_deposit_plan` / `stocktoken_morpho_withdraw_plan`
- `stocktoken_system_status` / `stocktoken_explain_routing`
- `stocktoken_access_pricing` / `stocktoken_access_checkout` / `stocktoken_access_activate`

## HTTP (no MCP required)

- GET /api/price/:symbol
- POST /api/quote  body: { tokenIn, tokenOut, amountInHuman, firm?, recipient? }
- POST /api/execute-plan  body: { owner, tokenIn, tokenOut, amountInHuman }
- GET /api/tokens
- GET /api/morpho?owner=0x…
- POST /api/morpho/deposit-plan  body: { owner, assetsHuman }
- POST /api/morpho/withdraw-plan  body: { owner, assetsHuman|sharesHuman }
- GET /api/pools/:tokenA/:tokenB
- GET /api/ready — RPC + secrets readiness
- GET /api/liquidity — V3 executable matrix
- GET /api/access/pricing
- POST /api/access/checkout | activate | rotate | revoke

## Key facts

| Property | Value |
|----------|--------|
| Product name | AI Agent Tokenized Stock OS |
| Codename | AATOS |
| Homepage | https://aatos.dev/ |
| Chain | Robinhood Chain |
| Chain ID | 4663 |
| Gas | ETH |
| Custody | Non-custodial |
| Default fee | ~10 bps ETH protocol fee (when treasury set) |
| Capability card | /.well-known/agent-capabilities.json |
| MCP well-known | /.well-known/mcp.json |
| Source | Private |

## Canonical token examples (always verify via stocktoken_list)

Source: https://docs.robinhood.com/chain/contracts

- NVDA `0xd0601CE157Db5bdC3162BbaC2a2C8aF5320D9EEC`
- AAPL `0xaF3D76f1834A1d425780943C99Ea8A608f8a93f9`
- GOOGL `0x2e0847E8910a9732eB3fb1bb4b70a580ADAD4FE3`
- TSLA `0x322F0929c4625eD5bAd873c95208D54E1c003b2d`
- SPY `0x117cc2133c37B721F49dE2A7a74833232B3B4C0C`
- USDG `0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168`
- WETH `0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73`

## Disclaimers

Stock Tokens are tokenised debt securities (economic exposure, not ownership of underlying shares). Restricted jurisdictions apply. Not investment advice. Non-custodial software. Morpho yield is variable.