Skip to content
MCP /Tool reference

23 read-only tools,grouped by scope.

Every tool an AI assistant can call on Trade Echo MCP, with its parameters and credit cost. A default connection sees 18 tools; adding SEC filings makes 20; turning on My Account makes 23.

By Updated September 25, 2026

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.

Option Flow

flow.readDefault

Unusual options flow, Discovery noteworthy flow, and sector premium summaries.

get_noteworthy_flow

Noteworthy Flow2 creditsRead-only

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.

ParameterTypeRequiredDescription
datestringNoTrading session YYYY-MM-DD (ET). Omit for the most recent session with a ledger.
call_or_putstringNoFilter to 'Call' or 'Put' prints; omit for both
min_scorenumberNoOnly prints with score above this (default 0)
min_premiumnumberNoMinimum total premium in dollars (default 350000, the Discovery page floor)
max_fill_pricenumberNoOnly prints with per-contract fill under this (dollars per contract, e.g. 5)
max_dte_daysnumberNoOnly contracts expiring within this many calendar days of the session date (0 = same-day/0DTE, 7 = within a week)
time_fromstringNoEarliest trade time ET, e.g. '9:35 AM' or '09:35'
time_tostringNoLatest trade time ET, e.g. '10:15 AM' or '10:15'
limitnumberNoMax rows (default 10, cap 25)

get_option_flow

Option Flow1 creditRead-only

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.

ParameterTypeRequiredDescription
tickerstringNo
datestringNoTrading session YYYY-MM-DD (ET). Omit for most recent prints.
time_fromstringNoEarliest trade time ET, e.g. '9:35 AM' (applies to `date`, or today if no date)
time_tostringNoLatest trade time ET, e.g. '10:15 AM'
call_or_putstringNo'Call' or 'Put'; omit for both
min_premiumnumberNoMinimum premium in dollars
min_sizenumberNoMinimum contracts
max_dte_daysnumberNoOnly contracts expiring within this many calendar days of the session date (0 = 0DTE)
sentimentstringNo'BULLISH', 'BEARISH' or 'NEUTRAL'
flow_typestringNo'SWEEP' or 'TRADE'
flow_typesarray of stringNoOption activity types to include when more than one is required. Omit when flow_type is set.
limitnumberNoMax rows (default 20, cap 50)

get_option_flow_sector_summary

Option Flow by sector4 creditsRead-only

Today's top tickers by options premium, useful for identifying sector-level unusual activity.

No parameters.

Dealer Edge

dealer_edge.readDefault

Dealer gamma ladders and positioning levels.

get_dealer_edge_data

Dealer Edge (GEX)2 creditsRead-only

DealerEdge / GEX-style gamma ladder for an equity or index root symbol (e.g. SPY, QQQ). 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.

ParameterTypeRequiredDescription
tickerstringYesUnderlying ticker symbol
timeframestringNoOptional label for user context (e.g. 1d)

Dark Pool

darkpool.readDefault

Recent dark-pool prints and FINRA market context.

get_dark_pool_data

Dark pool prints1 creditRead-only

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.

ParameterTypeRequiredDescription
tickerstringNo
datestringNoTrading session YYYY-MM-DD (ET)
time_fromstringNoEarliest print time ET, e.g. '9:35 AM'
time_tostringNoLatest print time ET, e.g. '10:15 AM'
min_amountnumberNoMinimum print notional in USD (e.g. 1000000 for $1M+ prints)
min_sizenumberNoMinimum share size (use min_amount for dollar filters)
timeframestringNoone of: 1h, 24h, 1d, or omit for all recent (ignored when date/time given)
limitnumberNo

Algo Edge

algo_edge.readDefault

Algo Edge large-trade signals.

get_algo_edge_signals

Algo Edge signals1 creditRead-only

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.

ParameterTypeRequiredDescription
tickerstringNo
channelstringNoAlgoEdge 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.
datestringNoTrading session YYYY-MM-DD (ET)
time_fromstringNoEarliest alert time ET, e.g. '9:35 AM'
time_tostringNoLatest alert time ET, e.g. '10:15 AM'
call_or_putstringNo'Call' or 'Put'; omit for both
min_valuenumberNoMinimum trade value in dollars
max_dte_daysnumberNoOnly contracts expiring within this many calendar days of the session date (0 = 0DTE)
moneynessstringNo'otm' or 'itm' to keep only out-/in-the-money alerts (rows with unknown spot are excluded)
limitnumberNo

Market Data

market.readDefault

Quotes, indices, macro events, and options chains.

get_market_data

Market data2 creditsRead-only

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.

ParameterTypeRequiredDescription
tickerstringYes
endpoint_typestringNoOne of: last_trade, snapshot, details, aggregates.

get_finra_ats_volume

FINRA ATS volume4 creditsRead-only

FINRA ATS (dark pool) weekly volume data. DELAYED 1-2 weeks - for educational/trend analysis only. Use get_dark_pool_data for live prints.

ParameterTypeRequiredDescription
tickerstringYesEquity ticker symbol
weeksnumberNoNumber of weeks of history (default 8, max 52)
breakdownbooleanNoIf true, return per-venue breakdown instead of aggregate

get_index_snapshot

Index snapshot2 creditsRead-only

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.

ParameterTypeRequiredDescription
symbolstringYesIndex symbol: SPX, NDX, VIX, RUT, DJX, or I:SPX

get_macro_events

Macro events2 creditsRead-only

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), and a one-line context note.

ParameterTypeRequiredDescription
lookforward_daysnumberNoDays forward from today, default 7, max 30.
min_impactstringNoLowest impact tier to include. Default 'medium' (skips weekly jobless claims). Use 'high' for FOMC + CPI + NFP only. One of: low, medium, high.
countrystringNoISO country code. Currently only 'US' is supported.

get_options_chain_snapshot

Options chain snapshot4 creditsRead-only

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.

ParameterTypeRequiredDescription
underlyingstringYesUnderlying ticker (SPY, SPX, SPXW, QQQ, NDX, NDXP, etc.)
expiration_datestringNoYYYY-MM-DD filter - REQUIRED for 0DTE agents (use tradingDateEt from prior call or today's ET session date)
limitnumberNoAPI page size 1-250 (default 120)

News Edge

news.readDefault

Ticker headlines and Discovery Breaking News.

get_news

Ticker news1 creditRead-only

Ticker headlines for one symbol. Not the Discovery Breaking News tab - use get_breaking_news for that ranked News Edge feed.

ParameterTypeRequiredDescription
tickerstringYes
limitnumberNo

get_breaking_news

Breaking news1 creditRead-only

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.

ParameterTypeRequiredDescription
tickerstringNoOptional ticker to keep only stories tagged with that symbol
lookback_hoursnumberNoLookback window in hours (default 6) One of: 6, 24, 48.
limitnumberNoMax rows (default 15, cap 25)

BT Cloud & Multi-Signal

intel.readDefault

BT Cloud, session structure, and combined multi-signal scans.

get_bt_cloud_state

BT Cloud state1 creditRead-only

BT Cloud direction on 1-minute bars; returns cloud state (bullish/bearish) and crossover events.

ParameterTypeRequiredDescription
tickerstringYesUnderlying ticker symbol (SPX/ES map to SPY proxy)
timespan_multipliernumberNoBar multiplier for minute timespan (default 1)

get_session_structure

Session structure1 creditRead-only

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. Periods default to 9 and 20.

ParameterTypeRequiredDescription
tickerstringYesUnderlying ticker (SPX maps to SPY proxy for bars)
timeframestringNoBar 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_periodsarray of numberNoTwo EMA periods, e.g. [9, 20] or [14, 50]
scenario_table_idstringNoUse the saved Session Structure scenario table; legacy by default. One of: stillrizing_v2, symmetric_trend_v1.
use_vwapbooleanNoInclude session VWAP in classification (default true)

multi_signal_scan

Multi-signal scan2 creditsRead-only

Run market reference data plus DealerEdge, OptionFlow, Darkpool, and AlgoEdge for one ticker. Always read marketContext.guidance first - empty flow is not invalid data.

ParameterTypeRequiredDescription
tickerstringYes

SEC Filings & Financials

filings.readOptional

SEC filings and structured company financials.

get_sec_filings

SEC filings4 creditsRead-only

Search SEC EDGAR for recent filings (10-K, 10-Q, 8-K) or search within filing text by keyword.

ParameterTypeRequiredDescription
tickerstringYesCompany ticker symbol
form_typestringNoFiling type filter One of: 10-K, 10-Q, 8-K, all.
keywordstringNoSearch within filing text for this keyword
limitnumberNoMax results (default 10)

get_company_financials

Company financials4 creditsRead-only

Retrieve structured XBRL financial data from SEC (revenue, EPS, net income, assets) across quarterly and annual filings.

ParameterTypeRequiredDescription
tickerstringYesCompany ticker symbol
metricstringNoSpecific XBRL concept name (e.g. Revenues, NetIncomeLoss). Omit for common metrics.

Futures Echo Map

futures.readDefault

CME futures session map, overnight stats, CVD, projected dealer walls, and Discovery large ES/NQ prints.

get_unusual_futures_prints

Unusual futures prints2 creditsRead-only

Trade Echo Discovery Large Futures Prints tab - unusually large on-exchange ES/NQ prints from the session ledger (notional floor $100M). Ranked by notional, same rows as the dashboard tab. Not Echo Map tape. Not a dark pool. Use get_futures_echo_map for session structure / CVD / walls.

ParameterTypeRequiredDescription
datestringNoGlobex session date YYYY-MM-DD (Sunday 18:00 ET is Monday)
rootstringNoOptional root filter. Omit for both ES and NQ. One of: ES, NQ.
limitnumberNoMax rows (default 15, cap 25)

get_futures_echo_map

Futures Echo Map2 creditsRead-only

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, CVD total, 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.

ParameterTypeRequiredDescription
symbolstringYesFutures root: ES, MES, NQ, MNQ, RTY, YM, CL, GC, or ZN
intervalstringNoBar interval for the map window (default 5min) One of: 1min, 3min, 5min, 15min, 1hour, 1day.

My Account

account.readOpt-in

Your trade journal, copy-trading status, and live broker holdings. Third-party models will see these numbers.

get_my_broker_snapshot

My broker snapshot4 creditsRead-only

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.

No parameters.

get_portfolio_stats

My portfolio stats2 creditsRead-only

Query the authenticated user's own trade journal for P&L, win rate, best/worst trade, and most-traded tickers.

ParameterTypeRequiredDescription
periodstringNoTime period to analyze One of: 1w, 1m, 6m, all.
metricstringNoWhich metric to retrieve One of: summary, best_trade, worst_trade, most_traded.

get_my_copy_trading_status

My copy trading status2 creditsRead-only

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.

ParameterTypeRequiredDescription
topicstringNoWhich section to fetch. Default 'all' (recommended for 'why didn't my trade fill?' questions). One of: executions, settings, broker, all.
windowstringNoExecution lookback window. Default 'today'. One of: today, week.
only_problemsbooleanNoIf true, recent executions list only SKIPPED/FAILED rows.
MCP /Connect

Put these tools in your assistant.

Setup guides for Claude, ChatGPT, Meta AI (Muse) and other MCP clients.