MCP Server

AI Agent Tokenized Stock OS

dev.aatos/aatos
Crypto & Web3 Finance & Investing Public & reachable MCP 2025-11-25

What this MCP does

Provides quotes, metadata, liquidity checks, simulations, and non-custodial transaction plans for tokenized stocks and DeFi products on Robinhood Chain.

stocktoken_access_activate
After ETH payment to treasury is confirmed, verify and issue API key (shown once).
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['owner'], 'properties': {'tier': {'enum': ['pro', 'team'], 'type': 'string', 'default': 'pro'}, 'owner': {'type': 'string'}, 'txHash': {'type': 'string'}}, 'additionalProperties': False}
stocktoken_access_checkout
Build on-chain ETH payment plan for Pro/Team. After user pays, call stocktoken_access_activate.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['owner'], 'properties': {'tier': {'enum': ['pro', 'team'], 'type': 'string', 'default': 'pro'}, 'owner': {'type': 'string'}}, 'additionalProperties': False}
stocktoken_access_pricing
List Free / Pro / Team pricing (ETH on-chain, no Stripe) and how agents pay for write tools.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
stocktoken_access_status
Check paid access for current API key context or a wallet owner.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'owner': {'type': 'string'}}, 'additionalProperties': False}
stocktoken_basket_preview
Preview basket prices only. This does not swap and it is not a vault deposit. For one Stock Token, use stocktoken_quote then stocktoken_execute_plan.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
stocktoken_execute_plan
Build an unsigned swap plan on chain 4663. Picks the executable venue with the higher amountOut (v4, v3, 0x, or Uniswap API). Steps are an ETH fee of about 10 bps, token approve, and the swap. v4 also adds a Permit2 approval. Does NOT sign or broadcast. Pro required. The user signs. A v4 plan expires 30 minutes after it is built.
Open world
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['owner', 'tokenIn', 'tokenOut'], 'properties': {'owner': {'type': 'string', 'description': '0x wallet on chain 4663 that will sign. Not an API key.'}, 'tokenIn': {'type': 'string', 'description': 'Registry symbol or address, usually USDG'}, 'amountIn': {'type': 'string', 'description': 'Raw amount in. One of amountIn or amountInHuman is required.'}, 'tokenOut': {'type': 'string', 'description': 'Registry symbol or address, e.g. NVDA'}, 'sessionId': {'type': 'string', 'description': 'Existing session id, if one was created'}, 'approveMax': {'type': 'boolean', 'description': 'Unlimited allowance. Leave false.'}, 'notionalUsd': {'type': 'number', 'description': 'USD notional for the policy check', 'exclusiveMinimum': 0}, 'slippageBps': {'type': 'integer', 'description': 'Slippage in basis points. Default 50.'}, 'amountInHuman': {'type': 'string', 'description': 'Human amount, e.g. "10"'}}, 'additionalProperties': False}
stocktoken_explain_routing
Start here. Brokerage equities go to Robinhood Trading MCP. Stock Tokens on chain 4663 stay here: stocktoken_list, stocktoken_price, stocktoken_quote, stocktoken_execute_plan.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'userIntent': {'type': 'string'}}, 'additionalProperties': False}
stocktoken_fees
Summarize disclosed AATOS execution fee events and on-chain monetization status (treasury / ETH fees).
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
stocktoken_find_pools
Scan Uniswap v3 pool addresses only. This is not a fill check and it does not see v4. For a swap, use stocktoken_quote then stocktoken_execute_plan.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['tokenA', 'tokenB'], 'properties': {'tokenA': {'type': 'string'}, 'tokenB': {'type': 'string'}}, 'additionalProperties': False}
stocktoken_get
Get metadata for one canonical Stock Token or core asset by symbol (e.g. NVDA) or contract address on Robinhood Chain 4663. Use to verify a token is official before trading.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['symbolOrAddress'], 'properties': {'symbolOrAddress': {'type': 'string', 'description': 'Ticker like NVDA or 0x contract address'}}, 'additionalProperties': False}
stocktoken_intent_typed_data
Build EIP-712 typed data for an agent trade intent (offchain authorization standard). User/wallet signs; onchain verifier later.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['sessionId', 'owner', 'tokenIn', 'tokenOut', 'amountIn'], 'properties': {'nonce': {'type': 'integer', 'minimum': 0}, 'owner': {'type': 'string'}, 'tokenIn': {'type': 'string', 'description': 'Symbol or address'}, 'amountIn': {'type': 'string'}, 'tokenOut': {'type': 'string'}, 'sessionId': {'type': 'string'}, 'deadlineSec': {'type': 'integer', 'exclusiveMinimum': 0}, 'minAmountOut': {'type': 'string', 'default': '0'}}, 'additionalProperties': False}
stocktoken_liquidity_matrix
Liquidity matrix for major USDG pairs on chain 4663. each row reports hookless Uniswap v4 and on-chain v3. eitherExecutable true means at least one of those can fill the sample size. A false row is not every pool on earth: hooked v4 pools are not scanned. If stocktoken_quote.executable is false, do not promise a fill.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
stocktoken_list
List canonical Stock Tokens, ETFs, USDG, and WETH on Robinhood Chain 4663. Use this before trusting any address. Do NOT use for US brokerage equities (use Robinhood Trading MCP). Only registry addresses are real tokenized stocks.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'kind': {'enum': ['stock', 'etf', 'stable', 'wrapped_native', 'all'], 'type': 'string', 'description': 'Filter by token kind. Use stock for Stock Tokens. Default all.'}}, 'additionalProperties': False}
stocktoken_metrics
Operational metrics for this AI Agent Tokenized Stock OS process.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
stocktoken_morpho_deposit_plan
Build non-custodial ERC-4626 deposit plan (approve USDG + deposit) into Morpho Steakhouse Earn vault. Does NOT broadcast.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['owner'], 'properties': {'owner': {'type': 'string'}, 'assets': {'type': 'string', 'description': 'Raw USDG amount (6 decimals)'}, 'approveMax': {'type': 'boolean'}, 'assetsHuman': {'type': 'string', 'description': 'Human USDG amount e.g. "100"'}}, 'additionalProperties': False}
stocktoken_morpho_position
Read a wallet's Morpho Earn (steakUSDG) share balance and underlying USDG on chain 4663.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['owner'], 'properties': {'owner': {'type': 'string', 'description': '0x wallet address'}}, 'additionalProperties': False}
stocktoken_morpho_status
Morpho / Robinhood Earn status on chain 4663: Steakhouse USDG vault address, live TVL, share price.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
stocktoken_morpho_withdraw_plan
Build non-custodial Morpho Earn withdraw (by USDG) or redeem (by shares) plan. Does NOT broadcast.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['owner'], 'properties': {'owner': {'type': 'string'}, 'assets': {'type': 'string'}, 'shares': {'type': 'string'}, 'assetsHuman': {'type': 'string'}, 'sharesHuman': {'type': 'string'}}, 'additionalProperties': False}
stocktoken_permit2_prepare
Optional Permit2 helper. stocktoken_execute_plan already includes the Permit2 approval on a v4 route. Use this only when you are assembling a plan by hand.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['token'], 'properties': {'token': {'type': 'string', 'description': 'Token symbol or address to approve via Permit2'}, 'permitData': {'description': 'Optional Uniswap quote.permitData to normalize for signing'}}, 'additionalProperties': False}
stocktoken_policy_get
Get current AI Agent Tokenized Stock OS agent policy (max notional, slippage, simulate-first, kill switch).
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
stocktoken_policy_set
Update session policy guardrails for AI Agent Tokenized Stock OS.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'killed': {'type': 'boolean'}, 'allowedSymbols': {'type': 'array', 'items': {'type': 'string'}}, 'maxNotionalUsd': {'type': 'number', 'exclusiveMinimum': 0}, 'maxSlippageBps': {'type': 'integer', 'maximum': 5000, 'minimum': 1}, 'requireSimulate': {'type': 'boolean'}, 'maxDailyNotionalUsd': {'type': 'number', 'exclusiveMinimum': 0}}, 'additionalProperties': False}
stocktoken_price
Read the Chainlink USD price and ERC-8056 uiMultiplier for one registry token on chain 4663. This is not a swap quote and not a brokerage quote. Use stocktoken_quote when you need amountOut.
Read only Open world Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['symbolOrAddress'], 'properties': {'symbolOrAddress': {'type': 'string', 'description': 'Ticker like NVDA or a 0x registry address'}}, 'additionalProperties': False}
stocktoken_protocols
Return Uniswap Universal Router, PoolManager, WETH, USDG, and feed source metadata for Robinhood Chain 4663.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
stocktoken_quote
Quote a Stock Token swap on chain 4663. Compares 0x, the Uniswap API, on-chain Uniswap v3, and hookless Uniswap v4, and returns the executable route with the higher amountOut. If none is executable, the result is oracle-indicative and is not a fill. Pro required. Does not sign or broadcast.
Read only Open world Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['tokenIn', 'tokenOut'], 'properties': {'firm': {'type': 'boolean', 'description': 'Request firm 0x calldata when possible. Default true.'}, 'tokenIn': {'type': 'string', 'description': 'Registry symbol or 0x address, e.g. USDG'}, 'amountIn': {'type': 'string', 'description': 'Raw token units. Use this or amountInHuman.'}, 'tokenOut': {'type': 'string', 'description': 'Registry symbol or 0x address, e.g. NVDA'}, 'recipient': {'type': 'string', 'description': '0x recipient. v3 uses it. v4 pays the signing wallet.'}, 'notionalUsd': {'type': 'number', 'description': 'Optional USD notional for policy. Not the swap size.'}, 'slippageBps': {'type': 'integer', 'description': 'Slippage in basis points. Default 50.'}, 'amountInHuman': {'type': 'string', 'description': 'Human amount, e.g. "25" USDG'}}, 'additionalProperties': False}
stocktoken_session_create
Create a durable agent session with scoped permissions (persisted to DATA_DIR). Non-custodial.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['owner'], 'properties': {'owner': {'type': 'string'}, 'ttlHours': {'type': 'number', 'exclusiveMinimum': 0}, 'sessionKey': {'type': 'string'}, 'permissions': {'type': 'array', 'items': {'enum': ['read', 'quote', 'swap', 'set_policy', 'admin'], 'type': 'string'}}, 'maxNotionalUsd': {'type': 'number', 'exclusiveMinimum': 0}, 'allowlistSymbols': {'type': 'array', 'items': {'type': 'string'}}, 'maxDailyNotionalUsd': {'type': 'number', 'exclusiveMinimum': 0}}, 'additionalProperties': False}
stocktoken_session_kill
Kill an agent session immediately (kill switch).
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['sessionId'], 'properties': {'sessionId': {'type': 'string'}}, 'additionalProperties': False}
stocktoken_session_list
List agent sessions, optionally filtered by owner.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'owner': {'type': 'string'}}, 'additionalProperties': False}
stocktoken_session_update
Update limits/permissions on an existing session.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['sessionId'], 'properties': {'sessionId': {'type': 'string'}, 'permissions': {'type': 'array', 'items': {'enum': ['read', 'quote', 'swap', 'set_policy', 'admin'], 'type': 'string'}}, 'maxNotionalUsd': {'type': 'number', 'exclusiveMinimum': 0}, 'allowlistSymbols': {'type': 'array', 'items': {'type': 'string'}}, 'maxDailyNotionalUsd': {'type': 'number', 'exclusiveMinimum': 0}}, 'additionalProperties': False}
stocktoken_simulate
Pre-trade check on chain 4663: allowlist, policy limits, and whether the quote is executable. This is not an eth_call of the swap. Pro required. If executable is false, stop and do not promise a fill.
Read only Open world Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['tokenIn', 'tokenOut', 'notionalUsd'], 'properties': {'tokenIn': {'type': 'string', 'description': 'Registry symbol or 0x address'}, 'amountIn': {'type': 'string', 'description': 'Raw amount in. Optional if amountInHuman is set.'}, 'tokenOut': {'type': 'string', 'description': 'Registry symbol or 0x address'}, 'sessionId': {'type': 'string', 'description': 'Existing session id, if one was created'}, 'notionalUsd': {'type': 'number', 'description': 'USD notional the policy should check', 'exclusiveMinimum': 0}, 'slippageBps': {'type': 'integer', 'description': 'Max slippage in basis points. Default 50.'}, 'amountInHuman': {'type': 'string', 'description': 'Human amount, e.g. "10"'}}, 'additionalProperties': False}
stocktoken_subscribe_plan
Build non-custodial ETH subscription plan (tier pro|team, or custom ethAmount). Pays treasury on chain 4663.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['owner'], 'properties': {'tier': {'type': 'string', 'description': 'pro | team — preferred over raw ethAmount'}, 'owner': {'type': 'string'}, 'ethAmount': {'type': 'string', 'description': 'Custom ETH amount if not using a named tier, e.g. "0.01"'}}, 'additionalProperties': False}
stocktoken_subscription_status
Check on-chain subscription status for a wallet (requires SUBSCRIPTION_REGISTRY_ADDRESS when deployed).
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['owner'], 'properties': {'owner': {'type': 'string'}}, 'additionalProperties': False}
stocktoken_subscription_tiers
List AATOS on-chain subscription tiers (paid in ETH to treasury). No Stripe.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
stocktoken_system_status
Full system status: secrets, venues, chain, version, session count, fees.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
stocktoken_tip_assets
What the AATOS tip wallet can accept: native ETH + any ERC-20 on Robinhood Chain 4663; optional native BTC address if configured.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
stocktoken_tip_plan
Build OPTIONAL tip plan. asset=ETH (default) | BTC | registry symbol (USDG,WETH,NVDA,…) | 0x token. amount or ETH preset. User must confirm. Never coerce.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['owner'], 'properties': {'memo': {'type': 'string', 'description': 'Short reason for the tip'}, 'asset': {'type': 'string', 'description': 'ETH | BTC | USDG | WETH | NVDA | … or 0x token address'}, 'owner': {'type': 'string'}, 'amount': {'type': 'string', 'description': 'Human amount e.g. "0.001" ETH or "5" USDG or "0.00005" BTC'}, 'preset': {'type': 'string', 'description': 'ETH only: thanks | helpful | excellent'}, 'ethAmount': {'type': 'string', 'description': 'Alias for amount when asset is ETH'}}, 'additionalProperties': False}
stocktoken_tip_presets
List optional tip presets (ETH) and what assets the tip wallet accepts (ETH, any ERC-20 on 4663, optional native BTC). Tips never required.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
stocktoken_value_holdings
Read balances. This does not quote or swap. For a trade, use stocktoken_quote then stocktoken_execute_plan.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['owner'], 'properties': {'owner': {'type': 'string', 'description': '0x wallet address'}, 'symbols': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}
Changed
stocktoken_explain_routing
Oct. 1, 2026, 2:43 a.m.
Changed
stocktoken_find_pools
Oct. 1, 2026, 2:43 a.m.
Changed
stocktoken_liquidity_matrix
Oct. 1, 2026, 2:43 a.m.
Changed
stocktoken_permit2_prepare
Oct. 1, 2026, 2:43 a.m.
Changed
stocktoken_basket_preview
Oct. 1, 2026, 2:43 a.m.
Changed
stocktoken_execute_plan
Oct. 1, 2026, 2:43 a.m.
Changed
stocktoken_simulate
Oct. 1, 2026, 2:43 a.m.
Changed
stocktoken_quote
Oct. 1, 2026, 2:43 a.m.
Changed
stocktoken_value_holdings
Oct. 1, 2026, 2:43 a.m.
Changed
stocktoken_price
Oct. 1, 2026, 2:43 a.m.
Changed
stocktoken_list
Oct. 1, 2026, 2:43 a.m.
Added
stocktoken_explain_routing
Sept. 17, 2026, 12:39 p.m.
Added
stocktoken_system_status
Sept. 17, 2026, 12:39 p.m.
Added
stocktoken_find_pools
Sept. 17, 2026, 12:39 p.m.
Added
stocktoken_liquidity_matrix
Sept. 17, 2026, 12:39 p.m.
Added
stocktoken_permit2_prepare
Sept. 17, 2026, 12:39 p.m.
Added
stocktoken_basket_preview
Sept. 17, 2026, 12:39 p.m.
Added
stocktoken_intent_typed_data
Sept. 17, 2026, 12:39 p.m.
Added
stocktoken_morpho_withdraw_plan
Sept. 17, 2026, 12:39 p.m.
Added
stocktoken_morpho_deposit_plan
Sept. 17, 2026, 12:39 p.m.
Added
stocktoken_morpho_position
Sept. 17, 2026, 12:39 p.m.
Added
stocktoken_morpho_status
Sept. 17, 2026, 12:39 p.m.
Added
stocktoken_metrics
Sept. 17, 2026, 12:39 p.m.
Added
stocktoken_tip_plan
Sept. 17, 2026, 12:39 p.m.
Added
stocktoken_tip_assets
Sept. 17, 2026, 12:39 p.m.
Added
stocktoken_tip_presets
Sept. 17, 2026, 12:39 p.m.
Added
stocktoken_subscription_status
Sept. 17, 2026, 12:39 p.m.
Added
stocktoken_subscribe_plan
Sept. 17, 2026, 12:39 p.m.
Added
stocktoken_subscription_tiers
Sept. 17, 2026, 12:39 p.m.
Added
stocktoken_fees
Sept. 17, 2026, 12:39 p.m.