MCP server

OptionWhales Official

io.optionwhales/options-flow

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

US options flow & stock data: unusual activity, gamma levels, IV, earnings. OAuth sign-in or keys.

Website

At a glance

Type

MCP server

Publisher

optionwhales.io (verified by the MCP Registry)

Status

Working at last check

Tools

35

Token cost

About 5,712 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http options-flow https://api.optionwhales.io/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.options-flow]
url = "https://api.optionwhales.io/mcp"

Gemini CLI

{"mcpServers":{"options-flow":{"httpUrl":"https://api.optionwhales.io/mcp"}}}

Cursor

{"mcpServers":{"options-flow":{"url":"https://api.optionwhales.io/mcp"}}}

VS Code

{"servers":{"options-flow":{"type":"http","url":"https://api.optionwhales.io/mcp"}}}

Antigravity

agy mcp add options-flow https://api.optionwhales.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"options-flow","server_url":"https://api.optionwhales.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"options-flow","server_url":"https://api.optionwhales.io/mcp"}

Tools

• abnormal_trades_current ~167 tokens
  Unusual options activity this session — large, sweep-like or volume-versus-open-interest outlier orders with ticker, direction, size and time. Use for 'any unusual options activity in NVDA?' or 'biggest options trades today'. Without an account: the latest 3 trades (ticker, direction, type, time); f
• confirm_registration ~106 tokens
  Confirm a key from register_free_key using the code in the 'Confirm your OptionWhales API key' email, which makes the key permanent. Safe to call again.
• contract_atm ~171 tokens
  Near-the-money option strikes grouped by expiry, within a band around spot (default plus or minus 5%). Use to find the liquid at-the-money contracts for a ticker. Pro.
• contract_chain ~217 tokens
  Option chain for a ticker from the latest open-interest snapshot: each contract's OCC symbol, strike, expiry, type and open interest (OI > 0). Filter by expiry, call/put or minimum OI. Pro.
• contract_historic ~136 tokens
  Daily OHLC price bars for one option contract by OCC symbol (e.g. SPY260130C00600000) between two dates, about a year of look-back. Pro.
• darkpool_ranking ~114 tokens
  Off-exchange (dark pool) activity: the market-wide off-exchange share and a per-ticker ranking by off-exchange notional for a date (default latest). Use for 'where is dark pool activity concentrated?'. Pro.
• darkpool_time_profile ~270 tokens
  WHEN one ticker's off-exchange (dark pool) volume traded, by price, for a date (default latest): a 5-minute × price grid of shares, the point of control and value area, and the largest block prints at their report time (outside_nbbo flags prints reported beyond the quote, away_from_quote those price
• directional_current ~124 tokens
  Per-ticker directional score for this session (-1 bearish to +1 bullish) combining net premium, order clustering and implied volatility. Use to rank names by bullish or bearish options positioning. Pro.
• dividends ~117 tokens
  Cash dividend history for a stock: amount, frequency, ex-dividend and pay dates. Pro.
• earnings_calendar ~217 tokens
  Upcoming earnings reports: date, before/after market, EPS and revenue estimates. Pass a ticker for 'when does NVDA report?', or omit it for 'who reports this week?' (days sets the window, default 7). Without an account: date and time for one ticker or the next 3 reporters; free: up to 10 with estima
• earnings_current ~89 tokens
  Options positioning around earnings for companies reporting this session: pre-earnings order flow, Greeks and intent signals. Use for 'how are traders positioned into NVDA earnings?'. Pro.
• economic_calendar ~128 tokens
  Upcoming US economic events (CPI, FOMC, jobs, GDP and more) with impact level and the ETFs that historically react. Use for 'what macro events are coming up?'. Without an account: the next 3 high-impact events; free and Pro: the full calendar.
• financials ~153 tokens
  Company financial statements (income statement, balance sheet, cash flow) for trailing-twelve-month, quarterly or annual periods, latest first. Pro.
• gex_levels ~285 tokens
  Dealer gamma-exposure key levels for a ticker: gamma flip, max pain, call wall, put wall and spot. Call wall = the strike at/above spot with the largest call gamma, put wall = the strike at/below spot with the largest put gamma; max pain is struck per expiration and max_pain_expiry names the (front)
• greek_exposure ~174 tokens
  Dealer gamma, charm and vanna exposure for a ticker, by strike and by expiry (calls, puts, net). Use for detailed hedging-flow analysis beyond the key GEX levels. session defaults to the latest trading day. Pro.
• insider_trades ~145 tokens
  SEC Form 4 insider transactions for a stock, latest first: insider, transaction code, shares, price, value and the SEC filing link. Use for 'are insiders buying AAPL?'. Pro.
• intent_flow_current ~150 tokens
  Today's options-flow intent rankings: which tickers show bullish vs bearish institutional positioning (accumulation, distribution, hedging), with direction bias and strength. Use for 'what are big options traders doing today?' or 'where is smart money flowing?'. Without an account: top 3 tickers (ti
• market_tide ~156 tokens
  Market-wide options net-premium 'tide': signed large-order premium into calls versus puts, its intraday cumulative curve, and the top net-premium tickers for a session. Use for 'is options flow bullish or bearish overall today?'. Pro.
• momentum_rankings ~123 tokens
  Tickers ranked by options-flow momentum (the fastest-changing positioning this session). Use for 'which stocks have the strongest options momentum right now?'. Free keys: top 3; Pro: up to 200 with all fields.
• oi_movers ~123 tokens
  Tickers ranked by day-over-day change in total options open interest (top gainers, losers, most active). Use for 'where is new options positioning building?'. Pro.
• oi_timeseries ~137 tokens
  Open interest and volume across recent snapshots for one ticker (calls, puts, total). Use to see whether options positioning is building or unwinding. Pro.
• register_free_key ~259 tokens
  Get a FREE OptionWhales API key for the person you are helping. Only use this if they do not already have a key. Pass their own email address (ask if unsure). The key in the response works immediately for 24 hours, and this MCP session starts using it automatically when the client supports sessions.
• screener ~421 tokens
  Screen the market across options-flow net premium, open-interest change, FDA catalysts and congressional trading. Filter by direction, minimum premium or OI change, catalyst window, trial phase or congress activity; sort and limit. Use for 'find bullish options-flow names with an FDA catalyst in the
• seasonality ~134 tokens
  Monthly seasonality for a stock: average and median return by calendar month, hit rate, best and worst years over a 1 to 25 year look-back. Pro.
• sector_tide ~93 tokens
  Options net premium aggregated by sector for a session. Use for 'which sectors are seeing bullish options flow?'. Pro.
• short_interest ~132 tokens
  FINRA short interest history (bi-weekly settlements) with days to cover for a stock. Use for 'how heavily shorted is GME?'. Pro.
• short_volume ~119 tokens
  Daily FINRA short-sale volume and short-volume ratio for a stock, with per-venue split. Pro.
• stock_candles ~204 tokens
  Intraday OHLCV bars for a stock on a session (default today), 1 to 60 minute bars; returns the most recent `limit` bars. Live bars are real-time for watchlisted symbols and 15 minutes delayed otherwise. Pro.
• stock_news ~137 tokens
  Recent news for a ticker, each article with a pre-computed sentiment (positive, negative, neutral) and its reasoning. Use for 'why is TSLA moving?'. Pro.
• stock_quote ~118 tokens
  Latest price for a stock or ETF. Real-time for symbols on your key's real-time watchlist; otherwise the most recent price at least 15 minutes old. Use for 'what is NVDA trading at?'. Pro.
• stock_splits ~113 tokens
  Stock split history for a ticker: execution date and split ratio. Pro.
• technical_indicator ~278 tokens
  Technical indicator series for a stock: SMA, EMA, RSI or MACD on adjusted closes (daily by default), latest first. Use for 'is AAPL overbought?' (RSI) or trend questions. Pro.
• use_api_key ~105 tokens
  Attach an existing OptionWhales API key to this MCP session, for clients that cannot send an X-API-Key header. Use when the person gives you their key.
• volatility_movers ~145 tokens
  Tickers whose 30-day at-the-money implied volatility moved most versus the prior close (expansions and/or compressions). Use for 'which stocks saw the biggest IV spikes today?'. Free keys: top 3; Pro: up to 50.
• volatility_term_structure ~152 tokens
  At-the-money implied volatility by expiration (the IV term structure), plus spot and the overall ATM IV for a ticker. Use for 'is NVDA implied volatility elevated?' or 'is the vol curve inverted before earnings?'. Free keys: SPY, QQQ, AAPL, MSFT, GOOGL, AMZN, NVDA, META, TSLA; Pro: any ticker.

Browse

• Email
• Calendars
• Stocks and markets

Related MCP servers

• OptionsBell Options Flow
  Unusual options activity on 7,000+ US stocks: top prints, streaks, IV rank, sentiment, sectors.
• The Stall
  277 pay-per-call MCP tools: YouTube keyword research, stocks, crypto, DeFi, options, macro.
• Sell The News
  Real-time US stock market news, r/wallstreetbets sentiment, options GEX & max pain, daily recaps
• Intrinio
  Intrinio MCP — premium financial data (intrinio.com)
• Flashalpha
  Real-time & historical options analytics: GEX, dealer positioning, vol, VRP, 0DTE, CME futures
• Tickwind US Market Boards
  No-API-key US market boards from SEC, Cboe, FINRA and CFTC: options flow, insiders, 13F, buybacks
• FirmTape - SPX, ES, NQ, RTY gamma levels, 100+ symbols
  SPX, ES, NQ and RTY futures gamma levels (GEX), 1,000+ SPX sessions, plus 100+ ETFs and stocks
• Market Intelligence API
  Market data for AI agents via x402: token safety, DeFi yields, order flow, SEC filings, macro, perps

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.optionwhales/options-flow.svg)](https://aptlynx.net/servers/io.optionwhales/options-flow)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents