Servers Playground How we check Add a server Log in

AI Agent Tokenized Stock OS

Working · 1.3 s

dev.aatos/aatosv1.1.0 Domain verified

Non-custodial MCP for Stock Tokens on Robinhood Chain (4663): quotes, plans, Morpho Earn.

Crypto & Web3 Finance & Payments

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://aatos.dev/mcp

x-api-key (optional)

Pro/Team API key from on-chain checkout (optional for free tools)

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

stocktoken_access_activate

After ETH payment to treasury is confirmed, verify and issue API key (shown once).

ownerstring, required

tierstring

txHashstring

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

AI Agent Tokenized Stock OS MCP server | mcptry

Tools (37)

stocktoken_access_activate

After ETH payment to treasury is confirmed, verify and issue API key (shown once).

Argument	Type	Description
tier	string
owner*	string
txHash	string

Input schema (JSON)

{
  "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.

Argument	Type	Description
tier	string
owner*	string

Input schema (JSON)

{
  "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.

No arguments.

Input schema (JSON)

{
  "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.

Argument	Type	Description
owner	string

Input schema (JSON)

{
  "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.

No arguments.

Input schema (JSON)

{
  "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.

Argument	Type	Description
owner*	string	0x wallet on chain 4663 that will sign. Not an API key.
tokenIn*	string	Registry symbol or address, usually USDG
amountIn	string	Raw amount in. One of amountIn or amountInHuman is required.
tokenOut*	string	Registry symbol or address, e.g. NVDA
sessionId	string	Existing session id, if one was created
approveMax	boolean	Unlimited allowance. Leave false.
notionalUsd	number	USD notional for the policy check
slippageBps	integer	Slippage in basis points. Default 50.
amountInHuman

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.

Argument	Type	Description
userIntent	string

Input schema (JSON)

{
  "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).

No arguments.

Input schema (JSON)

{
  "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.

Argument	Type	Description
tokenA*	string
tokenB*	string

Input schema (JSON)

{
  "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.

Argument	Type	Description
symbolOrAddress*	string	Ticker like NVDA or 0x contract address

Input schema (JSON)

{
  "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.

Argument	Type	Description
nonce	integer
owner*	string
tokenIn*	string	Symbol or address
amountIn*	string
tokenOut*	string
sessionId*	string
deadlineSec	integer
minAmountOut	string

Input schema (JSON)

{
  "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.

No arguments.

Input schema (JSON)

{
  "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

Argument	Type	Description
kind	string	Filter by token kind. Use stock for Stock Tokens. Default all.

Input schema (JSON)

{
  "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.

No arguments.

Input schema (JSON)

{
  "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.

Argument	Type	Description
owner*	string
assets	string	Raw USDG amount (6 decimals)
approveMax	boolean
assetsHuman	string	Human USDG amount e.g. "100"

Input schema (JSON)

{
  "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.

Argument	Type	Description
owner*	string	0x wallet address

Input schema (JSON)

{
  "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.

No arguments.

Input schema (JSON)

{
  "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.

Argument	Type	Description
owner*	string
assets	string
shares	string
assetsHuman	string
sharesHuman	string

Input schema (JSON)

{
  "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.

Argument	Type	Description
token*	string	Token symbol or address to approve via Permit2
permitData	any	Optional Uniswap quote.permitData to normalize for signing

Input schema (JSON)

{
  "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).

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

stocktoken_policy_set

Update session policy guardrails for AI Agent Tokenized Stock OS.

Argument	Type	Description
killed	boolean
allowedSymbols	array
maxNotionalUsd	number
maxSlippageBps	integer
requireSimulate	boolean
maxDailyNotionalUsd	number

Input schema (JSON)

{
  "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

Argument	Type	Description
symbolOrAddress*	string	Ticker like NVDA or a 0x registry address

Input schema (JSON)

{
  "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.

No arguments.

Input schema (JSON)

{
  "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

Argument	Type	Description
firm	boolean	Request firm 0x calldata when possible. Default true.
tokenIn*	string	Registry symbol or 0x address, e.g. USDG
amountIn	string	Raw token units. Use this or amountInHuman.
tokenOut*	string	Registry symbol or 0x address, e.g. NVDA
recipient	string	0x recipient. v3 uses it. v4 pays the signing wallet.
notionalUsd	number	Optional USD notional for policy. Not the swap size.
slippageBps	integer	Slippage in basis points. Default 50.
amountInHuman	string	Human amount, e.g. "25" USDG

stocktoken_session_create

Create a durable agent session with scoped permissions (persisted to DATA_DIR). Non-custodial.

Argument	Type	Description
owner*	string
ttlHours	number
sessionKey	string
permissions	array
maxNotionalUsd	number
allowlistSymbols	array
maxDailyNotionalUsd	number

Input schema (JSON)

{
  "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).

Argument	Type	Description
sessionId*	string

Input schema (JSON)

{
  "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.

Argument	Type	Description
owner	string

Input schema (JSON)

{
  "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.

Argument	Type	Description
sessionId*	string
permissions	array
maxNotionalUsd	number
allowlistSymbols	array
maxDailyNotionalUsd	number

Input schema (JSON)

{
  "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

Argument	Type	Description
tokenIn*	string	Registry symbol or 0x address
amountIn	string	Raw amount in. Optional if amountInHuman is set.
tokenOut*	string	Registry symbol or 0x address
sessionId	string	Existing session id, if one was created
notionalUsd*	number	USD notional the policy should check
slippageBps	integer	Max slippage in basis points. Default 50.
amountInHuman	string	Human amount, e.g. "10"

Input schema (JSON)

{
  "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.

Argument	Type	Description
tier	string	pro \| team — preferred over raw ethAmount
owner*	string
ethAmount	string	Custom ETH amount if not using a named tier, e.g. "0.01"

Input schema (JSON)

{
  "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).

Argument	Type	Description
owner*	string

Input schema (JSON)

{
  "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.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

stocktoken_system_status

Full system status: secrets, venues, chain, version, session count, fees.

No arguments.

Input schema (JSON)

{
  "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.

No arguments.

Input schema (JSON)

{
  "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.

Argument	Type	Description
memo	string	Short reason for the tip
asset	string	ETH \| BTC \| USDG \| WETH \| NVDA \| … or 0x token address
owner*	string
amount	string	Human amount e.g. "0.001" ETH or "5" USDG or "0.00005" BTC
preset	string	ETH only: thanks \| helpful \| excellent
ethAmount	string	Alias for amount when asset is ETH

Input schema (JSON)

{
  "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.

No arguments.

Input schema (JSON)

{
  "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.

Argument	Type	Description
owner*	string	0x wallet address
symbols	array

Input schema (JSON)

{
  "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
}