MCP-Server

AI Agent Tokenized Stock OS

dev.aatos/aatos
Krypto & Web3 Finanzen & Investieren Öffentlich und erreichbar MCP 2025-11-25

Was dieses MCP kann

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).
Eingabeschema
{'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.
Eingabeschema
{'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.
Eingabeschema
{'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.
Eingabeschema
{'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.
Eingabeschema
{'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.
Externer Zugriff
Eingabeschema
{'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.
Eingabeschema
{'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).
Eingabeschema
{'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.
Eingabeschema
{'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.
Eingabeschema
{'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.
Eingabeschema
{'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.
Eingabeschema
{'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.
Nur Lesen Idempotent
Eingabeschema
{'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.
Eingabeschema
{'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.
Eingabeschema
{'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.
Eingabeschema
{'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.
Eingabeschema
{'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.
Eingabeschema
{'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.
Eingabeschema
{'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).
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
stocktoken_policy_set
Update session policy guardrails for AI Agent Tokenized Stock OS.
Eingabeschema
{'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.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema
{'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.
Eingabeschema
{'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.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema
{'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.
Eingabeschema
{'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).
Eingabeschema
{'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.
Eingabeschema
{'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.
Eingabeschema
{'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.
Nur Lesen Externer Zugriff Idempotent
Eingabeschema
{'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.
Eingabeschema
{'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).
Eingabeschema
{'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.
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
stocktoken_system_status
Full system status: secrets, venues, chain, version, session count, fees.
Eingabeschema
{'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.
Eingabeschema
{'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.
Eingabeschema
{'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.
Eingabeschema
{'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.
Eingabeschema
{'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}
Geändert
stocktoken_explain_routing
1. October 2026 02:43
Geändert
stocktoken_find_pools
1. October 2026 02:43
Geändert
stocktoken_liquidity_matrix
1. October 2026 02:43
Geändert
stocktoken_permit2_prepare
1. October 2026 02:43
Geändert
stocktoken_basket_preview
1. October 2026 02:43
Geändert
stocktoken_execute_plan
1. October 2026 02:43
Geändert
stocktoken_simulate
1. October 2026 02:43
Geändert
stocktoken_quote
1. October 2026 02:43
Geändert
stocktoken_value_holdings
1. October 2026 02:43
Geändert
stocktoken_price
1. October 2026 02:43
Geändert
stocktoken_list
1. October 2026 02:43
Hinzugefügt
stocktoken_explain_routing
17. September 2026 12:39
Hinzugefügt
stocktoken_system_status
17. September 2026 12:39
Hinzugefügt
stocktoken_find_pools
17. September 2026 12:39
Hinzugefügt
stocktoken_liquidity_matrix
17. September 2026 12:39
Hinzugefügt
stocktoken_permit2_prepare
17. September 2026 12:39
Hinzugefügt
stocktoken_basket_preview
17. September 2026 12:39
Hinzugefügt
stocktoken_intent_typed_data
17. September 2026 12:39
Hinzugefügt
stocktoken_morpho_withdraw_plan
17. September 2026 12:39
Hinzugefügt
stocktoken_morpho_deposit_plan
17. September 2026 12:39
Hinzugefügt
stocktoken_morpho_position
17. September 2026 12:39
Hinzugefügt
stocktoken_morpho_status
17. September 2026 12:39
Hinzugefügt
stocktoken_metrics
17. September 2026 12:39
Hinzugefügt
stocktoken_tip_plan
17. September 2026 12:39
Hinzugefügt
stocktoken_tip_assets
17. September 2026 12:39
Hinzugefügt
stocktoken_tip_presets
17. September 2026 12:39
Hinzugefügt
stocktoken_subscription_status
17. September 2026 12:39
Hinzugefügt
stocktoken_subscribe_plan
17. September 2026 12:39
Hinzugefügt
stocktoken_subscription_tiers
17. September 2026 12:39
Hinzugefügt
stocktoken_fees
17. September 2026 12:39