List your agent

OptionWhales

MCP server● Hosted · onlinev1.4.0

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

Reviews

No review yet. Used OptionWhales? Be the first to help others choose.

What it does

OptionWhales is an MCP server, a connector that lets an AI assistant use it as a tool. It is hosted: an assistant connects to it over the internet, nothing to install.

No capability identified yet from its description.

Facts come from the Official MCP Registry, as declared by the publisher. Capabilities are matched automatically (low confidence). None of this is a test of the tool.

At a glance

Hosted (remote)YES
Local installNO
Version1.4.0
PriceNot in the registry
First seen02 Oct 2026
Last checked1d ago

How to connect

As declared in the Official MCP Registry · hosted endpoint tested by Electra Index 2d ago (live check)

Hosted endpoints

  • https://api.optionwhales.io/mcp streamable-http
  • https://api.optionwhales.io/mcp/connect streamable-http

In Claude Code: claude mcp add --transport http optionwhales https://api.optionwhales.io/mcp

MCP settings (Claude Desktop, Cursor and other MCP clients)

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

Live check

Electra Index connected to the hosted endpoint 2d ago

ONLINE OptionWhales answered an MCP connection on 15 Nov 2026 and introduced itself as optionwhales-pro-api 1.4.1 (MCP protocol 2025-06-18).

37 tools offered to AI assistants

  • intent_flow_current · Today's options-flow intent rankings: which tickers show bullish vs bearish large-order positioning signals (accumulation, distribution, hedging), with direction bias and strength. Use for 'what does large-order options flow show today?'. W
  • momentum_rankings · 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.
  • abnormal_trades_current · 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 'latest unusual options trades today'. Returne
  • directional_current · 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.
  • market_tide · 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.
  • sector_tide · Options net premium aggregated by sector for a session. Use for 'which sectors are seeing bullish options flow?'. Pro.
  • darkpool_ranking · 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 · 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 p
  • earnings_current · 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 · 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 calend
  • earnings_calendar · 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 on
  • gex_levels · Modeled dealer gamma-exposure key levels for a ticker: gamma flip, max pain, call wall, put wall and spot. When timestamps are present, calculated levels belong to the options snapshot at computed_at; spot may be updated independently at sp
Show 25 more
  • greek_exposure · 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.
  • volatility_term_structure · 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,
  • volatility_movers · 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.
  • oi_movers · 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 · Open interest and volume across recent snapshots for one ticker (calls, puts, total). Use to see whether options positioning is building or unwinding. Pro.
  • contract_chain · 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_atm · 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_historic · Daily OHLC price bars for one option contract by OCC symbol (e.g. SPY260130C00600000) between two dates, about a year of look-back. Pro.
  • stock_quote · 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_candles · 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.
  • technical_indicator · 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.
  • financials · Company financial statements (income statement, balance sheet, cash flow) for trailing-twelve-month, quarterly or annual periods, latest first. Pro.
  • dividends · Cash dividend history for a stock: amount, frequency, ex-dividend and pay dates. Pro.
  • stock_splits · Stock split history for a ticker: execution date and split ratio. Pro.
  • stock_news · 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.
  • short_interest · FINRA short interest history (bi-weekly settlements) with days to cover for a stock. Use for 'how heavily shorted is GME?'. Pro.
  • short_volume · Daily FINRA short-sale volume and short-volume ratio for a stock, with per-venue split. Pro.
  • insider_trades · 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.
  • seasonality · 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.
  • screener · 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
  • register_free_key · 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 star
  • confirm_registration · 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.
  • use_api_key · 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.
  • absorption_market · WHICH tickers are having their order flow ABSORBED right now - large flow moving price less than the continuous-tape Kyle-lambda model explains - for a date (default latest): one row per ticker with the absorption strength percentile, the s
  • absorption_ticker · One ticker's absorption events for a date (default latest) PLUS its trailing per-day direction history, so you can tell whether today is unusual for the name. Each event carries the absorption strength percentile, the side, the pre-event co

What "online" means: the server answered an MCP connection at the time of the check. It is not a guarantee of security, quality or continuous uptime. How we test: we open an MCP session and ask for the tool list, as an AI assistant would. We never run a tool and never send a key. Checked every few days. Method

Is this your server? Monitoring Pro: a check every 30 minutes and an email within the hour when it stops answering. Launch offer: $39.99 once, for life.

Facts & evidence

Each fact shows where it was seen and when.
FactValueEvidenceSourceLast confirmed
Hosted endpointhttps://api.optionwhales.io/mcp, https://api.optionwhales.io/mcp/connectDECLAREDSRC-001 Official MCP Registry1d ago
Version1.4.0DECLAREDSRC-001 Official MCP Registry1d ago
Local install (package)noDECLAREDSRC-001 Official MCP Registry1d ago
Remote access (hosted)yesDECLAREDSRC-001 Official MCP Registry1d ago
Websitehttps://optionwhales.io/for-ai-agentsDECLAREDSRC-001 Official MCP Registry1d ago
Registry statusactiveDECLAREDSRC-001 Official MCP Registry1d ago
MCP serveryesDECLAREDSRC-001 Official MCP Registry1d ago

Change history

  • VERSION03 Oct 2026
    1.2.0 → 1.4.0
  • NEW02 Oct 2026
    first seen in the index

Is this page accurate?

Flag it and our robot re-checks the official source. Reports never change a score.

Do you run OptionWhales? Know when it stops answering

For publishers · optional

Its hosted endpoint can be monitored. Monitoring Pro connects every 30 minutes like an AI assistant, emails you within the hour when it stops answering, keeps a 90-day availability history and adds your answer rate to your badge.

Monitor OptionWhalesLaunch offer $39.99 once, for life instead of $9.99/month · All plans

Monitoring never changes a score or a rank.

Are you the publisher of OptionWhales?

Free · show your listing

An independent listing builds trust with your buyers. Announce it, and add the badge to your website or README.

Announce it on LinkedIn
Listed on Electra IndexListed on Electra Index
<a href="https://electraindex.com/mcp/optionwhales?utm_source=badge&utm_medium=share&utm_campaign=listing"><img src="https://electraindex.com/api/badge/optionwhales/card" width="260" height="72" alt="Listed on Electra Index"></a>

Questions about OptionWhales

How do I connect OptionWhales?

Use the hosted endpoint https://api.optionwhales.io/mcp in your assistant's MCP settings. The exact settings are in "How to connect" above, as declared in the Official MCP Registry.

What tools does OptionWhales offer?

When Electra Index connected on 15 Nov 2026, it listed 37 tools: intent_flow_current, momentum_rankings, abnormal_trades_current, directional_current, market_tide, sector_tide, darkpool_ranking, darkpool_time_profile and more. The full list is in "Live check" above.

Is OptionWhales online?

Yes. Its hosted endpoint answered an MCP connection from Electra Index 2d ago.