{
  "markdown": "# FlashAlpha MCP Server — Real-Time Options Analytics for AI Assistants\n\nConnect Claude, ChatGPT, Cursor, Windsurf, or any MCP-compatible AI assistant to live options market data. **70+ tools** covering gamma exposure (GEX), delta/vanna/charm exposure, max pain, key dealer-positioning levels, IV surfaces (SVI parameters), VRP analytics + history, expected move, volatility skew & term structure, spot-vol correlation, dispersion / index-vs-component vol arbitrage, liquidity scoring, VIX macro state, the tradeable universe, exposure sheet / term-structure / multi-symbol basket / open-interest diff, Black-Scholes greeks, Kelly sizing, real-time options & stock order flow (sweeps, blocks, dealer premium), 0DTE intraday flow (snapshot, time series, hedge flow, heatmap, strike flow), **10 actionable options-strategy signals** (flow-anomaly, expiry-positioning, 0DTE, dealer-regime, vol-carry, yield-enhancement, surface-anomaly, skew, term-structure, tail-pricing), a full **earnings analytics suite** (calendar, expected move, history, IV crush, VRP, dealer positioning, strategies, screener), multi-leg **structure P&L + greeks** calculators, a multi-factor options **screener** with field taxonomy, plus minute-resolution **historical replay back to April 2018** for backtesting.\n\n---\n\n## What is this repo\n\nDocumentation, setup snippets, and `server.json` metadata for the FlashAlpha remote MCP server. The server itself runs at `https://lab.flashalpha.com/mcp` (and `/mcp-oauth` for OAuth-authenticated clients) — its source is not open. Use this repo as a reference for how to wire FlashAlpha into your AI client of choice.\n\n---\n\n## Server URLs\n\nTwo endpoints, identical tool catalog, different authentication:\n\n| Endpoint | Auth | When to use |\n|---|---|---|\n| `https://lab.flashalpha.com/mcp` | `apiKey` tool parameter | Self-hosted clients: Claude Desktop, Claude Code CLI, Cursor, Windsurf, VS Code Copilot |\n| `https://lab.flashalpha.com/mcp-oauth` | OAuth 2.1 + PKCE + DCR (RFC 7591) | Claude Connector Directory, ChatGPT Apps, Perplexity custom connectors, any host that requires OAuth-authenticated remote MCP |\n\n- **Transport:** Streamable HTTP\n- **Protocol version:** MCP 2025-06-18\n- **OAuth discovery:** [`https://lab.flashalpha.com/.well-known/oauth-protected-resource`](https://lab.flashalpha.com/.well-known/oauth-protected-resource) (RFC 9728)\n- **Authorization server:** `https://flashalpha.com/oauth`\n\n### Persona-scoped endpoints\n\nEach base endpoint also has nine **persona** variants that expose a curated subset of the catalog for a specific trading style. Same auth model — `/mcp/<persona>` takes the `apiKey` parameter, `/mcp-oauth/<persona>` uses OAuth. Point your client at a persona URL instead of the base URL to load just that toolset.\n\n| Persona | API-key URL | OAuth URL |\n|---|---|---|\n| 🧲 Gamma Exposure | `https://lab.flashalpha.com/mcp/gex` | `https://lab.flashalpha.com/mcp-oauth/gex` |\n| 🎯 Directional | `https://lab.flashalpha.com/mcp/directional` | `https://lab.flashalpha.com/mcp-oauth/directional` |\n| 💵 Premium Seller | `https://lab.flashalpha.com/mcp/premium` | `https://lab.flashalpha.com/mcp-oauth/premium` |\n| ⚖️ Spreads & Condors | `https://lab.flashalpha.com/mcp/spreads` | `https://lab.flashalpha.com/mcp-oauth/spreads` |\n| ⚡ 0DTE | `https://lab.flashalpha.com/mcp/0dte` | `https://lab.flashalpha.com/mcp-oauth/0dte` |\n| 📈 Dealer-Positioning Swing | `https://lab.flashalpha.com/mcp/swing` | `https://lab.flashalpha.com/mcp-oauth/swing` |\n| 🌊 Volatility / Relative Value | `https://lab.flashalpha.com/mcp/volarb` | `https://lab.flashalpha.com/mcp-oauth/volarb` |\n| 💻 Quant / Systematic | `https://lab.flashalpha.com/mcp/quant` | `https://lab.flashalpha.com/mcp-oauth/quant` |\n| 📅 Earnings | `https://lab.flashalpha.com/mcp/earnings` | `https://lab.flashalpha.com/mcp-oauth/earnings` |\n\n---\n\n## Quick Setup (self-hosted clients → `/mcp` + `apiKey`)\n\n### Claude Desktop\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"flashalpha\": {\n      \"type\": \"http\",\n      \"url\": \"https://lab.flashalpha.com/mcp\"\n    }\n  }\n}\n```\n\n### Claude Code CLI\n\n```bash\nclaude mcp add flashalpha --transport http https://lab.flashalpha.com/mcp\nclaude mcp list\n```\n\n### Cursor\n\n**Settings → MCP** → Add server:\n\n```json\n{\n  \"flashalpha\": {\n    \"transport\": \"http\",\n    \"url\": \"https://lab.flashalpha.com/mcp\"\n  }\n}\n```\n\n### VS Code (Copilot / Continue)\n\n`.vscode/mcp.json` or user settings:\n\n```json\n{\n  \"servers\": {\n    \"flashalpha\": {\n      \"type\": \"http\",\n      \"url\": \"https://lab.flashalpha.com/mcp\"\n    }\n  }\n}\n```\n\n### Windsurf\n\n**Cascade settings → MCP Servers**:\n\n```json\n{\n  \"flashalpha\": {\n    \"transport\": \"http\",\n    \"url\": \"https://lab.flashalpha.com/mcp\"\n  }\n}\n```\n\n### Perplexity (Pro/Max/Enterprise)\n\n**Settings → Connectors → + Custom connector → Remote**\n\n- URL: `https://lab.flashalpha.com/mcp-oauth`\n- Auth: OAuth (walks the consent flow at `flashalpha.com/oauth/login`)\n\n---\n\n## Authentication\n\n### `/mcp` (apiKey)\n\nEvery tool call takes `apiKey` as a string parameter. Get a free key at [flashalpha.com](https://flashalpha.com).\n\n```\napiKey: \"fa_your_key_here\"\n```\n\nKey passes per-call rather than in a header so it works uniformly across all MCP clients without transport-level configuration.\n\n### `/mcp-oauth` (Bearer)\n\nOAuth 2.1 + PKCE + Dynamic Client Registration (RFC 7591). The client registers itself, walks the authorization-code + PKCE flow, and presents a Bearer JWT on each request. **No `apiKey` parameter needed** — the server resolves the user's account from the OAuth identity and forwards the API key internally for upstream `/v1/*` calls. Same per-user tier gating and rate limits apply as the apiKey flow.\n\nDiscovery + endpoints:\n\n| | |\n|---|---|\n| RFC 9728 protected-resource metadata | `https://lab.flashalpha.com/.well-known/oauth-protected-resource` |\n| OIDC discovery | `https://flashalpha.com/oauth/.well-known/openid-configuration` |\n| JWKS | `https://flashalpha.com/oauth/.well-known/jwks` |\n| Dynamic Client Registration | `POST https://flashalpha.com/oauth/register` |\n| Authorization endpoint | `https://flashalpha.com/oauth/authorize` |\n| Token endpoint | `https://flashalpha.com/oauth/token` |\n| Scope | `flashalpha.mcp` |\n\n---\n\n## Data provenance: `data_as_of`\n\nEvery tool result carries the API's response envelope: `data_as_of`, reporting when each\nupstream feed last delivered to the node that answered, and `endpoint_version` identifying\nthe deployment that produced it.\n\n| Field | Feed | Expected cadence |\n|---|---|---|\n| `node` | Which node answered | Nodes hydrate independently |\n| `equity_feed` | Equity and ETF spot quotes | seconds, during market hours |\n| `equity_options_feed` | Equity and ETF option quotes | seconds, during market hours |\n| `index_feed` | Index spot (SPX, RUT, VIX and the other index roots) | seconds, during market hours |\n| `index_options_feed` | Index option quotes | seconds, during market hours |\n| `futures_feed` | Futures prices | seconds, during the futures session |\n| `futures_options_feed` | Futures option quotes | seconds, during the futures session |\n| `flow_feed` | Classified options and stock trade tape | seconds, during market hours |\n| `oi_feed` | Settled open interest | daily, dated to the prior 16:00 ET close |\n| `macro_feed` | VIX, VVIX, SKEW, MOVE, SPX, Fear & Greed | minutes; reports its OLDEST component |\n\nThis matters more for an MCP client than for a normal SDK caller: a model reading a tool\nresult has no other way to tell a current figure from a stale one, and will otherwise\npresent both with equal confidence.\n\n### How to read it\n\n- **Check the feeds the tool depends on.** A GEX call on an equity is answered from\n  `equity_feed`, `equity_options_feed` and `oi_feed`. `futures_feed` being `null` in that\n  result says nothing about the answer.\n- **Compare against the cadence, not the clock.** `oi_feed` at the previous session's\n  close is correct: settled open interest is published once per session, so on a Monday\n  the newest figure that exists is Friday's. An options feed an hour behind during the\n  regular session is not correct.\n- **`null` means \"not seen on this node\", not \"broken\".** A node that has never been\n  asked for a futures symbol has never opened that feed.\n- **Spot and options are separate on purpose.** They arrive over different pipes and can\n  fail independently, so an index chain can be current while the index level behind it is\n  not.\n- **It evidences feed activity, not per-contract freshness.** An illiquid strike may not\n  have quoted for hours while its feed is healthy.\n- **`data_as_of` is not `as_of`.** `as_of` is response-generation time or the newest\n  contract in the payload, depending on the endpoint. `data_as_of` describes the feeds\n  behind it.\n\nHistorical replay tools carry a second object, `archive_as_of`, in the same shape: the\nvintage of the archive rows actually replayed for the timestamp requested. Their\nevery feed in `data_as_of` is `null`, because a replay node reads the archive and consumes no live\nfeed.\n\nFull reference: <https://flashalpha.com/docs/lab-api-overview#response-envelope> and the\nmethodology whitepaper at <https://flashalpha.com/methodology#freshness-reporting>.\n\n## Tool Catalog (70+ tools)\n\nTool names below are the **exact strings sent via `tools/call`** — snake_case, not the PascalCase C# method names. Copy verbatim.\n\n### Live tools\n\n#### Market Data (6)\n| Tool | Description |\n|---|---|\n| `get_stock_quote` | Real-time stock quote (bid, ask, mid, last) |\n| `get_tickers` | List/search available tickers |\n| `get_symbols` | Full list of supported underlying symbols |\n| `get_option_chain` | Available expirations + strikes metadata |\n| `get_option_quote` | Live option quote: bid, ask, mid, IV, greeks, OI, volume (`expiry`, `strike`, `type`) |\n| `get_account` | Plan, daily quota, usage today, remaining calls |\n\n#### Exposure Analytics (13)\n| Tool | Description |\n|---|---|\n| `get_gex` | Gamma exposure (GEX) by strike — call/put walls, gamma flip (`expiration`, `min_oi`) |\n| `get_dex` | Delta exposure (DEX) by strike — net dealer delta (`expiration`) |\n| `get_vex` | Vanna exposure (VEX) by strike — dealer hedging response to vol moves (`expiration`) |\n| `get_chex` | Charm exposure (CHEX) by strike — time-decay-driven flows (`expiration`) |\n| `get_levels` | Gamma flip, call/put walls, max pain, highest OI strike, 0DTE magnet |\n| `get_exposure_summary` | Net GEX/DEX/VEX/CHEX, regime, hedging estimates, top strikes, 0DTE breakdown |\n| `get_exposure_sheet` | Per-strike greeks exposure sheet (GEX/DEX/VEX/CHEX side by side) with `expiration`, `min_oi` filters |\n| `get_term_structure` | Exposure term structure — net GEX/DEX/VEX/CHEX bucketed by expiry/DTE |\n| `get_exposure_basket` | Aggregate dealer exposure across a multi-symbol basket (`symbols` required, optional `weights`) |\n| `get_oi_diff` | Day-over-day open-interest change by strike — top OI builders/unwinds (`topN`) |\n| `get_narrative` | Verbal analysis: regime, levels, dealer positioning, implications |\n| `get_max_pain` | Max pain strike, pain curve, put/call OI ratio, dealer alignment, pin probability (`expiration`) |\n| `get_zero_dte` | 0DTE analytics: intraday gamma, time-decay acceleration, pin risk, hedging pressure (`expiry`, `strike_range`) |\n\n#### Volatility & Pricing (19)\n| Tool | Description |\n|---|---|\n| `get_surface` | Live 50×50 implied-volatility surface grid over (tenor, log-moneyness) |\n| `get_svi_params` | SVI (stochastic-volatility-inspired) calibrated surface parameters per tenor (Alpha) |\n| `get_volatility` | ATM IV, realized vol (5/10/20/30d), VRP, 25-δ skew, term structure, GEX-by-DTE |\n| `get_advanced_volatility` | SVI parameters, forward prices, variance surface, arbitrage flags, vanna/charm/volga surfaces, variance-swap fair values (Alpha) |\n| `get_expected_move` | Straddle-implied expected move (1σ) by expiry — bands, % move, breakevens (`expiry`) |\n| `get_skew_term` | Volatility skew across strikes and term structure across expiries in one call |\n| `get_spot_vol_correlation` | Realized spot-vol correlation / leverage effect for the underlying |\n| `get_realized_vol` | Realized-vol estimators (close-to-close, Parkinson, Garman-Klass, Rogers-Satchell, Yang-Zhang) at 10/20/30-day windows (Alpha) |\n| `get_volatility_forecast` | Volatility forecasts: EWMA, HAR-RV, GARCH with multi-horizon term structure (`dist` = student_t default, gaussian) (Alpha) |\n| `get_liquidity` | Options-chain liquidity score: spreads, depth, volume/OI quality |\n| `get_dispersion` | Index-vs-component dispersion / correlation vol-arbitrage (`index`, `symbols` required, `weights`, `horizon_days`) (Alpha) |\n| `get_vix_state` | VIX macro state: level, term structure, percentile, contango/backwardation regime |\n| `get_universe` | Tradeable universe ranked by liquidity/coverage (`sort`, `limit`) |\n| `get_vrp` | Volatility risk premium dashboard: IV vs RV, percentiles, regime, strategy scores (`date`) |\n| `get_vrp_history` | Historical VRP time series for charting + backtesting (`days`) |\n| `get_stock_summary` | One-call combined summary: price, IV, VRP, skew, term, exposure, macro context |\n| `calculate_greeks` | Black-Scholes greeks (Δ, Γ, Θ, ν, ρ, vanna, charm, speed, zomma, color) |\n| `solve_iv` | Solve implied volatility from market price (BSM inversion) |\n| `calculate_kelly` | Kelly criterion optimal sizing for an option trade |\n\n#### Order Flow — Options & Stocks (real-time, simulation-aware)\n| Tool | Description |\n|---|---|\n| `get_flow_live` | Headline live flow bundle in one call: effective OI state, live levels, live GEX/DEX totals, pin-risk score, dealer-risk summary. `view='gex'` returns the full simulation-aware live GEX surface, `view='dex'` live DEX, `view='oi'` the raw OI simulator state |\n| `get_flow_summary` | Net signed options premium, call/put flow, sweep vs block breakdown (`expiry`) |\n| `get_flow_levels` | Flow-derived support/resistance and dealer hedging levels (`expiry`) |\n| `get_flow_signals` | Scored actionable flow signals — intent, structure, conviction (`minScore`, `intent`, `structure`, `windowMinutes`, `limit`, `expiry`) |\n| `get_flow_pin_risk` | Real-time pin-risk estimate from live flow + positioning (`expiry`) |\n| `get_flow_dealer_risk` | Live dealer gamma/delta risk from intraday flow (`expiry`) |\n| `get_dealer_premium` | Dealer-side options premium attribution (sold/bought) over a window (`windowMinutes`, `expiry`) |\n| `get_option_flow` | Raw recent option prints, blocks, sweeps, cumulative & history (`minSize`, `minutes`, `limit`, `expiry`) |\n| `get_stock_flow` | Raw recent stock prints, blocks, bars, cumulative & history (`resolution`, `minSize`, `minutes`, `limit`) |\n| `get_flow_scan` | Cross-symbol flow leaderboards & outliers (`n`, `limit`, `minTrades`, `windowMinutes`) |\n\n#### 0DTE Intraday Flow\n| Tool | Description |\n|---|---|\n| `get_zero_dte_flow` | 0DTE flow snapshot: live exposure + net flow direction by strike, plus intraday series, hedge flow, heatmap, and strike-flow views (`bar`, `minutes`, `side`, `metric`, `mode`) |\n\n#### Strategy Signals (10 strategies via `get_strategy`)\nOne tool, parameterized by `strategy` kind, returning the uniform strategy-decision envelope (`decision`, `score`, `confidence`, `regime`, `best_structures[]`, `metrics`, `risk_flags[]`, `why[]`, `avoid_if[]`, `data_quality`).\n| `strategy` value | Description |\n|---|---|\n| `flow_anomaly` | Directional options-flow imbalance → matching short vertical spread (`expiry`) |\n| `expiry_positioning` | Dealer expiry positioning → iron-condor / butterfly candidates (`expiry`, `minOpenInterest`, `wingWidth`) |\n| `zero_dte` | 0DTE intraday setup → defined-risk spreads (`expiry`, `minOpenInterest`, `wingWidth`) |\n| `dealer_regime` | Gamma regime read (long/short gamma) → directional bias (`expiry`) |\n| `vol_carry` | Vol carry / theta harvest → short-premium structures (`targetShortDelta`, `maxWidth`, `minCredit`, ...) |\n| `yield_enhancement` | Covered-call / cash-secured-put yield (`targetDelta`, `structure`, `excludeEarningsBeforeExpiry`, ...) |\n| `surface_anomaly` | IV-surface mispricing / arbitrage candidates (`expiry`) |\n| `skew` | Skew steepness/richness → risk-reversal / ratio ideas (`expiry`) |\n| `term_structure` | Calendar / diagonal opportunities from term-structure shape |\n| `tail_pricing` | Tail-risk richness → cheap-convexity / hedge candidates (`expiry`) |\n\n#### Earnings Analytics\n| Tool | Description |\n|---|---|\n| `get_earnings` | Per-symbol earnings analytics: expected move, history, IV crush, VRP, dealer positioning, and strategies (parameterized) |\n| `get_earnings_calendar` | Upcoming earnings calendar with expected moves (`days`, `symbols`, `importance`) |\n| `get_earnings_screener` | Rank earnings names by IV-crush edge / VRP / expected move (`sort`, `limit`, `days`, `min_importance`) |\n\n#### Structures (multi-leg, pure-math)\n| Tool | Description |\n|---|---|\n| `post_structure_pnl` | Multi-leg structure P&L curve across an underlying range (`legs[]`, `minUnderlying`, `maxUnderlying`, `points`) |\n| `post_structure_greeks` | Aggregate greeks for a multi-leg structure (`legs[]` with `expiry`+`impliedVol`, `spot`, `today`, `rate`, `dividendYield`) |\n\n#### Screener\n| Tool | Description |\n|---|---|\n| `post_screener` | Multi-factor options screener: `universe`, `filters`, `formulas`, `sort`, `select`, `limit`, `offset` |\n| `get_screener_fields` | Screener field taxonomy — every filterable/selectable field and type |\n\n### Futures (CME)\n\nFlashAlpha serves the full options-analytics stack for **CME futures** across six complexes - equity index (`ES=F`, `NQ=F`, `RTY=F`, `YM=F`, `MES=F`, `MNQ=F`), metals (`GC=F` gold, `SI=F` silver), energy (`CL=F` crude oil, `NG=F` natural gas), the Treasury curve (`ZT=F`, `ZF=F`, `ZN=F`, `TN=F`, `ZB=F`, `UB=F`), grains (`ZC=F` corn, `ZS=F` soybeans, `ZW=F` wheat) and crypto (`BTC=F` bitcoin). Options-on-futures are priced with **Black-76** (forward-priced) and each root carries its own CME contract multiplier, so notionals and dollar gamma are in real dollars. Note the quote conventions: Treasuries are quoted in points of par and grains in cents, so their multipliers are the contract size divided by 100. Everything that works for an equity works for futures: gamma exposure (GEX), DEX, VEX, CHEX, key levels, max pain, the IV surface, exposure summary, narrative, and live flow.\n\nCall any live tool with the futures symbol — e.g. `get_gex` with `symbol: \"ES=F\"` returns gamma exposure for the E-mini S&P 500 future:\n\n```json\n{ \"symbol\": \"ES=F\" }\n```\n\nUse the `=F` suffix - bare `ES`/`NQ` are equities, not futures. In raw REST paths URL-encode the `=` as `%3D` (e.g. `GET /v1/exposure/gex/GC%3DF`); SDK methods take the plain string `\"GC=F\"`. Futures symbols require the Growth plan or higher. Historical replay for futures is coming; live analytics are available now.\n\n---\n\n### Historical replay tools (17, Alpha tier)\n\nAll historical tools take a required `at=YYYY-MM-DDTHH:mm:ss` parameter (ET wall-clock) and replay the matching live analytic at any minute since 2017-01-03. Response shapes are identical to the live counterparts — backtesting code that parses live responses works on historical with a tool-name swap.\n\n| Tool | Mirrors |\n|---|---|\n| `get_historical_gex` | `get_gex` |\n| `get_historical_dex` | `get_dex` |\n| `get_historical_vex` | `get_vex` |\n| `get_historical_chex` | `get_chex` |\n| `get_historical_levels` | `get_levels` |\n| `get_historical_exposure_summary` | `get_exposure_summary` |\n| `get_historical_narrative` | `get_narrative` |\n| `get_historical_zero_dte` | `get_zero_dte` |\n| `get_historical_max_pain` | `get_max_pain` |\n| `get_historical_volatility` | `get_volatility` |\n| `get_historical_advanced_volatility` | `get_advanced_volatility` |\n| `get_historical_vrp` | `get_vrp` |\n| `get_historical_surface` | `get_surface` |\n| `get_historical_stock_quote` | `get_stock_quote` |\n| `get_historical_option_quote` | `get_option_quote` |\n| `get_historical_stock_summary` | `get_stock_summary` |\n| `get_historical_coverage` | List symbols backfilled with coverage windows and gaps — call first to check whether (symbol, date range) is queryable |\n\n**Note:** The multi-factor options screener is now exposed as the `post_screener` MCP tool (with `get_screener_fields` for the field taxonomy), in addition to `POST /v1/screener`. The historical replay tools cover analytics only; for raw historical tick data use the historical REST endpoints directly.\n\n---\n\n## MCP Resources (5)\n\nThe server publishes 5 markdown documents as MCP Resources so connected clients can pull the full reference into context with one call instead of relying on tool descriptions:\n\n| URI | Title |\n|---|---|\n| `flashalpha://docs/api` | Live API reference (every REST endpoint at api.flashalpha.com) |\n| `flashalpha://docs/historical` | Historical replay reference |\n| `flashalpha://docs/mcp` | This document |\n| `flashalpha://docs/screener` | Live screener spec (filter DSL, sorts, formulas) |\n| `flashalpha://docs/screener-fields` | Screener field taxonomy |\n\n---\n\n## MCP Prompts (4)\n\nCanonical workflow templates that surface in Claude Desktop / Cursor / Windsurf UI as one-click recipes:\n\n| Prompt | Description |\n|---|---|\n| `analyze_exposure(symbol)` | Full dealer-positioning walkthrough — gamma regime, key levels, hedging pressure, 0DTE contribution |\n| `vrp_regime_check(symbol)` | VRP percentile, IV-vs-RV richness, strategy scoring conditioned on the gamma regime |\n| `historical_comparison(symbol, reference_date)` | Side-by-side current vs past date, with VIX-context sanity check |\n| `zero_dte_brief(symbol)` | Pre-session 0DTE brief — pin risk, expected move, gamma acceleration, ±0.5% hedging tilts |\n\n---\n\n## Example Prompts\n\nOnce connected, ask your AI assistant questions like:\n\n1. *\"What is SPX dealer gamma positioning right now?\"*\n2. *\"Show me 0DTE setup for SPY today — pin risk, expected move, gamma acceleration.\"*\n3. *\"Give me a full options picture for NVDA — IV, RV, VRP, skew, term, exposure, macro.\"*\n4. *\"Replay SPY gamma exposure on 2020-03-16 at 14:00 ET.\"*\n5. *\"Calculate Black-Scholes greeks for SPY 580 calls expiring next Friday at 18% IV.\"*\n6. *\"What is implied volatility for an NVDA 900 put trading at $12.50 with spot $875?\"*\n7. *\"Where is the gamma flip and call/put walls for QQQ today?\"*\n8. *\"Compare current SPX dealer positioning to 2024-04-19.\"*\n9. *\"What's the VRP percentile for AAPL vs its 90-day distribution?\"*\n10. *\"Generate a 0DTE brief for SPY before the open.\"*\n11. *\"Run the flow-anomaly strategy signal on TSLA and show me the best defined-risk structure.\"*\n12. *\"What's the expected move for NVDA into Friday expiry, and what's IV crush looked like the last 8 earnings?\"*\n13. *\"Show this week's earnings calendar with expected moves, then screen for the best IV-crush short-premium setups.\"*\n14. *\"Price the P&L curve and aggregate greeks for an SPY iron condor: short 580/590 call spread, short 560/550 put spread.\"*\n15. *\"Give me the SPX dealer exposure sheet and term structure, plus the day-over-day OI diff.\"*\n16. *\"What's the dispersion / index-vs-component vol-arb read on SPX against its top components?\"*\n17. *\"Show the VIX macro state and the dealer-premium flow on QQQ over the last 30 minutes.\"*\n\n---\n\n## Plans & Pricing\n\nFour tiers. Annual saves 20% and locks the price for 12 months.\n\n| Plan | Monthly | Annual (per month) | Annual total | Daily quota | Freshness |\n|---|---|---|---|---|---|\n| **Free** | $0 | — | — | 5 / day | 15-minute |\n| **Basic** | $79/mo | $63/mo | $756/yr | 100 / day | 15-second |\n| **Growth** | $299/mo | $239/mo | $2,868/yr | 2,500 / day | 15-second |\n| **Alpha** | $1,499/mo | $1,199/mo | $14,388/yr | Unlimited | No cache (real-time) |\n\n### What unlocks at each tier\n\n| Capability | Free | Basic | Growth | Alpha |\n|---|:-:|:-:|:-:|:-:|\n| Single-stock GEX (single expiry), call/put walls, gamma flip | ✓ | ✓ | ✓ | ✓ |\n| BSM greeks, IV solver, stock quotes | ✓ | ✓ | ✓ | ✓ |\n| ETFs / indexes (SPY, QQQ, IWM, SPX) | — | ✓ | ✓ | ✓ |\n| DEX / VEX / CHEX, max pain, Market Overview | — | ✓ | ✓ | ✓ |\n| Full-chain GEX, 0DTE analytics, option quotes, volatility analytics, AI narrative, Kelly criterion | — | — | ✓ | ✓ |\n| Live Screener — 20-symbol Tier 1 universe | — | — | ✓ | ✓ |\n| Live Screener — full ~250-symbol universe (REST) | — | — | — | ✓ |\n| Advanced volatility (SVI, variance surfaces, arbitrage detection, higher-order greeks surfaces) | — | — | — | ✓ |\n| VRP analytics + history | — | — | — | ✓ |\n| Historical API — minute-resolution replay since 2017-01-03 | — | — | — | ✓ |\n| 99.9% uptime SLA | — | — | — | ✓ |\n\nTier gating is enforced server-side per tool. Callers hitting a tool above their tier receive a 403 with the required plan in the response body. Current pricing: [flashalpha.com/pricing](https://flashalpha.com/pricing).\n\n---\n\n## SDKs\n\n| Language | Package | Repository |\n|----------|---------|------------|\n| Python | `pip install flashalpha` | [flashalpha-python](https://github.com/FlashAlpha-lab/flashalpha-python) |\n| JavaScript | `npm i flashalpha` | [flashalpha-js](https://github.com/FlashAlpha-lab/flashalpha-js) |\n| .NET | `dotnet add package FlashAlpha` | [flashalpha-dotnet](https://github.com/FlashAlpha-lab/flashalpha-dotnet) |\n| Java | Maven Central | [flashalpha-java](https://github.com/FlashAlpha-lab/flashalpha-java) |\n| Go | `go get github.com/FlashAlpha-lab/flashalpha-go` | [flashalpha-go](https://github.com/FlashAlpha-lab/flashalpha-go) |\n\n---\n\n## Links\n\n- [FlashAlpha](https://flashalpha.com) — API keys, docs, pricing\n- [API Documentation](https://flashalpha.com/docs)\n- [MCP server docs (canonical)](https://flashalpha.com/docs/mcp)\n- [llms.txt](https://flashalpha.com/llms.txt) — machine-readable index for LLMs\n- [Examples](https://github.com/FlashAlpha-lab/flashalpha-examples) — runnable tutorials\n- [GEX Explained](https://github.com/FlashAlpha-lab/gex-explained)\n- [0DTE Options Analytics](https://github.com/FlashAlpha-lab/0dte-options-analytics)\n- [Volatility Surface Python](https://github.com/FlashAlpha-lab/volatility-surface-python)\n- [Awesome Options Analytics](https://github.com/FlashAlpha-lab/awesome-options-analytics)\n\n## What the paid tiers unlock\n\nThe free tier covers single-expiry GEX on equities, key levels, the BSM Greeks/IV\ncalculator and stock quotes. Paid tiers add:\n\n- **DEX, VEX (vanna) and CHEX (charm) exposure, plus max pain** — from the **Basic tier**\n  ($79/mo), with ETF and index symbols.\n- **Full-chain GEX, 0DTE and flow analytics** — from the **Growth tier** ($299/mo).\n- **Point-in-time replay since 2017, SVI vol surfaces, VRP analytics, higher-order Greeks**,\n  uncached and unlimited — the **Alpha tier** ($1,499/mo). FlashAlpha is one of the only\n  public APIs publishing aggregate vanna and charm exposure across the full universe, with\n  no look-ahead and no training-serving skew.\n\nBuilt for quants, prop desks, and vol funds. See the full picture and get a key:\n**[flashalpha.com/for-quant-teams](https://flashalpha.com/for-quant-teams?utm_source=github&utm_medium=readme&utm_campaign=repo-flashalpha-mcp)**\n",
  "bytes": 27233,
  "sha": "14ea4dc87620901d88284ec972a5575fed0b1bd69cddc0b22b56cc6f4fe3c725",
  "repo_slug": "flashalpha-lab/flashalpha-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_tdobrowolski1_flashalpha_bc9c7e05/readme"
}