OptionWhales MCP server
io.optionwhales/options-flowoptionwhales.iostreamable-httpv1.4.0Scanned
US options flow & stock data: unusual activity, gamma levels, IV, earnings. OAuth sign-in or keys.
37 tools: 1 do something that can't be undone and 36 change things.
- Reads private data · 0
- Reads text others write · 35
- Can send data out · 1
- 3 findings
Tools listed without sign-in. Remote posture
With Anlyon
1 tool here does something that can't be undone. Govern it.
- Anlyon lists the tools and adopts none.
- Each tool you adopt gets approvals and receipts.
- Your agent never holds the key.
A tool your agent calls directly is not routed through Anlyon and is not governed by it. Anlyon Radar only lists and labels, and these labels are the same either way.
What the OptionWhales MCP server can do
The OptionWhales MCP server is published by optionwhales.io, a domain the MCP Registry verified. It has 37 tools. It can do things that cannot be undone, such as sending, paying or publishing (contract_historic) and create or change data (36 tools: intent_flow_current, momentum_rankings, abnormal_trades_current, directional_current and 32 more), but cannot delete data. None of its tools only reads.
35 tools bring in text other people can write (intent_flow_current, momentum_rankings, abnormal_trades_current and 32 more); 1 tool can send data out of your system (contract_historic).
The fixed checks matched 3 findings (annotation-conflict). Each one comes with the text it matched.
Its remote endpoint lists its tools without sign-in, and its tools changed 2 times since Anlyon Radar first saw them.
Last scanned Nov 18, 2026, version 1.4.0.
Tools
Grouped by what each tool does, most consequential first. Open one for its reasons and full description; descriptions are the publisher's own words.
37 tools
Can't be undone 1Claude Code: ask
contract_historicDaily OHLC price bars for one option contract by OCC symbol (e.g.Reads text others writeCan send data out1 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
- outboundThe input takes a destination (input.to): what the tool writes goes there.
Findings
- Warn
The server marks "contract_historic" read-only (readOnlyHint: true), and its own name, description or input give the class "irreversible".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The input addresses people (input.to): what it sends cannot be taken back.
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 36Claude 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.Reads text others writeNo 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
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 'latest unusual options trades today'. Returned records from the bounded feed are ordered newest first. 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
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 r…Reads text others writeNo 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it 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 side, the pre-event context and whether it is tradeable (DROP context + Q3/Q4), plus whole-market breadth. row_semantics says whether each row is the day's PEAK event (settled session) or the LATEST one (live). This is an EVENT FEED, not a validated signal: the regime gate is long-only (SPY 63-day return > 0) and fails in bear tapes, auction windows are excluded as mechanical artifacts, and provisional=true means the event was detected live without calibration. Check coverage.completeness before concluding the tape is quiet - a degraded feed looks identical to a calm one. Use for 'who is absorbing selling today?'. Pro.
Annotations the server declares
- title: Absorption cross-section
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
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.Reads text others writeNo 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it 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 context quartile and provisional=true when it was detected live without calibration. Forward returns in the history are RAW LONG P&L and are deliberately NOT signed by the absorption side, so a negative number on a sell-absorption day is not a losing signal. Use for 'is NVDA being absorbed, and is that unusual?'. Pro.
Annotations the server declares
- title: Absorption for one ticker
- 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%).Reads text others writeNo 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
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).Reads text others writeNo 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
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).Reads text others writeNo 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
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…Reads text others writeNo 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
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.Reads text others writeNo 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
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.Reads text others writeNo 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
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.Reads text others writeNo 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
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.Reads text others writeNo 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
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.Reads text others writeNo 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
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.Reads text others writeNo 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
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_levelsModeled dealer gamma-exposure key levels for a ticker: gamma flip, max pain, call wall, put wall and spot.Reads text others writeNo 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it 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 spot_resolved_at. Compare each level numerically with the returned spot: do not assume the put wall is below it or the call wall above it. Explain differing timestamps or freshness limitations before treating snapshot levels as current intraday support or resistance. 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).Reads text others writeNo 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
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.Reads text others writeNo 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
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 large-order positioning signals (accumulation, distribution, hedging), with direction bias and strength.Reads text others writeNo 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it 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?'. 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.Reads text others writeNo 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
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).Reads text others writeNo 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
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).Reads text others writeNo 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
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).Reads text others write1 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Findings
- Warn
The server marks "oi_timeseries" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The description's first verb is "open": a word for a change.
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.Reads text others write1 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).
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Findings
- Warn
The server marks "register_free_key" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The description's first verb is "get": a word for reading.
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.Reads text others writeNo 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
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.Reads text others writeNo 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
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.Reads text others writeNo 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
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.Reads text others writeNo 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
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.Reads text others writeNo 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
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.Reads text others writeNo 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
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.Reads text others writeNo 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
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.Reads text others writeNo 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
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.Reads text others writeNo 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
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.Reads text others writeNo 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
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).Reads text others writeNo 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
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.Reads text others writeNo 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.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
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.
Exfil surface
Which tools read private data, which read text someone else can write, and which can send data out. One of each is a path a prompt injection can use.
No private-data, untrusted-input, outbound path in this server alone: no tool is tagged private-data.
- Reads private data0
- Reads files, mail, messages, databases, secrets, calendars or repositories.
- Reads text others write35
- Brings in text someone else can write: web pages, inbound email, messages, issues and comments.
- Can send data out1
- Can carry data to people or systems: it sends, posts or publishes, or takes a recipient, channel or URL.
Other servers in the same agent add their own tools to these paths. Audit your whole setup to see them together.
Remote posture
What anyone on the internet sees at the remote endpoint: an anonymous initialize and tools/list, and the public OAuth metadata.
Looked at Nov 20, 2026, 19:14 UTC, unchanged since Oct 29, 2026. No credentials were sent and no tool was called. What is looked at.
- Reachable
- yes
- HTTP status of an anonymous initialize
- 200
- tools/list served without credentials
- yes
- Tools that change things, listed without credentials
- 37
- Protocol version
- 2025-06-18
- WWW-Authenticate on 401
- not observed
- resource_metadata in WWW-Authenticate
- not observed
- RFC 9728 protected resource metadata
- https://api.optionwhales.io/.well-known/oauth-protected-resource/mcp
- Authorization servers
- https://www.optionwhales.io
- Legacy HTTP+SSE transport
- no
- Dynamic client registration
- yes
- Client ID metadata documents
- yes
- HighThe whole server
The endpoint served tools/list without credentials, and the list has 37 tools that change things (1 irreversible, 36 write). Whether a call also works without credentials was not tested: tools are never called.
What this check looks forMatched text
https://api.optionwhales.io/mcp: tools/list returned 37 tools to an anonymous client, including contract_historic (irreversible), intent_flow_current (write), momentum_rankings (write), abnormal_trades_current (write), directional_current (write) and 32 more
Posture changes
- Oct 29, 2026
- Tools that change things, listed without credentials: 35 to 37
Findings
Matches of fixed checks, with the text they matched.
- Warnoi_timeseries
The server marks "oi_timeseries" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The description's first verb is "open": a word for a change.
The server marks "contract_historic" read-only (readOnlyHint: true), and its own name, description or input give the class "irreversible".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true}; The input addresses people (input.to): what it sends cannot be taken back.
The server marks "register_free_key" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}; The description's first verb is "get": a word for reading.
History
Changes to its tool definitions and to its remote endpoint, newest first.
Tools3 changed.~3 changedView diff
- Changed:abnormal_trades_currentChanges thingsdescription
- Changed:gex_levelsChanges thingsdescription
- Changed:intent_flow_currentChanges thingsdescription
Tools2 added.+2 addedView diff
- Added:absorption_marketChanges things
- Added:absorption_tickerChanges things
PostureRemote posture changed. Tools that change things, listed without credentials: 35 -> 37.View diff
- Tools that change things, listed without credentials: 35 to 37
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/mcpclaude mcp add --transport http options-flow https://api.optionwhales.io/mcpRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change or a way out, deny the deletes. Paste into .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",
"mcp__options-flow__absorption_market",
"mcp__options-flow__absorption_ticker"
],
"deny": []
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. A read that can send data out (it takes a URL, say) asks first too. It assumes the server is installed as options-flow. Review it before you use it.
Capability tags behind 35 rules
- mcp__options-flow__intent_flow_current untrusted-input
- mcp__options-flow__momentum_rankings untrusted-input
- mcp__options-flow__abnormal_trades_current untrusted-input
- mcp__options-flow__directional_current untrusted-input
- mcp__options-flow__market_tide untrusted-input
- mcp__options-flow__sector_tide untrusted-input
- mcp__options-flow__darkpool_ranking untrusted-input
- mcp__options-flow__darkpool_time_profile untrusted-input
- mcp__options-flow__earnings_current untrusted-input
- mcp__options-flow__economic_calendar untrusted-input
- mcp__options-flow__earnings_calendar untrusted-input
- mcp__options-flow__gex_levels untrusted-input
- mcp__options-flow__greek_exposure untrusted-input
- mcp__options-flow__volatility_term_structure untrusted-input
- mcp__options-flow__volatility_movers untrusted-input
- mcp__options-flow__oi_movers untrusted-input
- mcp__options-flow__oi_timeseries untrusted-input
- mcp__options-flow__contract_chain untrusted-input
- mcp__options-flow__contract_atm untrusted-input
- mcp__options-flow__contract_historic untrusted-input, outbound
- mcp__options-flow__stock_quote untrusted-input
- mcp__options-flow__stock_candles untrusted-input
- mcp__options-flow__technical_indicator untrusted-input
- mcp__options-flow__financials untrusted-input
- mcp__options-flow__dividends untrusted-input
- mcp__options-flow__stock_splits untrusted-input
- mcp__options-flow__stock_news untrusted-input
- mcp__options-flow__short_interest untrusted-input
- mcp__options-flow__short_volume untrusted-input
- mcp__options-flow__insider_trades untrusted-input
- mcp__options-flow__seasonality untrusted-input
- mcp__options-flow__screener untrusted-input
- mcp__options-flow__register_free_key untrusted-input
- mcp__options-flow__absorption_market untrusted-input
- mcp__options-flow__absorption_ticker untrusted-input
Pin
Keep the decision: fail CI when the tools change, follow every change, or show a badge.
Pin in CI
Fail a build when the tools you reviewed are not the tools the server serves today.
curl -s "https://radar.anlyon.com/api/v1/servers/io.optionwhales/options-flow/verify?hash=fd543655f197aaec5a2e0a4d607b8b63072b44a6ae29bc2d0dad64f46d9ab1c6" | jq -e '.changed == false'Pinned hash fd543655f197, from Nov 18, 2026, 13:18 UTC.
Watch
Get told when its tools change: a new tool, a new description, a new class.
https://radar.anlyon.com/servers/io.optionwhales/options-flow/changes.xmlAn Atom feed. Works in any feed reader or Slack's RSS app.
Badge
[](https://radar.anlyon.com/servers/io.optionwhales/options-flow)Source: MCP Registry. Synced Oct 21, 2026, 18:52 UTC.
OptionWhales MCP server: questions and answers
Answered from the scan above, not from the publisher's description.
Is the OptionWhales MCP server safe?
- No scan can promise that. What its definitions show: 37 tools, 37 of which can change, send or delete something, and 3 findings from fixed checks. Allow the reads, ask before each change, and deny the deletes; the permissions block on this page does that.
Can the OptionWhales MCP server delete data?
- No tool is classed as destructive: going by their definitions, none of them deletes, cancels or revokes anything.
Can the OptionWhales MCP server do things that cannot be undone?
- Yes. 1 tool can send, pay, publish or merge: contract_historic.
What tools does the OptionWhales MCP server have?
- 37 tools: 1 irreversible, 36 write. contract_historic, intent_flow_current, momentum_rankings, abnormal_trades_current, directional_current, market_tide, sector_tide, darkpool_ranking and 29 more.
Does the OptionWhales MCP server need sign-in or OAuth?
- Its remote endpoint listed its tools to an anonymous client, without sign-in.
Does the OptionWhales MCP server send data to outside services?
- 1 tool can carry data out (it sends, posts or publishes, or takes a recipient, channel or URL): contract_historic.
Has the OptionWhales MCP server changed its tools?
- Yes, 2 times since Anlyon Radar started tracking it, most recently on Nov 18, 2026. Every change is on this page and in its Atom feed.