SquawkFlow Market Structure
Server Details
Free keyless dealer gamma, OI change, market calendar, 13F, congress and CFTC data, dated, cited.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 18 tools
Most tools are sharply separated by resource and measure — gamma by strike/expiry (get_gamma_heatmap), sector grid (get_gamma_matrix), headline levels (get_gex_levels), max pain, implied odds, OI deltas, futures positioning, filings, calendar — and each description names the tool to use instead, which is unusually helpful. The genuine soft spot is morning_structure versus get_gex_levels, which both return SPX/SPY/QQQ walls, flip, regime and a day-change row; the distinction (session sheet with catalysts and windows vs. raw current levels) is stated but still easy to misselect. Minor overlap also between election_market_context and get_implied_odds/get_vix_term_structure, though it explicitly defers to both.
Casing is consistently snake_case, but the verb convention is mixed: nine get_* tools, two noun-phrase names with no verb (election_market_context, morning_structure), two bare verbs (fetch, search), plus list_squawkflow_tools. The names are readable and each maps to its function, but there is no single predictable pattern an agent can rely on to guess a name.
18 tools is at the upper end but each covers a distinct data product (gex levels, gamma grid, sector matrix, max pain, implied odds, OI change, VIX curve, futures positioning, congressional filings, 13F, calendar, session record, lab record, search/fetch, catalog). Nothing looks padded, though the set is close enough to the heavy threshold that the morning_structure/get_gex_levels duplication is conspicuous.
The stated domain — options market structure, positioning, filings, calendar and published pages — is well covered end to end, including a self-describing catalog and a page read path, and exclusions (VIX spot, economic releases, earnings, sector performance, performance measures) are declared rather than silent. Remaining gaps are modest: no historical series for SPY/QQQ regime, no VIX spot, and no earnings/economic calendar, all of which the descriptions own as deliberate limits.
Available Tools
18 toolselection_market_contextElection market context: dated SPX movement, VX windows and clockARead-onlyIdempotentInspect
Use this when the question asks what the SPX chain prices for the first post-election session, which VX window includes Nov 3, or where the dated election week schedule is published. Coverage: SPX event premium with both readings, comparator and limits after method sign-off; dated VX comparison; GDELT ratio only after its production gate; the published exchange calendar. Not for: election outcomes, venue prices or polling arithmetic. For a settlement probability at a selected level use get_implied_odds; for the whole futures curve use get_vix_term_structure. Limits: risk-neutral prices are not forecasts. The straddle is a cross-check on the same quotes, not an independent estimate. Each source carries its own date.
Inputs: no named parameters. Returns: kind, page, tool, notes, +8 more
fetchRead one published SquawkFlow pageARead-onlyIdempotentInspect
Use this when you have an id from search and want the page text itself, with the canonical URL to cite. Returns the published markdown verbatim, so the page carries its own capture stamp and its own limits section into your answer. Coverage: any page with a published markdown mirror. Ids are written page:/path, session:YYYY-MM-DD, glossary:, learn: or institution::, and a squawkflow.com URL is accepted. Not for: arbitrary web pages: only squawkflow.com is served. Current market figures, which are a tool call rather than a page read. Limits: an id that resolves to no published page returns that, and no text is composed in its place. A very long page is truncated with a note naming where it was cut.
Inputs: id (required). Returns: id, url, text, title, +1 more
get_congressional_disclosuresCongressional stock disclosures: three dates per recordARead-onlyIdempotentInspect
Use this when the question is what a member of Congress disclosed buying or selling, or who disclosed trading a ticker. Every record carries three separate dates and never collapses them: the transaction date the filing states, the filer notification date where the source states one, and the public disclosure date the filing became available. The lag between the first and the last is published, or null with the reason it could not be computed. Coverage: US House Clerk periodic transaction reports and Senate eFD reports, read from the primary sources rather than from a vendor aggregation. Not for: why a filing was made, whether a trade was well timed, any performance measure, any ranking of filers, or any connection between a filing and a committee. Institutional 13F filings are a different tool (get_filing_receipt). Limits: disclosure is permitted up to roughly 45 days after a transaction, so this is a record of what became public rather than of what is happening. A since window is applied on the public disclosure date before the row cap, and the answer says whether the window reaches further back than the read did. Amounts are the bands the filing uses, never a point estimate. Amendments are appended as new records and an amendment can carry a null lag by design, with the reason published in place of a number. Filings that could not be machine-read are counted and reported on every answer.
Inputs: filer, limit, since, symbol, +1 more. Returns: kind, page, tool, notes, +10 more
get_filing_receipt13F filing receipt: what a manager reported, and whenARead-onlyIdempotentInspect
Use this when the question is what an institutional manager reported holding in a quarter. Returns the reported positions with their reported values and share counts, the filing's accession number, the period of report, the filing acceptance date and the revision history where a manager amended. Omit the manager to list the published cohort. Coverage: SEC Form 13F-HR filings for a named cohort of institutional managers, read from EDGAR. The cohort is a chosen list, not a census of 13F filers. Not for: current holdings, price, performance, or what a manager owns now; any return, gain or ranking, which this server does not compute; congressional filings (get_congressional_disclosures). Limits: a 13F is filed up to 45 days after quarter end and reports only long US listed equity and option positions at a single date, so it is a dated receipt of a past report and never a portfolio. Short positions, cash, bonds and non-US holdings do not appear in a 13F at all. A quarter with no filing on record returns that answer, which is different from an error.
Inputs: limit, manager, quarter. Returns: kind, page, tool, notes, +10 more
get_gamma_heatmapGamma exposure by strike and expiration: the gamma gridARead-onlyIdempotentInspect
Use this when the question is which expiry carries the gamma, how much gamma sits at one strike, which strikes gained open interest overnight on an index, or what the charm ramp into the close looks like today. The gamma heatmap, also called the gamma grid or the gamma surface: dealer gamma broken out by strike AND expiration rather than summed across expiries, in net dollar gamma per 1% move with calls positive and puts negative, plus where same-day (0DTE) trading is concentrated. It also returns the second-order book: vanna and charm exposure, with the charm ramp walked at half-hour marks across one cash session and integrated, so the dealer index delta the clock removes between now and the close is a dollar figure rather than an inference. An aggregate cannot tell 500M in one expiration from 500M spread over several, which is the question this answers. Coverage: SPX, SPY and QQQ only. Served from a five minute cache. Not for: the headline levels alone (get_gex_levels); the sector ETFs (get_gamma_matrix); the full per-strike open interest change or any symbol outside these three (get_oi_change). Limits: the rendered grid shows the nearest six expirations while row totals cover every expiration. Charm and vanna are model outputs, not measurements, and they are quoted in dollars of index delta rather than dollars of gamma, so they are not comparable to any gamma total. Every mark on the charm ramp holds spot and implied volatility at the capture and moves only the clock, which makes it a projection of this book rather than a statement about what happens next. The exposure block is best effort: when it is absent it prints the reason code the endpoint gave. A symbol outside the coverage list returns the SPX grid with a note saying so, not an error.
Inputs: symbol. Returns: kind, page, tool, notes, +10 more
get_gamma_matrixGamma matrix: dealer gamma across the sector ETFs and the index rowARead-onlyIdempotentInspect
Use this when the question is where dealer gamma sits across the sectors rather than in one index: which sector ETFs sit above or below their zero gamma flip, and where each one carries its call wall and put wall. One grid, eleven SPDR sector ETFs plus the SPX, SPY and QQQ index row, every tile from the same build so the tiles share one capture clock. Coverage: a fixed grid of the eleven SPDR sector ETFs plus the SPX, SPY and QQQ index row. The symbol set is not a parameter. Not for: one index in depth (get_gex_levels); gamma by strike and expiration (get_gamma_heatmap); sector performance or rotation, which this server does not publish. Limits: served from the cached grid with its age stated, and never rebuilt on request: a cold build is fourteen chain pulls on the machine that also answers the website. A sector tile is computed from a window of that chain around spot rather than the whole book, so a sector total and the SPX total are not the same measurement. No gamma regime is published for a sector ETF.
Inputs: no named parameters. Returns: kind, page, tool, notes, +10 more
get_gex_levelsGamma exposure (GEX) levels: call wall, put wall, gamma flipARead-onlyIdempotentInspect
Use this when the question is what the SPX, SPY or QQQ levels are today: where the call wall, the put wall, the zero gamma flip or the Swing Line sits right now, or whether an index is in a positive or negative gamma regime. Also called GEX, gamma exposure or dealer gamma positioning. Returns spot, net GEX, the regime, pin strikes and the options-implied session range (the expected move), each with the time the snapshot was captured, and a dated day change row (last price, prior close, change, percent change and its as-of time) that answers whether the symbol is up today. Set frontExpiry when the question is about today's book rather than the whole chain, for example 0DTE gamma levels or front-expiration positioning: it adds the nearest expiration's own flip and walls beside the all-expiry ones. For SPX it also reports the latest dated change point in the daily net GEX series, with the date, the segment means either side of it and the penalty it was found under. Coverage: SPX, SPY and QQQ only. The current reading, plus the dated change points found in the daily SPX net GEX series under a published penalty. No other history. Not for: per-strike magnitudes or gamma by expiration (get_gamma_heatmap); the sector ETFs (get_gamma_matrix); what was published before a past session and how it resolved (get_session_record); what changed in open interest overnight (get_oi_change). Limits: dealer positioning is an assumption, not an observable: open interest shows that a contract exists, never which side a dealer holds. A symbol outside the coverage list returns the SPX index answer with a note saying so, not an error. No wall hold rate is published and any earlier one is withdrawn. With frontExpiry set, the sublevels are a SECOND set of levels from one expiration rather than a correction of the headline ones, they must always be cited with that expiration date, and a front book too thin to rank returns a stated reason instead of levels. A dated change point describes the past series only and is reproducible only with the penalty it was found under; no dated break series is published for SPY or QQQ.
Inputs: symbol, frontExpiry. Returns: kind, page, tool, notes, +10 more
get_implied_oddsMarket-implied probability that a level is exceeded by an expirationARead-onlyIdempotentInspect
Use this when the question is what probability the market puts on a level by a date, for example what probability the market puts on SPX above 7700 by Friday, or what odds the chain prices on QQQ closing below 740 next week. Returns the priced probability of settling above and below that level, an independent cross-check of the same number, a ladder of levels around the forward, and the implied distribution with its median, quartiles and central band, which is the options-implied expected move to that expiration. Coverage: SPX, SPY and QQQ only. One expiration per call, and only expirations settling within 90 days. Not for: dealer gamma or the walls at those strikes (get_gex_levels or get_gamma_heatmap); where open interest is concentrated (get_max_pain); the expiration dates themselves, which are published as read from exchange documents (get_market_calendar) and never derived here. Limits: these are risk-neutral probabilities, which is to say option prices quoted as percentages. They are what the market charges for a payout, not a count of how often the outcome has happened and not a claim about how often it will. Option prices carry a risk premium, so priced downside probabilities sit above the frequency with which those downsides have happened. Not a forecast and not a price target. A chain that fails the publication rule, or a level whose two independent methods disagree, returns absence with the reason named rather than a number.
Inputs: level, symbol, expiration. Returns: kind, page, tool, notes, +10 more
get_lab_recordSquawkFlow Lab: dated simulated-record receiptsARead-onlyIdempotentInspect
Use this when the question is which dated simulated records the SquawkFlow Lab holds and whether they have been graded. Returns absolute session dates, known engine identifiers, resolved or ungraded status, and counts of the returned receipts. Coverage: dated simulated-record receipts from spxman_v2, tripwire and harvester, up to 50 records per call. Every record is simulated: no orders were placed and no money was at risk. Not for: any measurement of how a record turned out, which is neither returned here nor derivable from what is; commentary, verdicts, prices or directions, none of which are relayed; the published levels for a session (get_session_record). Limits: unknown or undated records are omitted and counted. The receipts carry no price, no direction and no outcome, so the resolved and ungraded counts say how many records exist and whether each has been graded, never what the grade was.
Inputs: limit, engine. Returns: kind, page, tool, notes, +10 more
get_market_calendarMarket calendar: sessions, exchange holidays and the next expirationARead-onlyIdempotentInspect
Use this when the question is a date: whether the exchange holds a session on a given day, when the next session is, when the next monthly, quarterly or VIX futures expiration falls, or which exchange holidays are coming. Returns the published calendar answered as of one date, with the document each entry was read from. Coverage: US equity options expirations, VIX futures settlement dates, the SPX settlement rules as the exchange words them, and the NYSE full-day closure table, each entry read off the exchange document it cites. Answered as of today on the exchange clock, or as of any date you pass. Not for: scheduled economic releases or earnings dates, neither of which this server publishes; market hours, so whether the exchange is open at this moment is not answered here; what SquawkFlow published before a past session (get_session_record); the max pain strike for an expiration (get_max_pain). Limits: no date here is computed from a rule, so a date the exchange documents do not state is reported as not published rather than worked out. Half sessions are not published at all, and a session named here may be one. The closure table covers a stated span of years: a date outside it returns no claim in either direction rather than an assumption that the exchange was open. The next session is the one derived field, taken from that same closure table, and it stops where the table does.
Inputs: date. Returns: kind, page, tool, notes, +10 more
get_max_painMax pain strike for an SPX expirationARead-onlyIdempotentInspect
Use this when the question is what SPX max pain is for an expiration, or where the max pain strike sits for this Friday. Returns the settlement strike that minimises the aggregate option payout for one expiration, computed from the delayed option chain, with the payout curve around it and the list of available expirations. Coverage: SPX only. One expiration per call. Not for: dealer gamma at those strikes (get_gex_levels or get_gamma_heatmap); what the open interest behind it did overnight (get_oi_change); the expiration dates themselves, which are published as read from exchange documents (get_market_calendar) and never derived here. Limits: max pain describes where existing open interest sits. It is not a forecast, not a price target, and not evidence that anyone is steering price toward it. Another symbol returns the SPX answer with a note saying so, not an error.
Inputs: symbol, expiration. Returns: kind, page, tool, notes, +10 more
get_oi_changeOvernight open interest change between two settlementsARead-onlyIdempotentInspect
Use this when the question is what changed in an option book overnight: which strikes and expirations gained or lost open interest between two daily settlements, with the signed contract counts and both settlement dates. Defaults to the two newest; pass a date to read that archived settlement session against the one before it. Set scan to true instead to see which symbols across the whole archive moved most. Coverage: the symbols SquawkFlow archives a daily settlement for, addressed one at a time, plus a universe scan of the largest movers across all of them. Not for: dealer gamma at those strikes (get_gamma_heatmap or get_gex_levels); option trades, options flow, order flow or a tape, none of which this is; a settlement session the archive does not hold, which returns the range it does hold instead; expiration dates themselves (get_market_calendar). Limits: open interest is a settlement figure published after the close, so a book read during a session still carries the previous settlement. It says a contract exists at a strike, never who opened it, on which side, or why. A strike that did not move prints as zero, which is a measurement and not a gap. A symbol the archive does not hold returns SPX with a note saying so. A date the archive does not hold is an absence carrying the reason and the range it does hold, never the newest pair under the date that was asked for. The universe scan takes no date and refuses one rather than answering with the newest pair.
Inputs: date, scan, limit, symbol. Returns: kind, page, tool, notes, +10 more
get_positioningCFTC futures positioning: long, short and net by trader classificationARead-onlyIdempotentInspect
Use this when the question is how index futures positioning is distributed across trader classifications: dealers and intermediaries, asset managers, leveraged funds, other reportables and nonreportables, with long, short, spreading and net contracts and the week history. Omit the contract to list the published pages. Coverage: the CFTC Traders in Financial Futures futures-only report for the index futures SquawkFlow publishes a page for. Weekly US government data, not a market feed. Not for: options positioning or dealer gamma (get_gex_levels); commodity futures, which this server does not publish; any reading of the session in progress. Limits: positions are held as of the stated Tuesday and published the following Friday afternoon, so this is a weekly picture that is three days old by construction. Net is long minus short in contracts, an arithmetic difference between two published counts, not a sentiment reading. Contract markets with different index multipliers are never added together.
Inputs: weeks, contract. Returns: kind, page, tool, notes, +10 more
get_session_recordSquawkFlow session record: what was published before a sessionARead-onlyIdempotentInspect
Use this when the question is what SquawkFlow published for a given trading day before it traded, and what the record says happened to those levels. Returns the dated record for one session: the levels as published, the verdict on each one, the capture coverage, how the published levels moved from the prior session, and whether the record has settled or is still open. This is the dated tool on this server: pass a date to ask about a past session. Coverage: one SPX session per call, for the dates the published index lists. The index is the whole coverage: a date it does not list has no record here. Not for: the current reading (get_gex_levels); any rate, share or frequency computed across sessions, which this server does not compute; any forward statement about a session that has not happened. Limits: one session per call. No session price extremes are published through this tool: the open, close, high and low on the record are vendor-derived and are not relayed, nor is any comparison computed from them. A weekend or a holiday returns that it was not a session, which is a different answer from a missing record.
Inputs: date. Returns: kind, page, tool, notes, +10 more
get_vix_term_structureVIX futures term structure: contango or backwardationARead-onlyIdempotentInspect
Use this when the question is whether VIX is in contango or backwardation, how steep the curve is, or what the front month settled at. Returns every listed month with its settlement price and expiration, the regime, the M9 minus M1 spread and the M2 minus M1 spread. Coverage: Official monthly VIX futures settlement curve only. Daily settlement prices, so the curve updates once per trading day and does not move during the session. Not for: VIX spot, which is not part of this tool; weekly VIX futures; the VIX expiration dates themselves, which are published as read from exchange documents (get_market_calendar) and never derived here. Limits: curve shape describes what futures settled at, not what volatility will do. No historical percentile of the slope is returned.
Inputs: no named parameters. Returns: kind, page, tool, notes, +10 more
list_squawkflow_toolsWhat SquawkFlow covers: tools, data vintage and limitsARead-onlyIdempotentInspect
Use this when you are not sure whether SquawkFlow has the symbol, the date, the expiration or the measure you need, or when you want the list of things this server deliberately does not publish. Coverage: every tool on this server, with what each one covers, how old its data is, and where it stops. Takes no arguments and makes no market data call. Not for: any market figure. This returns descriptions, not data: call the tool it names instead. Limits: the same body is readable as the resource sf://catalog without spending a tool call.
Inputs: no named parameters. Returns: kind, page, tool, notes, +10 more
morning_structureMorning structure for SPX, SPY and QQQARead-onlyIdempotentInspect
Use this when the question is the structural framework for the session, or the SPX levels today: where SPX, SPY or QQQ sit against the Flip Line and the Swing Line, where the call wall, put wall and Pin Zone are, which strikes carry the largest positive and negative gamma, what the regime sign is, and which dated events are on the calendar today. One call replaces reading a gamma chart and a calendar separately. Returns labelled figures per symbol, each with its own as-of time, plus the day's catalysts and three session windows stated as conditions against the Flip Line and Swing Line, and a dated day change row per symbol (last price, prior close, change, percent) for whether the market is up today. Coverage: SPX, SPY and QQQ only. The current session sheet only. Not for: per-strike magnitudes or gamma by expiration (get_gamma_heatmap); a dated record of what was published before a past session (get_session_record); the sector ETFs (get_gamma_matrix); futures prices, which this sheet does not carry. Limits: dealer positioning is an assumption, not an observable. The regime is a sign, not a forecast of volatility or direction. The session windows describe a hedging mechanism and are not instructions. The result holds no entry, exit, size or probability, and it must not be turned into any of them. A row the backend could not refresh is served from its last good read with its own dates.
Inputs: symbols. Returns: kind, page, tool, notes, +10 more
searchSearch the pages SquawkFlow publishesARead-onlyIdempotentInspect
Use this when you want the SquawkFlow page that answers a question, or a citable link rather than a number: glossary definitions, methodology and explainer pages, expiration calendars, filing pages and dated session records. Returns ids, titles and canonical URLs. Pass an id to fetch to read the page. A query naming an ISO date finds the dated record for it. Coverage: the pages SquawkFlow publishes for machine reading, read from the site's own published index rather than from the API, so a wide reading pass here costs the market data endpoints nothing. Not for: market figures of any kind: this returns pages, not numbers. For a level, a grid, a filing or a record, call the tool that publishes it. Limits: a page the site has not published for machine reading is not findable here, and no id is invented for one. Ranking is a plain lexical match over titles and the published descriptions.
Inputs: query (required), limit. Returns: note, query, results, retrievedAt
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Free delayed gamma flip, call and put walls, max pain and net dealer gamma
Free dealer-gamma call walls, put walls and gamma flip for ES, NQ, SPX and QQQ, graded daily.
Free, keyless OpticAlpha market data: options flow, GEX, 13F, yield curve, funding, Fed odds.
Dealer positioning for options traders: zero gamma, the walls, max pain, expected move, and flow.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceProvides a consolidated 0DTE options cockpit for SPX/SPXW, including chain, Greeks, dealer exposure, volatility term structure, and economic events, using free delayed market data.2MIT
- AlicenseAqualityBmaintenanceA full finance desk for your AI agent: 355 tools in one free server with no API key, reading SEC filings, earnings guidance, insider trades, options, rates and macro data from the source, plus quant analytics and backtest validation. The agent sees 5 tools and searches the rest, so it stays light on context.5716 npm1MIT
- AlicenseAqualityBmaintenanceAnti-firehose options-flow data for AI agents: curated daily pool, features, realized outcomes.9MIT
- AlicenseAqualityDmaintenanceMCP server for Quant Data, providing measured market statistics for index futures and equities, including day-type probabilities, Weis volume-price waves, options max pain, and dealer gamma exposure. Includes free keyless access and emphasizes honest reporting of model limitations.51MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.