Skip to content

OptionWhales

by optionwhales.io · remote · no sign-in to list tools · v1.4.0 · published by io.optionwhales

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

Final · 1Changes · 34
CompareRegistry entry

35 tools: 1 do something that can't be undone and 34 change things.

Scanned Oct 21, 2026

3 checks matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.

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

Findings

Matches of fixed checks, with the text they matched.

3 warn
  • Warnoi_timeseries

    The server marks "oi_timeseries" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The description's first verb is "open": a word for a change.

    What this check looks for
  • Warncontract_historic

    The server marks "contract_historic" read-only (readOnlyHint: true), and its own name, description or input give the class "irreversible".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The input addresses people (input.to): what it sends cannot be taken back.

    What this check looks for
  • Warnregister_free_key

    The server marks "register_free_key" as not read-only (readOnlyHint: false), and its words say it reads.

    Matched text

    annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The description's first verb is "get": a word for reading.

    What this check looks for

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

35 tools

Can't be undone 1Claude Code: ask
  • contract_historicDaily OHLC price bars for one option contract by OCC symbol (e.g.1 finding

    Why it is in this group

    • The input addresses people (input.to): what it sends cannot be taken back.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "contract_historic" read-only (readOnlyHint: true), and its own name, description or input give the class "irreversible".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The input addresses people (input.to): what it sends cannot be taken back.

      What this check looks for
    Description, as the server wrote it
    Daily OHLC price bars for one option contract by OCC symbol (e.g. SPY260130C00600000) between two dates, about a year of look-back. Pro.

    Annotations the server declares

    • title: Option contract price history
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
Changes things 34Claude Code: ask
  • abnormal_trades_currentUnusual options activity this session — large, sweep-like or volume-versus-open-interest outlier orders with ticker, direction, size and time.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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); free: the latest 5 with core fields; Pro: the full feed.

    Annotations the server declares

    • title: Unusual options activity
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • confirm_registrationConfirm a key from register_free_key using the code in the 'Confirm your OptionWhales API key' email, which makes the key permanent.No findings

    Why it is in this group

    • The input takes a statement or command to run (input.code), which can change anything it can reach.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Confirm a free API key
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • contract_atmNear-the-money option strikes grouped by expiry, within a band around spot (default plus or minus 5%).No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: At-the-money option strikes
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • 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).No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Option chain
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • 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).No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Dark pool ranking
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • 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 lar…No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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 priced away from it: >0.1% and 2 cents outside). cells_side gives each cell's [buy, sell, away] shares (buy = at the ask + 60% near it, sell = at the bid + 60% near it, away left out, rest neutral); totals add buy_volume, sell_volume, away_volume. Side is an NBBO-location proxy, not buy/sell; ~15 min delayed. Use for 'when did the dark pool trade NVDA around 180?'. Pro.

    Annotations the server declares

    • title: Dark pool time profile
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • directional_currentPer-ticker directional score for this session (-1 bearish to +1 bullish) combining net premium, order clustering and implied volatility.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Directional score by ticker
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • dividendsCash dividend history for a stock: amount, frequency, ex-dividend and pay dates.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Cash dividend history for a stock: amount, frequency, ex-dividend and pay dates. Pro.

    Annotations the server declares

    • title: Dividend history
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • earnings_calendarUpcoming earnings reports: date, before/after market, EPS and revenue estimates.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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 estimates; Pro: the full calendar plus the options-flow intent label.

    Annotations the server declares

    • title: Earnings calendar
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • earnings_currentOptions positioning around earnings for companies reporting this session: pre-earnings order flow, Greeks and intent signals.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Earnings options positioning
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • economic_calendarUpcoming US economic events (CPI, FOMC, jobs, GDP and more) with impact level and the ETFs that historically react.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Economic calendar
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • financialsCompany financial statements (income statement, balance sheet, cash flow) for trailing-twelve-month, quarterly or annual periods, latest first.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Company financial statements (income statement, balance sheet, cash flow) for trailing-twelve-month, quarterly or annual periods, latest first. Pro.

    Annotations the server declares

    • title: Company financials
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • gex_levelsDealer gamma-exposure key levels for a ticker: gamma flip, max pain, call wall, put wall and spot.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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) expiry it belongs to — max_pain_basis / wall_basis say which definition each field carries. Use when asked where price may pin, bounce, stall or accelerate, e.g. 'what are the gamma levels on SPY?'. session defaults to the latest trading day. Without an account and on free: SPY and QQQ; Pro: any ticker.

    Annotations the server declares

    • title: Gamma exposure (GEX) levels
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • greek_exposureDealer gamma, charm and vanna exposure for a ticker, by strike and by expiry (calls, puts, net).No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Dealer greek exposure
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • insider_tradesSEC Form 4 insider transactions for a stock, latest first: insider, transaction code, shares, price, value and the SEC filing link.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Insider trades
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • intent_flow_currentToday's options-flow intent rankings: which tickers show bullish vs bearish institutional positioning (accumulation, distribution, hedging), with direction bias and strength.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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 (ticker, intent, direction); free: top 3 with core fields; Pro: every tracked ticker with all fields.

    Annotations the server declares

    • title: Options flow intent rankings
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • 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.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Market options tide
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • momentum_rankingsTickers ranked by options-flow momentum (the fastest-changing positioning this session).No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Options flow momentum rankings
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • oi_moversTickers ranked by day-over-day change in total options open interest (top gainers, losers, most active).No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Open interest movers
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • oi_timeseriesOpen interest and volume across recent snapshots for one ticker (calls, puts, total).1 finding

    Why it is in this group

    • The description's first verb is "open": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "oi_timeseries" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The description's first verb is "open": a word for a change.

      What this check looks for
    Description, as the server wrote it
    Open interest and volume across recent snapshots for one ticker (calls, puts, total). Use to see whether options positioning is building or unwinding. Pro.

    Annotations the server declares

    • title: Open interest history
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • register_free_keyGet a FREE OptionWhales API key for the person you are helping.1 finding

    Why it is in this group

    • The description's first verb is "get": a word for reading.
    • The server marks it as not read-only (readOnlyHint: false).

    Findings

    • Warn

      The server marks "register_free_key" as not read-only (readOnlyHint: false), and its words say it reads.

      Matched text

      annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The description's first verb is "get": a word for reading.

      What this check looks for
    Description, as the server wrote it
    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. OptionWhales emails them 'Confirm your OptionWhales API key' with a confirmation code: if you can read their inbox, call confirm_registration with that code; otherwise ask them to click the link. Once confirmed the key is permanent (and Pro if their account is Pro).

    Annotations the server declares

    • title: Get a free API key
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
  • screenerScreen the market across options-flow net premium, open-interest change, FDA catalysts and congressional trading.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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 next 30 days'. Pro.

    Annotations the server declares

    • title: Multi-signal stock screener
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • 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.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Monthly seasonality
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • sector_tideOptions net premium aggregated by sector for a session.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Options net premium aggregated by sector for a session. Use for 'which sectors are seeing bullish options flow?'. Pro.

    Annotations the server declares

    • title: Sector options tide
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • short_interestFINRA short interest history (bi-weekly settlements) with days to cover for a stock.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    FINRA short interest history (bi-weekly settlements) with days to cover for a stock. Use for 'how heavily shorted is GME?'. Pro.

    Annotations the server declares

    • title: Short interest
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • short_volumeDaily FINRA short-sale volume and short-volume ratio for a stock, with per-venue split.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Daily FINRA short-sale volume and short-volume ratio for a stock, with per-venue split. Pro.

    Annotations the server declares

    • title: Daily short volume
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • stock_candlesIntraday OHLCV bars for a stock on a session (default today), 1 to 60 minute bars; returns the most recent `limit` bars.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Stock intraday candles
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • stock_newsRecent news for a ticker, each article with a pre-computed sentiment (positive, negative, neutral) and its reasoning.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Stock news with sentiment
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • stock_quoteLatest price for a stock or ETF.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Stock quote
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • stock_splitsStock split history for a ticker: execution date and split ratio.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Stock split history for a ticker: execution date and split ratio. Pro.

    Annotations the server declares

    • title: Stock split history
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • technical_indicatorTechnical indicator series for a stock: SMA, EMA, RSI or MACD on adjusted closes (daily by default), latest first.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Technical indicator
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • use_api_keyAttach an existing OptionWhales API key to this MCP session, for clients that cannot send an X-API-Key header.No findings

    Why it is in this group

    • The description's first verb is "attach": a word for a change.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Use an existing API key
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • volatility_moversTickers whose 30-day at-the-money implied volatility moved most versus the prior close (expansions and/or compressions).No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Implied volatility movers
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • volatility_term_structureAt-the-money implied volatility by expiration (the IV term structure), plus spot and the overall ATM IV for a ticker.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Implied volatility term structure
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.4.0. Values in angle brackets are yours to fill in.

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

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [],
    "ask": [
      "mcp__options-flow__intent_flow_current",
      "mcp__options-flow__momentum_rankings",
      "mcp__options-flow__abnormal_trades_current",
      "mcp__options-flow__directional_current",
      "mcp__options-flow__market_tide",
      "mcp__options-flow__sector_tide",
      "mcp__options-flow__darkpool_ranking",
      "mcp__options-flow__darkpool_time_profile",
      "mcp__options-flow__earnings_current",
      "mcp__options-flow__economic_calendar",
      "mcp__options-flow__earnings_calendar",
      "mcp__options-flow__gex_levels",
      "mcp__options-flow__greek_exposure",
      "mcp__options-flow__volatility_term_structure",
      "mcp__options-flow__volatility_movers",
      "mcp__options-flow__oi_movers",
      "mcp__options-flow__oi_timeseries",
      "mcp__options-flow__contract_chain",
      "mcp__options-flow__contract_atm",
      "mcp__options-flow__contract_historic",
      "mcp__options-flow__stock_quote",
      "mcp__options-flow__stock_candles",
      "mcp__options-flow__technical_indicator",
      "mcp__options-flow__financials",
      "mcp__options-flow__dividends",
      "mcp__options-flow__stock_splits",
      "mcp__options-flow__stock_news",
      "mcp__options-flow__short_interest",
      "mcp__options-flow__short_volume",
      "mcp__options-flow__insider_trades",
      "mcp__options-flow__seasonality",
      "mcp__options-flow__screener",
      "mcp__options-flow__register_free_key",
      "mcp__options-flow__confirm_registration",
      "mcp__options-flow__use_api_key"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as options-flow. Review it before you use it.