Index / MCP servers / OptionWhales

OptionWhales MCP server

OptionWhales is a remote MCP server that gives an AI agent 37 tools, among them abnormal_trades_current, absorption_market, absorption_ticker. It answers at https://api.optionwhales.io/mcp over streamable HTTP, and it listed its tools to an anonymous client, so no sign-in was needed for that. Our probes reached it 4 of 4 times since 3 October 2026; the last check, on 17 November 2026, succeeded.

Status
Answering
Tools
37
Official
yes, served from optionwhales.io
Reliability
4 of 4 checks
Response time
214 ms
Transport
streamable HTTP
Last checked
17 November 2026

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

Description as the publisher wrote it.

The 37 tools OptionWhales offers

ToolWhat it does
abnormal_trades_currentUnusual 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
Inputs: limit
absorption_marketWHICH 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
Inputs: date, limit, include_events, tradeable_only, min_pctile
absorption_tickerOne 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
Inputs: ticker, date, limit, days
confirm_registrationConfirm 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.
Inputs: code
contract_atmNear-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.
Inputs: ticker, date, width
contract_chainOption 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.
Inputs: ticker, date, expiry, type, min_oi, limit
contract_historicDaily OHLC price bars for one option contract by OCC symbol (e.g. SPY260130C00600000) between two dates, about a year of look-back. Pro.
Inputs: occ, from, to
darkpool_rankingOff-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.
Inputs: date
darkpool_time_profileWHEN 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
Inputs: ticker, date
directional_currentPer-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.
Inputs: max_display
dividendsCash dividend history for a stock: amount, frequency, ex-dividend and pay dates. Pro.
Inputs: ticker, limit
earnings_calendarUpcoming 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
Inputs: ticker, days, limit
earnings_currentOptions 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_calendarUpcoming 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
Inputs: impact
financialsCompany financial statements (income statement, balance sheet, cash flow) for trailing-twelve-month, quarterly or annual periods, latest first. Pro.
Inputs: ticker, timeframe, limit
gex_levelsModeled 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
Inputs: ticker, session, dte_filter
greek_exposureDealer 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.
Inputs: ticker, session, dte_filter
insider_tradesSEC 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.
Inputs: ticker, limit
intent_flow_currentToday'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
market_tideMarket-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.
Inputs: session, top_n
momentum_rankingsTickers 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.
Inputs: top
oi_moversTickers 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.
Inputs: dte, limit
oi_timeseriesOpen interest and volume across recent snapshots for one ticker (calls, puts, total). Use to see whether options positioning is building or unwinding. Pro.
Inputs: ticker, dte, slot
register_free_keyGet 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
Inputs: email, agent_name
screenerScreen 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
Inputs: session, direction, min_abs_premium, min_oi_change, fda_within_days, phase
seasonalityMonthly 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.
Inputs: ticker, years
sector_tideOptions net premium aggregated by sector for a session. Use for 'which sectors are seeing bullish options flow?'. Pro.
Inputs: session
short_interestFINRA short interest history (bi-weekly settlements) with days to cover for a stock. Use for 'how heavily shorted is GME?'. Pro.
Inputs: ticker, limit
short_volumeDaily FINRA short-sale volume and short-volume ratio for a stock, with per-venue split. Pro.
Inputs: ticker, limit
stock_candlesIntraday 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.
Inputs: ticker, session, timespan, limit
stock_newsRecent news for a ticker, each article with a pre-computed sentiment (positive, negative, neutral) and its reasoning. Use for 'why is TSLA moving?'. Pro.
Inputs: ticker, limit
stock_quoteLatest 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.
Inputs: ticker
stock_splitsStock split history for a ticker: execution date and split ratio. Pro.
Inputs: ticker, limit
technical_indicatorTechnical 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.
Inputs: ticker, indicator, timespan, window, limit, short_window
use_api_keyAttach 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.
Inputs: api_key
volatility_moversTickers 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.
Inputs: direction, limit
volatility_term_structureAt-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,
Inputs: ticker

Add OptionWhales to your AI client

Every block below points at https://api.optionwhales.io/mcp. Pick your client and copy.

Claude Code: one command in your terminal
claude mcp add --transport http optionwhales https://api.optionwhales.io/mcp
Claude Desktop: claude_desktop_config.json
{
  "mcpServers": {
    "optionwhales": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.optionwhales.io/mcp"]
    }
  }
}
Cursor: ~/.cursor/mcp.json, or .cursor/mcp.json in a project
{
  "mcpServers": {
    "optionwhales": {
      "url": "https://api.optionwhales.io/mcp"
    }
  }
}
VS Code and GitHub Copilot: .vscode/mcp.json
{
  "servers": {
    "optionwhales": {
      "type": "http",
      "url": "https://api.optionwhales.io/mcp"
    }
  }
}
Zed: Zed settings.json
{
  "context_servers": {
    "optionwhales": {
      "url": "https://api.optionwhales.io/mcp"
    }
  }
}
Windsurf: ~/.codeium/mcp_config.json
{
  "mcpServers": {
    "optionwhales": {
      "serverUrl": "https://api.optionwhales.io/mcp"
    }
  }
}
JetBrains AI Assistant: Settings, Tools, AI Assistant, MCP, New MCP Server, as JSON
{
  "mcpServers": {
    "optionwhales": {
      "url": "https://api.optionwhales.io/mcp"
    }
  }
}
Continue: .continue/mcpServers/neuronto.yaml
name: OptionWhales
version: 0.0.1
schema: v1
mcpServers:
  - name: OptionWhales
    type: streamable-http
    url: https://api.optionwhales.io/mcp
Gemini CLI: ~/.gemini/settings.json
{
  "mcpServers": {
    "optionwhales": {
      "httpUrl": "https://api.optionwhales.io/mcp"
    }
  }
}
Codex CLI: MCP server config
{
  "mcpServers": {
    "optionwhales": {
      "type": "http",
      "url": "https://api.optionwhales.io/mcp"
    }
  }
}
Warp: MCP servers, + Add, paste JSON
{
  "mcpServers": {
    "optionwhales": {
      "url": "https://api.optionwhales.io/mcp"
    }
  }
}
Goose: a one-click extension link
goose://extension?url=https%3A%2F%2Fapi.optionwhales.io%2Fmcp&type=streamable_http&id=optionwhales&name=OptionWhales

Is OptionWhales up right now?

It answered our last check on 17 November 2026 in 214 ms. Over 4 checks since 3 October 2026 it answered 4. Status here comes from Neuronto's own probes, not from the publisher.

MCP servers similar to OptionWhales

Questions about OptionWhales

Is there an official OptionWhales MCP server?

Yes. It is published by optionwhales.io and served from api.optionwhales.io, the vendor's own domain: https://api.optionwhales.io/mcp.

How many tools does OptionWhales have?

37, as returned by the server's own tools/list on 20 November 2026: abnormal_trades_current, absorption_market, absorption_ticker, confirm_registration, contract_atm, contract_chain, contract_historic, darkpool_ranking, and 29 more.

Is OptionWhales down?

It answered our last check on 17 November 2026 in 214 ms. Over 4 checks since 3 October 2026 it answered 4.

How do I add OptionWhales to Cursor?

Put the server under mcpServers in ~/.cursor/mcp.json with the URL https://api.optionwhales.io/mcp. The exact JSON is above, with the same setup for Claude Code, Claude Desktop, VS Code, Windsurf, Zed, Gemini CLI and the rest.

Does OptionWhales need an API key?

It listed its tools to an anonymous client, so reading the tool list needs no key. Individual tools can still ask for credentials in their own inputs.

Where this comes from

Publisher: io.optionwhales. Endpoint host: api.optionwhales.io. ARD identifier: urn:air:io.optionwhales:mcp:options-flow. First indexed 3 October 2026. The tools are exactly what the server returned; nothing on this page is inferred from its name. Ranking in Neuronto search is never for sale.

Is this your server? Get a message the day it stops answering or its tools change: monitoring, 14 days free. Or claim the domain to manage how it is listed.