Every tool an AI assistant can call on Trade Echo MCP, with its parameters and credit cost. Market intel and My Account tools are read-only. A default connection sees 26 tools; adding SEC filings makes 28; turning on My Account makes 31. Paid members can also turn on Trading (in beta), which adds 10 order and trade plan tools to that connection.
Descriptions below are the same text your assistant receives when it lists tools, so they are written for an AI reader. Each call spends credits from your hourly budget; see typical limits. Parameter names are what the assistant sends; you just ask in plain language.
Tools marked Places orders belong to Trading, which is in beta for every paid plan, off by default and turned on one connection at a time. Read-only tools only read data, and Preview only tools check an order or plan without sending anything to your broker. The assistant previews every order first and places it only after you say yes in the chat. By default you also confirm each order in Trade Echo (a push opens the confirm screen) before it goes to your broker, and an unconfirmed order expires unsent after 5 minutes. You can turn this off per connection for automations you trust. Orders placed through an assistant are real orders with real money. You are responsible for every order you approve. See the trading terms.
Option Flow
flow.readDefault
Unusual options flow, Discovery noteworthy flow, and sector premium summaries.
Trade Echo Discovery Noteworthy Flow - the ranked, OI-confirmed institutional options prints ledger for ONE trading session (score, ticker, strike, expiration, fill price, premium, trade time ET, flags). Defaults to the most recent session that has a ledger (on a weekend or before 9:25 ET that is the last trading day); pass `date` for a specific past session. Every clause of a member's question maps to a parameter - use max_dte_days, time_from/time_to (ET), min_premium, max_fill_price, call_or_put rather than filtering by eye. The default premium floor ($350K) matches the member Discovery page. Includes next-session open-interest confirmation (oi_stick) when available.
Parameter
Type
Required
Description
date
string
Nooptional
Trading session YYYY-MM-DD (ET). Omit for the most recent session with a ledger.
call_or_put
string
Nooptional
Filter to 'Call' or 'Put' prints; omit for both
min_score
number
Nooptional
Only prints with score above this (default 0)
min_premium
number
Nooptional
Minimum total premium in dollars (default 350000, the Discovery page floor)
max_fill_price
number
Nooptional
Only prints with per-contract fill under this (dollars per contract, e.g. 5)
max_dte_days
number
Nooptional
Only contracts expiring within this many calendar days of the session date (0 = same-day/0DTE, 7 = within a week)
Trade Echo OptionFlow - the raw unusual options activity feed (every SWEEP / TRADE print with premium, size, strike, expiration, sentiment; ~20K+ prints per session). Use for 'flow', 'sweeps', 'unusual activity' on a ticker or across the tape. Defaults to the most recent prints; pass date and/or time_from/time_to (ET) to scope a session or window, and map other clauses to call_or_put, min_premium, max_dte_days, min_size, sentiment. For the curated, ranked Discovery list use get_noteworthy_flow instead. Includes next-session open-interest confirmation (oi_stick) when available.
Parameter
Type
Required
Description
ticker
string
Nooptional
Stock, ETF or index symbol. Futures symbols (ES, NQ, MES, MNQ, YM, RTY) are refused: use the futures tools, or SPX / NDX (SPY / QQQ) for the index.
resolve
string
Nooptional
Only when the member explicitly means the listed stock or fund behind a futures-like symbol (ES, BTC). Omit otherwise. One of: equity.
date
string
Nooptional
Trading session YYYY-MM-DD (ET). Omit for most recent prints.
time_from
string
Nooptional
Earliest trade time ET, e.g. '9:35 AM' (applies to `date`, or today if no date)
time_to
string
Nooptional
Latest trade time ET, e.g. '10:15 AM'
call_or_put
string
Nooptional
'Call' or 'Put'; omit for both
min_premium
number
Nooptional
Minimum premium in dollars
min_size
number
Nooptional
Minimum contracts
max_dte_days
number
Nooptional
Only contracts expiring within this many calendar days of the session date (0 = 0DTE)
sentiment
string
Nooptional
'BULLISH', 'BEARISH' or 'NEUTRAL'
flow_type
string
Nooptional
'SWEEP' or 'TRADE'
flow_types
array of string
Nooptional
Option activity types to include when more than one is required. Omit when flow_type is set.
DealerEdge / GEX-style gamma ladder for an equity or index root symbol (e.g. SPY, QQQ). The ladder is one row per (expiration, strike); rowCount is the full ladder and dataSampleRows is a sample centered on spot (default 15 strikes below and 15 at or above spot, nearest expiration first, up to 30 rows). sampleScope says exactly which strikes and expirations the sample covers. For more, pass strikes_around_spot, strike_min / strike_max or max_rows. setups[] lists named setups active on the ticker now (name, Setups Library url, state); use those names verbatim. When present, metadata.keyLevels.vannaAnchor, vannaWalls and vannaFlip plus metadata.vanna (dollars of dealer delta per 1 IV point) are estimated dealer hedge pressure if implied vol moves, not predictions: positive means falling IV pushes dealers to buy, negative means falling IV pushes dealers to sell.
Parameter
Type
Required
Description
ticker
string
Yesrequired
Equity, ETF or index symbol (SPY, QQQ, SPX, NDX). Futures symbols (ES, NQ, MES, MNQ, YM, RTY) are refused: use get_futures_echo_map for futures, or SPX / NDX here for the cash-index gamma.
timeframe
string
Nooptional
Optional label for user context (e.g. 1d)
resolve
string
Nooptional
Only when the member explicitly means the listed stock behind a futures-like symbol (ES, BTC). Omit otherwise. One of: equity.
strikes_around_spot
integer
Nooptional
Optional. Strikes on each side of spot in dataSampleRows (default 15, max 60). The stored ladder holds about 30 strikes each side of spot.
strike_min
number
Nooptional
Optional lowest strike to include. With strike_max this sets an explicit strike range and overrides strikes_around_spot.
strike_max
number
Nooptional
Optional highest strike to include. With strike_min this sets an explicit strike range and overrides strikes_around_spot.
max_rows
integer
Nooptional
Optional. Most rows in dataSampleRows (default 30, max 100; larger values are capped). Rows fill whole expirations, nearest first.
Trade map for one stock or ETF from Trade Echo Dealer Edge levels, the same card as the Cortex /read command: spot, lean, entry reference, invalidation and targets by horizon with reward to risk, plus a one-line takeaway. Every number comes from Dealer Edge, session structure and Option Flow data with its timestamp. Structure, not advice.
Parameter
Type
Required
Description
ticker
string
Yesrequired
Stock or ETF symbol, e.g. TSLA or SPY. Futures roots (ES, NQ) are refused: use the futures tools.
timeframe
string
Nooptional
Expirations the levels come from: scalp = 0DTE, day = 0-2 days, swing = 3-14 days, position = 15-60 days. Default day. One of: scalp, day, swing, position.
Key Dealer Edge levels for one stock or ETF with distance from spot, the same card as the Cortex /levels command: call and put walls, gamma flip, Anchor, Charm anchor, defense lines, and Vanna levels when Dealer Edge serves them. All expirations.
Parameter
Type
Required
Description
ticker
string
Yesrequired
Stock or ETF symbol, e.g. TSLA or SPY. Futures roots (ES, NQ) are refused: use the futures tools.
Setup scan (sector, theme, watchlist or market)8 creditsRead-only
Scans a sector, a theme, the member's watchlist or the market for trade-map setups (the Cortex /scan command): tier A (reward to risk of 2 or more), B or none per name, from stored Dealer Edge levels, up to 40 names. Reports coverage honestly (Read N of M; K unavailable; J not read). Nothing qualifies is a valid answer.
Parameter
Type
Required
Description
scope
string
Yesrequired
What to scan. One of: sector, theme, watchlist, market.
scope_id
string
Nooptional
Sector or theme name for scope sector or theme, e.g. tech, energy, mag7, ai, semis, quantum. Ignored for watchlist and market.
timeframe
string
Nooptional
Expirations the levels come from: scalp = 0DTE, day = 0-2 days, swing = 3-14 days, position = 15-60 days. Default day. One of: scalp, day, swing, position.
Stack scan (gamma, Charm and Vanna confluence)8 creditsRead-only
Confluence scan (the Cortex /stack command): names where the gamma Anchor, the Charm anchor and a Vanna level sit at one strike, ranked by gamma size at that strike, with distance from spot. Defaults to the whole Dealer Edge universe (up to 60 names read) and reports coverage honestly.
Parameter
Type
Required
Description
scope
string
Nooptional
Where to look. Default market. One of: sector, theme, watchlist, market.
scope_id
string
Nooptional
Sector or theme name for scope sector or theme, e.g. tech, energy, mag7, ai, semis, quantum. Ignored for watchlist and market.
Dark pool (off-exchange) equity prints with optional min notional (USD) or share size. Defaults to the most recent prints; pass date and/or time_from/time_to (ET) for a session or window, or timeframe for a rolling 1h/24h look-back.
Parameter
Type
Required
Description
ticker
string
Nooptional
Stock, ETF or index symbol. Futures symbols (ES, NQ, MES, MNQ, YM, RTY) are refused: use the futures tools, or SPX / NDX (SPY / QQQ) for the index.
resolve
string
Nooptional
Only when the member explicitly means the listed stock or fund behind a futures-like symbol (ES, BTC). Omit otherwise. One of: equity.
date
string
Nooptional
Trading session YYYY-MM-DD (ET)
time_from
string
Nooptional
Earliest print time ET, e.g. '9:35 AM'
time_to
string
Nooptional
Latest print time ET, e.g. '10:15 AM'
min_amount
number
Nooptional
Minimum print notional in USD (e.g. 1000000 for $1M+ prints)
min_size
number
Nooptional
Minimum share size (use min_amount for dollar filters)
timeframe
string
Nooptional
one of: 1h, 24h, 1d, or omit for all recent (ignored when date/time given)
Trade Echo Algo Edge - channel alerts (large_trades, momentum_trades, spx_0dte, high_value_0dte_trades, insider_trades, small_trades, original_short_expiry_trades, condition_219_trades, executive_trades). Each row carries ticker, strike, call/put, expiration, size, value ($), trade time, and % OTM. Defaults to the most recent alerts on one channel; pass date and/or time_from/time_to (ET) for a session or window, and map clauses to call_or_put, min_value, max_dte_days, moneyness.
Parameter
Type
Required
Description
ticker
string
Nooptional
channel
string
Nooptional
AlgoEdge channel id (e.g. large_trades, momentum_trades, spx_0dte). Defaults to large_trades. One of: large_trades, executive_trades, spx_0dte, momentum_trades, condition_219_trades, original_short_expiry_trades, high_value_0dte_trades, small_trades, insider_trades.
date
string
Nooptional
Trading session YYYY-MM-DD (ET)
time_from
string
Nooptional
Earliest alert time ET, e.g. '9:35 AM'
time_to
string
Nooptional
Latest alert time ET, e.g. '10:15 AM'
call_or_put
string
Nooptional
'Call' or 'Put'; omit for both
min_value
number
Nooptional
Minimum trade value in dollars
max_dte_days
number
Nooptional
Only contracts expiring within this many calendar days of the session date (0 = 0DTE)
moneyness
string
Nooptional
'otm' or 'itm' to keep only out-/in-the-money alerts (rows with unknown spot are excluded)
limit
number
Nooptional
Market Data
market.readDefault
Quotes, indices, macro events, and options chains.
Equity/ETF reference data from Trade Echo (price, instrument name/type, list date, freshness). Returns a guidance block - use it even when OptionFlow/DealerEdge are empty (common on thin or newly listed names). SPCX is SpaceX (Space Exploration Technologies Corp.), listed June 2026.
Parameter
Type
Required
Description
ticker
string
Yesrequired
Stock, ETF or index symbol. Futures symbols (ES, NQ, MES, MNQ, YM, RTY) are refused: use the futures tools, or SPX / NDX (SPY / QQQ) for the index.
resolve
string
Nooptional
Only when the member explicitly means the listed stock or fund behind a futures-like symbol (ES, BTC). Omit otherwise. One of: equity.
endpoint_type
string
Nooptional
One of: last_trade, snapshot, details, aggregates.
Cash index snapshot from Trade Echo (VIX, SPX, NDX, RUT, DJX). Use I:SPX style or bare SPX. Not for single stocks; use get_market_data for equities and ETFs.
Upcoming US macro events (FOMC, CPI, NFP, PPI, PCE, jobless claims) with impact rating. Call this before recommending positions held overnight or into the next session to confirm no catalyst will whipsaw the trade. Returns events sorted chronologically with date, time (ET), impact (low/medium/high), dateSource, and a one-line context note. Dates come from the official Federal Reserve, BLS and BEA schedules (dateSource 'published'); 'estimated' means the agency has not published that date yet, so call it an estimate.
Parameter
Type
Required
Description
lookforward_days
number
Nooptional
Days forward from today, default 7, max 30.
min_impact
string
Nooptional
Lowest impact tier to include. Default 'medium' (skips weekly jobless claims). Use 'high' for FOMC + CPI + NFP only. One of: low, medium, high.
country
string
Nooptional
ISO country code. Currently only 'US' is supported.
Options contract snapshot for an underlying. SPX/SPXW and NDX/NDXP fetch index options (not SPY/QQQ). Each contract includes bid/ask/mid/last when quoted.
Parameter
Type
Required
Description
underlying
string
Yesrequired
Underlying ticker (SPY, SPX, SPXW, QQQ, NDX, NDXP, etc.). Futures symbols (ES, NQ) are refused: use SPX / NDX for the index options.
resolve
string
Nooptional
Only when the member explicitly means the listed stock or fund behind a futures-like symbol (ES, BTC). Omit otherwise. One of: equity.
expiration_date
string
Nooptional
YYYY-MM-DD filter - REQUIRED for 0DTE agents (use tradingDateEt from prior call or today's ET session date)
Trade Echo Discovery Breaking News tab - curated News Edge headlines (macro / hard-catalyst / urgency channels), ranked by the same urgency score as the dashboard. Periodic snapshot of the breaking market news feed; not a live subscribe. Use get_news for headlines on one ticker.
Parameter
Type
Required
Description
ticker
string
Nooptional
Optional ticker to keep only stories tagged with that symbol
lookback_hours
number
Nooptional
Lookback window in hours (default 6) One of: 6, 24, 48.
limit
number
Nooptional
Max rows (default 15, cap 25)
BT Cloud & Multi-Signal
intel.readDefault
BT Cloud, session structure, and combined multi-signal scans.
Session VWAP + configurable EMA structure (e.g. EMA9/EMA20) plus opening ranges (5/15/30/45/60-minute highs/lows from 9:30 ET, for ORB setups). Returns scenario, action (TAKE/OPTIONAL/NO_TRADE), structure string, openingRanges, and prime-window flag. The action is a rule-based classification of the session structure, not a trade recommendation. Periods default to 9 and 20.
Parameter
Type
Required
Description
ticker
string
Yesrequired
Underlying ticker (SPX maps to SPY proxy for bars)
timeframe
string
Nooptional
Bar timeframe, one of 1m, 3m, 5m, 15m, 30m, 1h (default 1m). Higher timeframes are resampled from 1-minute bars on the 09:30 ET session grid. Use the agent's configured session-structure timeframe when one is stated in the instructions.
ema_periods
array of number
Nooptional
Two EMA periods, e.g. [9, 20] or [14, 50]
scenario_table_id
string
Nooptional
Use the saved Session Structure scenario table; legacy by default. One of: stillrizing_v2, symmetric_trend_v1.
use_vwap
boolean
Nooptional
Include session VWAP in classification (default true)
Run market reference data plus DealerEdge, OptionFlow, Darkpool, and AlgoEdge for ONE ticker. ticker is required on every call; this is not a market-wide scanner (for market-wide ideas use get_noteworthy_flow or get_breaking_news). Always read marketContext.guidance first - empty flow is not invalid data.
Parameter
Type
Required
Description
ticker
string
Yesrequired
Required. One stock, ETF or index symbol, e.g. SPY, NVDA, SPX. Futures symbols (ES, NQ) are refused.
resolve
string
Nooptional
Only when the member explicitly means the listed stock or fund behind a futures-like symbol (ES, BTC). Omit otherwise. One of: equity.
Trade Echo Discovery Large Futures Prints tab - unusually large on-exchange ES/NQ prints from the session ledger (notional floor $100M by default, same rows as the dashboard tab). Ranked by notional. Optional filters: min_notional (down to $25M), side, and a time window (since/until or lookback_minutes) inside the last 14 days instead of one session date. Not Echo Map tape (use get_futures_tape for the latest prints). Not a dark pool. Use get_futures_echo_map for session structure / CVD / walls.
Parameter
Type
Required
Description
date
string
Nooptional
Globex session date YYYY-MM-DD (Sunday 18:00 ET is Monday). Do not combine with since/until/lookback_minutes.
root
string
Nooptional
Optional root filter. Omit for both ES and NQ. One of: ES, NQ.
limit
number
Nooptional
Max rows (default 15, cap 25)
min_notional
number
Nooptional
Minimum print notional in USD. Default 100000000 (the Discovery tab floor); lowest allowed 25000000.
side
string
Nooptional
Inferred aggressor side filter (default any). One of: buy, sell, any.
since
string
Nooptional
ISO timestamp window start, within the last 14 days. Spans sessions.
until
string
Nooptional
ISO timestamp window end (default now). Requires since.
lookback_minutes
number
Nooptional
Window of the last N minutes (1 to 20160) ending now. Use instead of since/until.
Futures Echo Map for CME roots (ES, MES, NQ, MNQ, RTY, YM, CL, GC, ZN). Returns live quote, Globex session phase, overnight/session stats, volume-profile POC/value area, session CVD (Globex session since the 18:00 ET open, delta inferred from candle direction; cvd.scope says when it falls back to recent prints), dealer-gamma walls projected onto the futures axis, confluence levels, and a short thesis. Use for futures session structure and overnight vs cash context. Gamma is cash-index projected via basis - not futures-options GEX. Does not return the heatmap grid. Pass as_of to rebuild the map at a past moment in the last 14 days (not CL/GC).
Bar interval for the map window (default 5min) One of: 1min, 3min, 5min, 15min, 1hour, 1day.
as_of
string
Nooptional
Optional ISO timestamp in the last 14 days while Globex traded. Rebuilds the map as of that moment (4 credits over MCP instead of 2). Dealer gamma exists only for cash hours. Not available for CL or GC.
CME Globex session calendar for futures: current phase (rth, overnight, maintenance, closed), trade date, next cash open, next halt, next reopen, last close, and holiday early-close / full-closure flags. Also each Echo Map root (ES, MES, NQ, MNQ, RTY, YM, CL, GC, ZN) with front-month contract, expiry, roll date, tick size, point value, tick value and underlying index. Calendar compute only, no prices. CL/GC/ZN contract dates are approximations (see notes).
Futures watchlist quotes for ES, MES, NQ, MNQ, RTY, YM, CL, GC and ZN: last, change and change % vs prior settlement, bid/ask with sizes, front-month contract, quote time, and session phase. Every row has fidelity: live, delayed (older than 60 seconds) or simulated (demo prices, not tradable). Say so when a price is not live. For session structure use get_futures_echo_map.
Futures tape (ES, NQ and micros)2 creditsRead-only
The latest ES, NQ, MES or MNQ futures prints (time and sales): price, size, notional and aggressor side, newest first (default 25, max 50), plus the buy/sell volume split and CVD over the returned prints. Aggressor side is inferred, not exchange-reported. Check fidelity: simulated prints are not real trades. For the ranked $100M+ large-print ledger use get_unusual_futures_prints.
Parameter
Type
Required
Description
root
string
Yesrequired
Futures root. MES and MNQ are the micro contracts, each with its own prints. One of: ES, MES, NQ, MNQ.
limit
number
Nooptional
Prints to return (default 25, max 50).
min_notional
number
Nooptional
Optional minimum print notional in USD (price x size x point value).
Key intraday levels for a CME futures root (ES, MES, NQ, MNQ, RTY, YM, CL, GC, ZN) for the current Globex trade date, or as of a past moment: session VWAP and RTH VWAP with 1 and 2 SD bands, overnight high/low, initial balance (first 60 min of RTH, only once complete), 15/30 min opening range, prior day high/low/close, prior settlement (source labelled), session and prior-session POC/VAH/VAL with a naked POC flag, and dealer-gamma walls projected from index options via basis. levels[] is the merged list nearest to price with distance in points and ticks. Built from trades and bars only. Check fidelity: simulated levels are not market prices.
My broker snapshot4 creditsRead-onlyNeeds My Account
Read-only open holdings for the asking member's OWN linked broker account, including options. No user or account argument - always the caller. Use for 'what's in my account / holdings / live P&L'. Copy fills and skips belong on get_my_copy_trading_status.
My copy trading status2 creditsRead-onlyNeeds My Account
Read-only snapshot of the asking member's OWN copy-trading account: recent execution intents with skip/failure reasons, follow settings incl. pause states, and broker connection health with buying power. Call this BEFORE answering any question about the member's fills, skips, pauses, sizing, or broker state. Cannot see other users and cannot change anything.
Parameter
Type
Required
Description
topic
string
Nooptional
Which section to fetch. Default 'all' (recommended for 'why didn't my trade fill?' questions). One of: executions, settings, broker, all.
window
string
Nooptional
Execution lookback window. Default 'today'. One of: today, week.
only_problems
boolean
Nooptional
If true, recent executions list only SKIPPED/FAILED rows.
Trading
tradeOpt-inBeta
Trading and trade plans are in beta. We are improving them quickly; report anything odd in Discord or at info@tradeecho.com. Trading and trade plans are available on every paid plan. Monthly and Yearly members trade on one brokerage account, their active Copy Trading account (change it in Copy Trading), and can have up to 3 active trade plans. Lifetime members can choose any linked account for each connection and have unlimited active plans. These tools appear only on a connection where you turned on Trading. Orders are long only: options as limit orders, and stocks and ETFs where your broker supports them. Every trade plan is approved by you in Trade Echo, even when Confirm each order is off. Once you approve it, Cortex places the plan's orders without asking again, and you get a push when it enters and when it exits.
My tradable accounts1 creditRead-onlyNeeds Trading
The accounts you chose for this connection, with masked labels, broker, buying power and whether stocks and options are supported. Paper accounts are labelled.
Checks one order against your account and returns a preview: the exact order, quote, estimated cost and any warnings. Nothing is sent to your broker. The preview expires after 2 minutes.
Places the order from one preview, only after you say yes in the chat. With Confirm each order on (the default), it waits for your confirmation in Trade Echo first.
Checks a trade plan against your account and returns a preview: the contract, size, entry limit and conditions, stop, target, up to 3 trim steps, optional time exit, valid until and estimated cost. Nothing is sent to your broker.
Sends the previewed plan to you for approval in Trade Echo. Nothing trades until you approve it. Once approved, Cortex buys and sells for the plan automatically.
Where a plan stands (for example waiting for approval, armed, open or closed), with the latest check of each entry condition, the position while open and the exit once closed.