Tool reference

Generated directly from each server's live registered tool schemas — this page cannot drift from the actual tools. Regenerate with node scripts/generate-tools-doc.mjs.

hood-mcp — data server (9 tools)

Zero-config, read-only, no wallet required.

get_chain_stats free

Live Robinhood Chain overview: latest block, gas price, TVL, and network totals (blocks, addresses, transactions, block time). No inputs.

No parameters.

list_stock_tokens free

The registry of tokenized-equity Stock Tokens on Robinhood Chain (ticker, name, contract, Chainlink feed). Set pricedOnly to return only tokens with a live feed.

ParamTypeDescription
pricedOnlybooleanOnly tokens with a Chainlink price feed.
limitintegerMax entries (default all).
offsetintegerSkip this many (pagination).

get_stock_quote free

Price a Stock Token by ticker: the Chainlink oracle price, the on-chain Uniswap DEX mid price, the premium/discount between them, and the ERC-8056 multiplier (so you also get the underlying share price).

ParamTypeDescription
symbol requiredstringTicker, e.g. "AAPL" or "TSLA" (case-insensitive).
maxAgeSecondsintegerReject the Chainlink answer if older than this (default 3 days; 24/5 feeds).

get_portfolio free

Multiplier-correct Stock Token portfolio for any address: per-position token balance, ERC-8056 share-equivalent, USD value, plus the USDG cash balance. Read-only.

ParamTypeDescription
address requiredstringWallet address (0x…40 hex) to value.

get_coin free

Detail for any Robinhood Chain token by contract address: price, 24h volume, liquidity, FDV, holder count, and whether it is a registered Stock Token.

ParamTypeDescription
address requiredstringToken contract address (0x…40 hex).

list_trending_coins free

The trending pools on Robinhood Chain right now (memecoins and stocks) with price, 24h volume, price change, and liquidity — the pulse of the chain.

ParamTypeDescription
limitintegerHow many (default 10, max 30).

get_recent_launches free

Recently launched tokens on Robinhood Chain launchpads (NOXA and The Odyssey), newest first, scanned from on-chain logs.

ParamTypeDescription
lookbackBlocksintegerBlocks to scan back (~30k ≈ 1h; default 30000).
launchpadstringRestrict to one launchpad.
limitintegerMax launches to return (default 25).

watch_launches free

Watch NOXA + The Odyssey live for new token launches, blocking up to waitSeconds (or until limit launches are seen), then returns what appeared. Falls back to the most recent launch if none fire in the window.

ParamTypeDescription
waitSecondsintegerHow long to watch (default 20, max 120).
launchpadstringRestrict to one launchpad.
limitintegerStop early after this many (default 20).
includeRecentIfEmptybooleanIf nothing launches in the window, return the latest recent launch (default true).

search_token free

Find tokens on Robinhood Chain by ticker, name, or contract address — searches the Stock Token registry and the Blockscout index together.

ParamTypeDescription
query requiredstringTicker, name fragment, or 0x address.
limitintegerMax results (default 20).

hood-mcp-trading — wallet server (4 tools)

Requires HOOD_MCP_ENABLE_TRADING=1 + a wallet key. See the safety model.

get_my_portfolio read-only

This wallet's holdings on Robinhood Chain: native ETH (gas), USDG cash, and every Stock Token position with multiplier-correct USD value. Read-only.

No parameters.

get_swap_quote read-only

Quote a Uniswap swap on Robinhood Chain without signing: best route, expected output, minimum received at your slippage, and the USD value of the input. Tokens are addresses, Stock Token tickers, or USDG/WETH.

ParamTypeDescription
tokenIn requiredstringInput token: address, ticker (e.g. TSLA), or USDG/WETH.
tokenOut requiredstringOutput token: address, ticker, or USDG/WETH.
amountIn requiredstringHuman amount of tokenIn, e.g. "100" or "0.05".
slippageBpsintegerSlippage tolerance in bps (default 50 = 0.5%).

execute_swap guarded

Swap tokens on Robinhood Chain. First call returns a SIMULATION and requires confirm=true to broadcast. Spend is hard-capped in USD; Stock Token BUYS require eligibility. Approves the router automatically if needed.

ParamTypeDescription
tokenIn requiredstringInput token: address, ticker, or USDG/WETH.
tokenOut requiredstringOutput token: address, ticker, or USDG/WETH.
amountIn requiredstringHuman amount of tokenIn to spend, e.g. "10".
slippageBpsintegerSlippage tolerance in bps (default 50).
confirmbooleanMust be true to actually broadcast. Omit/false to preview.

transfer_usdg guarded

Send USDG to an address. First call returns a preview and requires confirm=true to broadcast. The amount is hard-capped in USD by the same spend limits.

ParamTypeDescription
to requiredstringRecipient address (0x…40 hex).
amount requiredstringHuman USDG amount, e.g. "5.00".
confirmbooleanMust be true to actually broadcast. Omit/false to preview.