mcp server

flashalpha

Real-time & historical options analytics: GEX, dealer positioning, greeks, SVI vol, VRP, 0DTE

Description as published by the maintainer. Source

version 1.5.0
active
analytics

active — Registry entry last updated 2026-06-07. Dashed tags are derived by ZBS Index from the published description, not stated by the maintainer.

What this server can do

73 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.

calculate_greeks(dte, spot, type, sigma, apiKey, strike): Calculate Black-Scholes option greeks (delta, gamma, theta, vega, rho, vanna, charm, speed, zomma, color). Pure math — no market data needed. Required: spot, strike, dte, sigma, type.
calculate_kelly(mu, dte, spot, type, sigma, apiKey, strike, premium): Compute Kelly criterion optimal position sizing for an option trade. Uses BSM expected value vs premium to find edge-maximizing bet size. Required: spot, strike, dte, sigma, premium, mu, type.
get_account(apiKey): Get your account info: plan, daily quota limit, usage today, remaining calls.
get_advanced_volatility(apiKey, symbol): Get advanced volatility analytics: SVI parameters, forward prices, total variance surface, arbitrage detection, greeks surfaces (vanna, charm, volga, speed), and variance swap fair values. Alpha tier required. Required: symbol.
get_chex(apiKey, symbol, expiration): Get charm exposure (CHEX) by strike. Shows how dealer delta hedging changes as time passes — reveals time-decay-driven flows. Required: symbol.
get_dealer_premium(apiKey, symbol, windowMinutes): Net dealer options premium — are dealers net buying or writing premium today (VWAP-weighted buy vs write across the full flow tape); shows whether dealers are net long or short premium over the configurable window; Alpha tier. Required: symbol.
get_dex(apiKey, symbol, expiration): Get delta exposure (DEX) by strike. Shows net dealer delta and directional bias from options hedging. Required: symbol.
get_dispersion(index, apiKey, symbols, weights, horizon_days): Index vs single-name implied correlation and realized correlation across a user-supplied basket. Returns correlation premium (implied minus realized), dispersion trade setup, implied vol of the index vs basket, and per-constituent vol contribution. Use for dispersion trading, correlation premium sizing, or cross-asset vol arb. Alpha tier required. Required: index, symbols.
get_earnings(kind, apiKey, symbol): Get earnings analytics for a symbol across six lenses. kind enum values: • expected_move — earnings-implied move decomposition: splits front-expiry straddle into jump vs baseline-diffusion using pre/post-event SVI term structure. • history — past earnings events: EPS/revenue surprises, implied vs actual moves, and realized IV crush per event. • iv_crush — expected + historical IV-crush distribution: live crush estimate and median/p25/p75/best/worst from up to 20 past events. • vrp — earnings vol-risk-premium: implied move vs realized-median, premium ratio, z-score, percentile, richness assessment. • dealer_positioning — event-scoped dealer exposure: gamma flip and walls on event-week expiries, GEX by DTE bucket, charm acceleration. • strategies — earnings strategy-suitability scores: long straddle, short strangle, iron condor, calendar spread, earnings diagonal (0–100 each). Required: symbol, kind.
get_earnings_calendar(days, apiKey, symbols, importance): Upcoming earnings calendar over a configurable forward window. Returns event date, session (bmo/amc), confirmation status, fiscal period, importance rating, consensus EPS estimate, and stored implied-move percent for each event. Filter by symbols list and minimum importance; adjust days-ahead window (1–90, default 14).
get_earnings_screener(days, sort, limit, apiKey, min_importance): Cross-sectional earnings screener: ranks upcoming events by VRP richness, cheapest implied move, highest historical IV crush, or importance. Returns implied-move percent, premium ratio (implied / realized-median), median historical IV crush, and richness assessment for each event. Configurable forward window, row limit, and minimum importance filter.
get_expected_move(apiKey, expiry, symbol): Straddle-implied expected move per expiry: 1-sigma dollar and percent range, upper/lower bounds, straddle price, and ATM IV. Use to size trades, evaluate premium levels, or compare market-implied move vs realized range. Required: symbol.
get_exposure_basket(apiKey, symbols, weights): Weighted cross-symbol aggregate of GEX, DEX, VEX, CHEX across up to 50 symbols. Equal weights when weights omitted; otherwise normalised to sum 1. Use for portfolio/basket scanner, sector exposure roll-up, or custom index dealer positioning. Required: symbols.
get_exposure_sheet(apiKey, min_oi, symbol, expiration): Unified per-strike exposure sheet: GEX, DEX, VEX, CHEX, and DAG in one response with chain totals, Line-in-the-Sand inflection strike, gamma peaks, and OPEX/triple-witching flags. Use to scan all greeks at every strike in a single call. Required: symbol.
get_exposure_summary(apiKey, symbol): Get full exposure summary: net GEX/DEX/VEX/CHEX, gamma regime (positive/negative), key levels, hedging estimates, zero-DTE breakdown, top strikes. Required: symbol.
get_flow_dealer_risk(apiKey, expiry, symbol): Settled vs live dealer risk shift: GEX/DEX adjustment since open, percent shifts, direction classifier (amplifying/dampening/neutral/no_flow/regime_flip), and a plain-English description of the intraday flow impact. Required: symbol.
get_flow_levels(apiKey, expiry, symbol): Live (simulation-aware) gamma flip, call wall, put wall, and max pain — computed on effective OI (settled + intraday simulator delta). More current than /v1/exposure/levels during the session. Required: symbol.
get_flow_live(view, apiKey, symbol): Headline flow bundle in one call: effective OI state, live levels, live GEX/DEX totals, pin-risk score, and dealer-risk summary. Pass view='gex' for the full simulation-aware live GEX surface, view='dex' for live DEX, view='oi' for the raw OI simulator state (model input) — or omit view for the combined live bundle. Required: symbol.
get_flow_pin_risk(apiKey, expiry, symbol): Live pin-risk score with full sub-score breakdown, computed on effective (simulation-aware) OI. Reflects intraday flow changes to dealer positioning. Required: symbol.
get_flow_scan(kind, asset, limit, apiKey, windowMinutes): Cross-symbol options/stock flow leaderboard (biggest buyers/sellers by net notional) and flow outliers (most imbalanced symbols) across the universe. asset: 'options' | 'stocks'. kind: 'leaderboard' (ranked net notional buyers/sellers) | 'outliers' (flow outlier scan, ranked by absolute net notional). Required: asset, kind.
get_flow_signals(limit, apiKey, expiry, symbol, minScore, summarize, windowMinutes): Scored, classified unusual options activity feed: sweeps, blocks, smart money, opening bias, intent classification, scored unusual flow. Each signal includes score breakdown, greeks enrichment, and delta-notional. Set summarize=true for a cheap net bullish/bearish + opening/closing premium roll-up across the window. Required: symbol.
get_flow_summary(apiKey, expiry, symbol): At-a-glance simulation-aware flow card: headline flow direction (no_flow/neutral/amplifying/dampening/regime_flip), intraday delta, and live GEX with percent shift from settled. Cheap to poll across a watchlist. Required: symbol.
get_gex(apiKey, min_oi, symbol, expiration): Get gamma exposure (GEX) by strike. Shows dealer gamma positioning, gamma flip, call/put walls. Reveals where dealer hedging creates support/resistance. Required: symbol.
get_historical_advanced_volatility(at, apiKey, symbol): Replay advanced volatility analytics (SVI parameters, forward prices, total variance surface, arbitrage flags, greek surfaces, variance swap fair values) at any minute since April 2018. EOD-stamped (SVI fits refresh daily). Alpha tier. Required: symbol, at.
get_historical_chex(at, apiKey, symbol): Replay charm exposure (CHEX) by strike at any minute since April 2018. Alpha tier. Required: symbol, at.
get_historical_coverage(apiKey, symbol): List symbols backfilled in the historical archive with coverage windows, day counts, and gaps. Call this first to check whether a symbol + date range is queryable before sending a replay request. Alpha tier.
get_historical_dex(at, apiKey, symbol): Replay delta exposure (DEX) by strike at any minute since April 2018. Alpha tier. Required: symbol, at.
get_historical_exposure_summary(at, apiKey, symbol): Replay the full exposure summary (net GEX/DEX/VEX/CHEX, regime, hedging estimates, top strikes) at any minute since April 2018. Alpha tier. Required: symbol, at.
get_historical_gex(at, apiKey, symbol): Replay gamma exposure (GEX) by strike at any minute since April 2018. Returns same shape as live /v1/exposure/gex. Alpha tier. Required: symbol, at.
get_historical_levels(at, apiKey, symbol): Replay key options levels (gamma flip, call/put walls, highest OI strike, 0DTE magnet) at any minute since April 2018. Alpha tier. Required: symbol, at.
get_historical_max_pain(at, apiKey, symbol): Replay max pain, pain curve, dealer alignment, and pin probability at any minute since April 2018. Alpha tier. Required: symbol, at.
get_historical_narrative(at, apiKey, symbol): Replay the verbal narrative analysis (regime, key-level commentary, prior-day comparison) at any minute since April 2018. Alpha tier. Required: symbol, at.
get_historical_option_quote(at, type, apiKey, expiry, strike, symbol, maxSpreadAbs, maxSpreadPct): Replay the full option chain with BSM greeks, IV, OI at any minute since April 2018. Filter by expiry, strike, and type. Alpha tier. Required: symbol, at.
get_historical_stock_quote(at, apiKey, symbol): Replay a stock bid/ask/mid at any minute since April 2018. Alpha tier. Required: symbol, at.
get_historical_stock_summary(at, apiKey, symbol): Replay the comprehensive stock summary (price, IV, VRP, exposure, flow, macro) at any minute since April 2018. Alpha tier. Required: symbol, at.
get_historical_surface(at, apiKey, symbol): Replay the implied volatility surface grid at any minute since April 2018. EOD-stamped (SVI parameters refresh daily). Alpha tier. Required: symbol, at.
get_historical_vex(at, apiKey, symbol): Replay vanna exposure (VEX) by strike at any minute since April 2018. Alpha tier. Required: symbol, at.
get_historical_volatility(at, apiKey, symbol): Replay volatility analytics (ATM IV, realised vol, IV-RV spreads, skew, term structure) at any minute since April 2018. Alpha tier. Required: symbol, at.
get_historical_vrp(at, apiKey, symbol): Replay VRP dashboard (z-score, percentile, regime, strategy scores) at any minute since April 2018. Percentiles and z-scores are leak-free: date-bounded in SQL so the backtest only sees data strictly before the `at` timestamp. Alpha tier. Required: symbol, at.
get_historical_zero_dte(at, apiKey, symbol): Replay 0DTE analytics (pin risk, expected move, gamma acceleration, dealer hedging estimates for same-day expiry) at any minute since April 2018. Alpha tier. Required: symbol, at.
get_levels(apiKey, symbol): Get key options levels: gamma flip point, call wall, put wall, max pain, highest OI strike. These act as support/resistance from dealer hedging. Required: symbol.
get_liquidity(apiKey, symbol): Per-expiry option liquidity score (0-100), ATM bid-ask spread percent, OI-weighted spread, ATM OI depth, and chain-level execution quality. Labels: tight (>=75), normal (>=50), wide (>=20), illiquid (<20). Use to select the most liquid expiry, assess execution quality, or screen for tight spreads. Required: symbol.
get_max_pain(apiKey, symbol, expiration): Get max pain strike, pain curve, put/call OI ratio, dealer alignment, pin probability, and per-expiration breakdown. Required: symbol.
get_narrative(apiKey, symbol): Get verbal GEX narrative analysis. Describes gamma regime, key levels, dealer positioning, and price action implications in plain English. Required: symbol.
get_oi_diff(topN, apiKey, symbol): Day-over-day open-interest deltas: per-contract OI changes, top-N sorted by absolute magnitude, and call/put aggregate totals. Use to track new positioning, unwinding, and block print intent from OI shifts. Required: symbol.
get_option_chain(apiKey, symbol): Get option chain metadata: available expirations and strikes for a ticker. Required: symbol.
get_option_flow(view, limit, apiKey, expiry, symbol, minutes): Raw intraday option trade-flow for one underlying. Views: 'recent' (recent option trades, newest first), 'summary' (option trade-flow totals by underlying), 'blocks' (large option trades by underlying), 'history' (minute option-flow buckets, newest first), 'cumulative' (cumulative net option net premium by underlying). Required: symbol, view.
get_option_quote(type, apiKey, expiry, strike, symbol): Get live option quote with bid, ask, mid, IV, greeks, open interest, and volume. Filter by expiry, strike, and type. Required: symbol.
get_realized_vol(apiKey, symbol): Range-based realized (historical) volatility estimators over 10/20/30-day windows: close-to-close, Parkinson, Garman-Klass, Rogers-Satchell, and Yang-Zhang. Range estimators use the daily high/low/open/close and are 5–8× more statistically efficient than close-to-close. Alpha tier. Use to measure realized vol robustly, compare estimators, or feed a vol-risk-premium calc. Required: symbol.
get_skew_term(apiKey, symbol): Volatility skew term structure per expiry: ATM IV, 25-delta and 10-delta risk reversal, butterfly spread, skew_25d (put IV minus call IV), and tail convexity. Use for put/call skew across expirations, 25-delta risk reversal, butterfly convexity, or comparing near-term vs far-term skew. Required: symbol.
get_spot_vol_correlation(apiKey, symbol): 20-day and 60-day Pearson correlation between spot log-returns and ATM IV first-differences. Equity indices typically run strongly negative (vol spikes on spot down). Use to assess leverage effect strength, calibrate vanna/vol-of-vol hedges, or classify correlation regime. Required: symbol.
get_stock_flow(view, limit, apiKey, symbol, minutes, resolution): Raw intraday stock trade-flow for one symbol. Views: 'recent' (recent stock trades, newest first), 'summary' (stock trade-flow totals), 'blocks' (large stock trades), 'history' (minute stock-flow buckets, newest first), 'cumulative' (cumulative net stock flow), 'bars' (multi-resolution OHLCV+flow bars, oldest first, for live chart feeds). Required: symbol, view.
get_stock_quote(apiKey, symbol): Get real-time stock quote (bid, ask, mid, last price) for a ticker symbol. Required: symbol.
get_stock_summary(apiKey, symbol): Get comprehensive stock summary: price, ATM IV, historical vol, VRP, skew, term structure, options flow, exposure data, and macro context (VIX, Fear & Greed, yield curve). Required: symbol.
get_strategy(apiKey, signal, symbol): Get a strategy decision envelope for one of 10 options-based trading signals. signal enum values and what each answers: • flow_anomaly — directional options-flow imbalance: is call/put premium skewing bullish or bearish? • expiry_positioning — OPEX pin risk and iron-fly setup: should you fade into expiry? • zero_dte — same-day range compression: what is the 0DTE expected range and dealer regime? • dealer_regime — dealer gamma regime classifier: positive vs negative gamma and hedging pressure. • vol_carry — VRP carry credit-spread selection: is IV elevated enough to sell premium via credit spreads? • yield_enhancement — covered-call / cash-secured-put income overlay: optimal strike for yield capture. • surface_anomaly — SVI residual rich/cheap wing detection: where is the vol surface mispriced? • skew — 25-delta skew / risk-reversal signal: put vs call skew balance and direction. • term_structure — ATM-IV term-structure signal: contango vs backwardation and roll opportunities. • tail_pricing — downside-tail richness signal: are OTM puts cheap or expensive vs history? Required: symbol, signal.
get_surface(apiKey, symbol): Get the live 50x50 implied-volatility surface grid over (tenor, log-moneyness). Built from OTM contract IVs with bilinear interpolation. Required: symbol.
get_svi_params(apiKey, symbol): Live SVI-fitted volatility surface per expiry: calibrated (a, b, rho, m, sigma) parameters, ATM total variance, and ATM IV. Use for surface reconstruction, SVI arbitrage checking, variance swap pricing, or quant vol-model inputs. Alpha tier required. Required: symbol.
get_symbols(apiKey): List of symbols currently queried with live data cached in the system. Use to see which symbols have active real-time data, check if a specific ticker has been warmed up, or enumerate what is being tracked live right now.
get_term_structure(apiKey, symbol): Per-greek exposure aggregated by DTE bucket (0-7d, 8-30d, 31-60d, 61-180d, 180d+) and per expiry. Equivalent to four separate exposure calls grouped by time. Use to understand how GEX/DEX/VEX/CHEX rolls off across the term structure. Required: symbol.
get_tickers(apiKey): List all available stock/ETF tickers with live options data.
get_universe(sort, limit, apiKey): Curated tier-1 / tier-2 symbol directory of symbols kept pre-warmed in the screener. Use to discover which symbols have guaranteed-warm data, check coverage before subscribing, or enumerate the tracked universe for cross-sectional scans.
get_vex(apiKey, symbol, expiration): Get vanna exposure (VEX) by strike. Shows how dealer hedging changes with volatility moves. Required: symbol.
get_vix_state(apiKey): VIX regime vs SPX realized volatility: overvixing/undervixing/neutral label, spread (VIX minus SPX RV20d), ratio, and interpretation. Use to classify fear gauge premium, identify contango/backwardation in vol term structure, assess short-vol vs long-vol environment, or time volatility-selling strategies.
get_volatility(apiKey, symbol): Get comprehensive volatility analysis: ATM IV, realized vol (5/10/20/30d), VRP, 25-delta skew, IV term structure, GEX by DTE, theta by DTE, hedging scenarios, liquidity metrics. Required: symbol.
get_volatility_forecast(dist, apiKey, symbol): Conditional volatility forecasts: EWMA (RiskMetrics, λ=0.94), HAR-RV (Corsi), and GARCH(1,1) fitted by maximum likelihood with Gaussian or Student-t innovations. Returns fitted params (omega/alpha/beta/dof), persistence, long-run vol, half-life, and a multi-horizon (1/5/21-day) forecast. Alpha tier. Use to forecast next-day/forward volatility or gauge vol mean-reversion. Pass dist='gaussian' or 'student_t' (default student_t). Required: symbol.
get_vrp(apiKey, symbol): Get volatility risk premium (VRP) dashboard: live IV vs realized vol, VRP percentiles, term structure, regime classification, strategy scores, and macro context. Required: symbol.
get_vrp_history(days, apiKey, symbol): Get historical VRP time series: daily ATM IV, realized vol (5/10/20/30d), VRP, straddle price, and expected move for charting and backtesting. Required: symbol.
get_zero_dte(apiKey, symbol, strike_range): Get zero-days-to-expiration (0DTE) analytics: intraday gamma, time decay acceleration, pin risk, dealer hedging pressure for contracts expiring today. Required: symbol.
get_zero_dte_flow(bar, side, view, apiKey, symbol, minutes): LIVE simulation-aware 0DTE flow — snapshot (current net GEX/DEX, gamma flip, walls, pin score, flow direction; fresher than get_zero_dte which uses settled OI and goes stale after ~10:30 ET), series (intraday time-series of 0DTE positioning for charting), hedge_flow (estimated dealer hedge-flow delta-dollars per bar + cumulative since open). Growth+. Required: symbol, view.
post_screener(query, apiKey): Find, rank, and compare symbols across the whole universe in ONE call. Use this whenever the user does NOT name a single ticker but asks which / what / find / scan / screen / rank / top / most / highest / lowest across stocks (e.g. 'which names have the most negative gamma', 'rank tickers by VRP', 'highest IV stocks right now', 'most pinned symbols today', 'cheap IV with positive gamma'). Prefer this over calling per-symbol tools in a loop. Cross-sectional screen/rank by GEX, VRP, 0DTE dominance, IV/term structure, skew, dealer risk, and strategy scores, with filters, sort, select, and custom formulas. Growth = top 10 symbols; Alpha = ~250 symbols + formulas. Required: query.
post_structure_greeks(legs, apiKey): Aggregate Black-Scholes position greeks (delta, gamma, theta, vega, rho, vanna, charm) for a multi-leg options structure. Pure math — pass legs as JSON. Different body than Structure P&L: needs a top-level `spot` and per-leg `expiry`+`impliedVol`. Required: legs.
post_structure_pnl(legs, apiKey): At-expiry P&L curve and breakevens for a multi-leg options structure (vertical spread, iron condor, straddle, butterfly, calendar). Pure math, no market lookup — pass the legs as JSON. Required: legs.
solve_iv(dte, spot, type, price, apiKey, strike): Solve for implied volatility from option market price. Reverse-engineers BSM to find what vol is priced in. Required: spot, strike, dte, price, type.

Last successful function declaration observed on 2026-08-13. Source: https://lab.flashalpha.com/mcp. We list what the server declared; we do not call any of these functions.

Endpoint status observed on 2026-08-13. Source: https://lab.flashalpha.com/mcp.

Signals

These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.

Signal	Value	What it measures	Window	Observed	Source
Latest published version	1.5.0	Latest version string the maintainer published to the registry.	as of fetch	2026-06-07	Model Context Protocol
Registry record last updated	2026-06-07	When the registry record was last updated by its maintainer.	point in time	2026-06-07	Model Context Protocol
First listed in the MCP Registry	2026-06-07	Date this server was first published to the official MCP Registry. Not a usage or quality measure.	point in time	2026-06-07	Model Context Protocol
mcp tools declared	73 tools	Number of functions the server itself declared when asked to list them. This is what the server offers an agent, not a measure of how well any of them work.	as of probe	2026-08-09	lab.flashalpha.com
mcp endpoint status	ok	The server listed 73 functions when asked.	as of probe	2026-08-13	lab.flashalpha.com

Where to get it

This record as data

Every field on this page, with its source and observation date, is in the catalog JSON. Fetch the whole kind at once instead of parsing this HTML.

GET /api/v1/entries/mcp_server.json

flashalpha

What this server can do

Signals

Where to get it

This record as data

Sources