OptionWhales

Name: OptionWhales
Author: io.optionwhales

MCP serverMCP

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

by io.optionwhaleshomepage ↗v1.4.0

Is this yours?

This record is unclaimed

Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.

Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"optionwhales","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.

Claim this record

Observed by Wellknown

Evidence

Everything here was measured by our prober or read from a registry. Nothing is self-reported.

30-day availability33/33 checks ok

30 days ago

Endpoints

https://api.optionwhales.io/mcpmcp streamable http · checked on a schedule
https://api.optionwhales.io/mcp/connectmcp streamable http · checked on a schedule

Registry facts

Not distributed through a package registry we index.

when	check	result	http	latency	detail
3 h ago	mcp initialize	ok	200	13 ms	server optionwhales-pro-api 1.4.0 · protocol 2025-06-18 · 34 tools
5 h ago	mcp initialize	ok	200	17 ms	server optionwhales-pro-api 1.4.0 · protocol 2025-06-18 · 31 tools
9 h ago	mcp initialize	ok	200	12 ms	server optionwhales-pro-api 1.4.0 · protocol 2025-06-18 · 34 tools
12 h ago	mcp initialize	ok	200	13 ms	server optionwhales-pro-api 1.4.0 · protocol 2025-06-18 · 31 tools
15 h ago	mcp initialize	ok	200	15 ms	server optionwhales-pro-api 1.4.0 · protocol 2025-06-18 · 34 tools
19 h ago	mcp initialize	ok	200	17 ms	server optionwhales-pro-api 1.4.0 · protocol 2025-06-18 · 31 tools
21 h ago	mcp initialize	ok	200	11 ms	server optionwhales-pro-api 1.4.0 · protocol 2025-06-18 · 34 tools
26 h ago	mcp initialize	ok	200	24 ms	server optionwhales-pro-api 1.4.0 · protocol 2025-06-18 · 31 tools
28 h ago	mcp initialize	ok	200	50 ms	server optionwhales-pro-api 1.4.0 · protocol 2025-06-18 · 34 tools
32 h ago	mcp initialize	ok	200	13 ms	server optionwhales-pro-api 1.4.0 · protocol 2025-06-18 · 31 tools

Tools observed via MCP handshake

intent_flow_current — Today's options-flow intent rankings: which tickers show bullish vs bearish institutional positioning (accumulation, distribution, hedging), with direction bias
momentum_rankings — Tickers ranked by options-flow momentum (the fastest-changing positioning this session). Use for 'which stocks have the strongest options momentum right now?'.
abnormal_trades_current — Unusual options activity this session — large, sweep-like or volume-versus-open-interest outlier orders with ticker, direction, size and time. Use for 'any unus
directional_current — Per-ticker directional score for this session (-1 bearish to +1 bullish) combining net premium, order clustering and implied volatility. Use to rank names by bu
market_tide — Market-wide options net-premium 'tide': signed large-order premium into calls versus puts, its intraday cumulative curve, and the top net-premium tickers for a
sector_tide — Options net premium aggregated by sector for a session. Use for 'which sectors are seeing bullish options flow?'. Pro.
darkpool_ranking — Off-exchange (dark pool) activity: the market-wide off-exchange share and a per-ticker ranking by off-exchange notional for a date (default latest). Use for 'wh
earnings_current — Options positioning around earnings for companies reporting this session: pre-earnings order flow, Greeks and intent signals. Use for 'how are traders positione
economic_calendar — Upcoming US economic events (CPI, FOMC, jobs, GDP and more) with impact level and the ETFs that historically react. Use for 'what macro events are coming up?'.
earnings_calendar — Upcoming earnings reports: date, before/after market, EPS and revenue estimates. Pass a ticker for 'when does NVDA report?', or omit it for 'who reports this we
gex_levels — Dealer gamma-exposure key levels for a ticker: gamma flip, max pain, call wall, put wall and spot. Use when asked where price may pin, bounce, stall or accelera
greek_exposure — Dealer gamma, charm and vanna exposure for a ticker, by strike and by expiry (calls, puts, net). Use for detailed hedging-flow analysis beyond the key GEX level
volatility_term_structure — At-the-money implied volatility by expiration (the IV term structure), plus spot and the overall ATM IV for a ticker. Use for 'is NVDA implied volatility elevat
volatility_movers — Tickers whose 30-day at-the-money implied volatility moved most versus the prior close (expansions and/or compressions). Use for 'which stocks saw the biggest I
oi_movers — Tickers ranked by day-over-day change in total options open interest (top gainers, losers, most active). Use for 'where is new options positioning building?'. P
oi_timeseries — Open interest and volume across recent snapshots for one ticker (calls, puts, total). Use to see whether options positioning is building or unwinding. Pro.
contract_chain — Option chain for a ticker from the latest open-interest snapshot: each contract's OCC symbol, strike, expiry, type and open interest (OI > 0). Filter by expiry,
contract_atm — Near-the-money option strikes grouped by expiry, within a band around spot (default plus or minus 5%). Use to find the liquid at-the-money contracts for a ticke
contract_historic — Daily OHLC price bars for one option contract by OCC symbol (e.g. SPY260130C00600000) between two dates, about a year of look-back. Pro.
stock_quote — Latest price for a stock or ETF. Real-time for symbols on your key's real-time watchlist; otherwise the most recent price at least 15 minutes old. Use for 'what
stock_candles — Intraday OHLCV bars for a stock on a session (default today), 1 to 60 minute bars; returns the most recent `limit` bars. Live bars are real-time for watchlisted
technical_indicator — Technical indicator series for a stock: SMA, EMA, RSI or MACD on adjusted closes (daily by default), latest first. Use for 'is AAPL overbought?' (RSI) or trend
financials — Company financial statements (income statement, balance sheet, cash flow) for trailing-twelve-month, quarterly or annual periods, latest first. Pro.
dividends — Cash dividend history for a stock: amount, frequency, ex-dividend and pay dates. Pro.
stock_splits — Stock split history for a ticker: execution date and split ratio. Pro.
stock_news — Recent news for a ticker, each article with a pre-computed sentiment (positive, negative, neutral) and its reasoning. Use for 'why is TSLA moving?'. Pro.
short_interest — FINRA short interest history (bi-weekly settlements) with days to cover for a stock. Use for 'how heavily shorted is GME?'. Pro.
short_volume — Daily FINRA short-sale volume and short-volume ratio for a stock, with per-venue split. Pro.
insider_trades — SEC Form 4 insider transactions for a stock, latest first: insider, transaction code, shares, price, value and the SEC filing link. Use for 'are insiders buying
seasonality — Monthly seasonality for a stock: average and median return by calendar month, hit rate, best and worst years over a 1 to 25 year look-back. Pro.
screener — Screen the market across options-flow net premium, open-interest change, FDA catalysts and congressional trading. Filter by direction, minimum premium or OI cha
register_free_key — Get a FREE OptionWhales API key for the person you are helping. Only use this if they do not already have a key. Pass their own email address (ask if unsure). T
confirm_registration — Confirm a key from register_free_key using the code in the 'Confirm your OptionWhales API key' email, which makes the key permanent. Safe to call again.
use_api_key — Attach an existing OptionWhales API key to this MCP session, for clients that cannot send an X-API-Key header. Use when the person gives you their key.

Declared by sources

What the publisher says

Attributed to the source that supplied each field. Treated as claims, not facts.

No long description beyond the summary.

kind Official MCP Registry

name Official MCP Registry

summary Official MCP Registry

version Official MCP Registry

description Official MCP Registry

homepageUrl Official MCP Registry

publisherName Official MCP Registry

Derived by Wellknown

Capabilities

Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.

commerce.pricingPricing & Quotes100%finance.marketsMarkets & Trading100%finance.bankingBanking58%knowledge.reasoningReasoning & Planning54%documents.contractsContracts & Legal53%productivity.calendarCalendar & Scheduling53%

Provenance

Where this record came from

Every source is kept verbatim. Field changes are logged as events.

Official MCP Registryio.optionwhales/options-flow

first seen 4 d ago · fetched 31 h agoopen ↗

Field history (6 recent events)

4 d ago · declared · summary → "US options flow & stock data: unusual activity, gamma levels, IV, earnings. OAuth sign-in or keys."
4 d ago · declared · description → "US options flow & stock data: unusual activity, gamma levels, IV, earnings. OAuth sign-in or keys."
4 d ago · declared · publisherName → "io.optionwhales"
4 d ago · declared · homepageUrl → "https://optionwhales.io/for-ai-agents"
4 d ago · declared · version → "1.4.0"
4 d ago · declared · protocols → ["mcp"]