Unusual Whales MCP
OfficialUnusual Whales MCP
Inspired by erikmaday/unusual-whales-mcp - the original community MCP server for Unusual Whales by Erik Maday.
The official Unusual Whales MCP server. Connect any MCP-compatible client to 200+ market data endpoints covering options flow, dark pool, congressional trading, Greek exposure, volatility, futures, and more.
Quick Start
1. Get an API Key
Get your key at unusualwhales.com/settings/api-dashboard.
2. Connect
Remote (recommended) — no install, connects to the hosted endpoint:
# Claude Code
claude mcp add --transport http unusualwhales \
https://api.unusualwhales.com/api/mcp \
--header "Authorization: Bearer YOUR_KEY"// Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS)
{
"mcpServers": {
"unusualwhales": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.unusualwhales.com/api/mcp",
"--header",
"Authorization: Bearer YOUR_KEY"
]
}
}
}Claude Desktop does not natively support remote MCP servers yet, so we use
mcp-remoteto bridge the connection. Requires Node.js 18+.
// Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"unusualwhales": {
"type": "url",
"url": "https://api.unusualwhales.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_KEY"
}
}
}
}// VS Code (.vscode/mcp.json) — uses "servers" instead of "mcpServers"
{
"servers": {
"unusualwhales": {
"type": "url",
"url": "https://api.unusualwhales.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_KEY"
}
}
}
}// Windsurf (~/.codeium/windsurf/mcp_config.json) — uses "serverUrl" instead of "url"
{
"mcpServers": {
"unusualwhales": {
"serverUrl": "https://api.unusualwhales.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_KEY"
}
}
}
}After adding the config, fully quit and reopen your AI assistant. Just saving the file is not enough — the MCP server connects at startup.
# Claude Code
claude mcp add unusualwhales -e UW_API_KEY=YOUR_KEY -- npx -y @unusualwhales/mcp// Claude Desktop, Cursor
{
"mcpServers": {
"unusualwhales": {
"command": "npx",
"args": ["-y", "@unusualwhales/mcp"],
"env": {
"UW_API_KEY": "YOUR_KEY"
}
}
}
}// VS Code (.vscode/mcp.json)
{
"servers": {
"unusualwhales": {
"command": "npx",
"args": ["-y", "@unusualwhales/mcp"],
"env": {
"UW_API_KEY": "YOUR_KEY"
}
}
}
}Config file locations:
Claude Desktop (macOS):
~/Library/Application Support/Claude/claude_desktop_config.jsonClaude Desktop (Windows):
%APPDATA%\Claude\claude_desktop_config.jsonCursor:
.cursor/mcp.jsonor~/.cursor/mcp.jsonVS Code:
.vscode/mcp.jsonWindsurf:
~/.codeium/windsurf/mcp_config.json
Troubleshooting
Problem | Fix |
Server not connecting | Make sure the URL is exactly |
Tools not appearing | Fully quit and reopen your client after adding the config. Verify your JSON has no trailing commas. |
401 Unauthorized | Check your API key is correct and active. Remote config needs |
npx not found (nvm users) | Claude Desktop doesn't inherit your shell PATH. Use the full path to npx in the |
3. Ask Questions
Once connected, just ask about the market in natural language:
What's the options flow for AAPL today?
Show me the latest congressional trades
What's the dark pool activity for TSLA?
Get the max pain for SPY options expiring this Friday
Deep dive on NVDA - options, dark pool, insider activityRelated MCP server: market-data-mcp
Tools
The server exposes tools across 16 data categories. Your MCP client will call them automatically based on your questions.
Category | Examples |
Stock | Options chains, Greeks, IV rank, OHLC candles, max pain, OI, volatility, quotes |
Options | Contract flow, historic prices, intraday data, volume profiles |
Flow | Options flow alerts, the full trades tape, multi-leg strategies, net flow by expiry, sector flow |
Dark Pool | Transactions with NBBO context, price level filtering, volume by price level |
Futures (Premium) | CME contracts, cross-contract flow, time & sales, OHLCV candles, session stats — requires the Advanced tier or |
Congress | Congressional trades, late filings, individual member activity |
Politicians (Premium) | Portfolios, recent trades, holdings by ticker — contact support to upgrade |
Insider | Insider transactions, sector flow, ticker flow |
Institutions | 13F filings, holdings, sector exposure, ownership changes |
Market | Market tide, sector tide, economic calendar, FDA calendar, correlations |
Earnings | Premarket and afterhours schedules, historical earnings |
ETF | Holdings, exposure, inflows/outflows, sector weights |
Shorts | Short interest, FTDs, short volume ratio, borrow rates |
Seasonality | Monthly performers, yearly patterns, historical seasonality |
Screener | Stock screener, options screener, unusual options activity, analyst ratings |
News | Market news headlines |
Public Stock Fundamentals and Technicals
The MCP now includes public-style stock tools that map directly to the stock fundamentals and technical indicator endpoints.
Tool | What it returns |
| Filing-based fundamentals, revenue segmentation, EPS, dividends, and balance-sheet trends |
| Combined financials payload with income statements, balance sheets, cash flows, and earnings |
| Income statement history with optional |
| Balance sheet history with optional |
| Cash flow history with optional |
| Historical reported/estimated EPS and earnings surprises with optional |
| Indicator series for |
The grouped local-package tools uw_fundamentals and uw_technicals remain available for clients that prefer the existing action-based interface.
Prompts
The server includes 30+ ready-to-use analysis prompts. Ask to use any prompt by name.
Prompt | What it does |
| Market overview with tide, sectors, flow, dark pool |
| Morning tide, earnings, and key activity |
| EOD top movers, sectors, and themes |
| Max pain, gamma, and OI for weekly expiry |
| Top tickers by net premium and options impact |
Prompt | What it does |
| Deep dive: options, dark pool, insiders, catalysts |
| IV rank, term structure, max pain analysis |
| Historical moves, IV, positioning before earnings |
| Gamma, delta, vanna exposure by strike |
| Short interest, FTDs, squeeze potential |
| Deep dive on a specific option contract |
| Cross-ticker correlation analysis |
Prompt | What it does |
| Scan for unusual options activity |
| Large dark pool prints and institutional activity |
| Options flow sentiment by sector group |
Prompt | What it does |
| Recent congressional trading with patterns |
| Portfolio holdings for a specific politician |
| Insider buying/selling patterns |
| 13F filings, holdings changes, sector rotation |
| Analyst ratings with options flow correlation |
Prompt | What it does |
| Earnings with IV and expected moves |
| FDA events with biotech options activity |
| FOMC, CPI, jobs data with positioning |
Prompt | What it does |
| High/low IV rank stocks for options strategies |
| Bullish flow + dark pool + insider buying |
| Bearish flow + distribution + insider selling |
| Headlines with related options flow |
| Historical seasonal patterns |
| ETF inflows/outflows and exposure |
Chain prompts for deeper analysis:
Use morning-briefing, then unusual-flow to dig into top movers
Use pre-earnings for NVDA, then greek-exposure to see dealer positioning
Use bullish-confluence to find candidates, then ticker-analysis on the top resultConfiguration
All optional. The defaults work for most users.
Variable | Default | Description |
| required | Your Unusual Whales API key |
|
| Max requests per minute |
|
| Retry attempts for failed requests |
|
| Failures before circuit opens |
|
| Ms before retrying after circuit opens |
|
| Logging verbosity ( |
| unset | Set to |
| unset | Comma-separated allowlist of premium tools/commands to expose, e.g. |
Endpoint Schema
Every endpoint the server exposes is published as machine-readable JSON, generated from the same catalog the server registers from:
File | Contents |
Full JSON Schema for every command's parameters, plus route and query-param renames | |
One row per endpoint — route, description, required/optional params. Use this to find an endpoint, then look it up in the full file |
Both are regenerated with npm run docs and verified in CI, so they cannot drift from the
server. To check the catalog against the live upstream API:
npm run fetch-spec # download the current OpenAPI spec
npm run check-api # report missing endpoints, unknown routes, and param driftWebSocket channels (/api/socket/*) are intentionally not exposed: MCP is request/response.
Use the REST endpoints directly for streaming.
Contributing
See CONTRIBUTING.md.
Acknowledgments
This project builds on the foundational work of Erik Maday, whose unusual-whales-mcp was the first community MCP server for Unusual Whales and demonstrated how to bring market data into the MCP ecosystem.
License
MIT - see LICENSE.
Originally inspired by the UW community MCP erikmaday/unusual-whales-mcp.
Available Tools
27 toolsget_balance_sheetsBRead-onlyIdempotent
Get balance sheet data for a ticker, including assets, liabilities, equity, debt structure, and shares outstanding.
Inputs: ticker (required), report_type.
get_cash_flowsBRead-onlyIdempotent
Get cash flow statement data for a ticker, including operating, investing, and financing cash flows, capex, dividends, and buybacks.
Inputs: ticker (required), report_type.
get_earnings_historyBRead-onlyIdempotent
Get earnings history for a ticker with reported EPS, estimated EPS, surprise amount, surprise percentage, report date, and report timing.
Inputs: ticker (required), report_type.
get_fundamental_breakdownARead-onlyIdempotent
Get filing-based fundamentals for a ticker, including earnings, revenue, cash flow, dividends, EPS, balance sheet trends, and revenue breakdowns by product or geography. Use this for company financial statement analysis and medium/long-term fundamental context.
Inputs: ticker (required).
get_income_statementsBRead-onlyIdempotent
Get income statement data for a ticker, including revenue, gross profit, operating income, EBITDA, and net income.
Inputs: ticker (required), report_type.
get_stock_financialsARead-onlyIdempotent
Get combined stock financials for a ticker, including income statements, balance sheets, cash flows, and earnings.
Inputs: ticker (required).
get_technical_indicatorBRead-onlyIdempotent
Get a technical indicator time series for a ticker. Supports: SMA, EMA, RSI, MACD, BBANDS, STOCH, ADX, ATR, OBV, VWAP, CCI, WILLR, AROON, MFI.
Inputs: ticker (required), function (required), month, interval, +2 more.
uw_alertsARead-onlyIdempotent
Access UnusualWhales user alerts and configurations.
Available commands:
alerts: Get triggered alerts for the user
configurations: Get alert configurations
filters: Get the filter fields and accepted values available per alert type, plus which types this account may create
query_grammar: Get the alert query language grammar — targets, syntax, fields, functions, operators, scopes and examples (target optional)
Call 'filters' and 'query_grammar' before constructing an alert configuration: they describe exactly which fields, values and expressions are valid.
Inputs: no named parameters.
uw_congressARead-onlyIdempotent
Access UnusualWhales congress trading data including trades by congress members.
Available commands:
recent_trades: Get recent trades by congress members
late_reports: Get recent late reports by congress members
congress_trader: Get trades by a specific congress member (name required)
politicians: List politicians with trade data (trade count, first/last trade date, party, chamber, gender). Optional last_traded_within_months filter.
Inputs: no named parameters.
uw_cryptoARead-onlyIdempotent
Access UnusualWhales crypto data including prices, OHLC candles, whale trades, and whale transactions across 3 blockchains.
Available commands:
state: Get current state for a crypto pair with 24h OHLCV data (pair required)
ohlc: Get OHLC candles for a crypto pair (pair, candle_size required; limit, date optional)
whales_recent: Get recent large crypto whale trades (limit optional)
whale_transactions: Get whale transactions across blockchains (limit, blockchain, token_symbol optional)
Supported candle sizes: 1m, 5m, 10m, 15m, 30m, 1h, 4h, 1d, 1w Supported blockchains: ethereum, bitcoin, solana, polygon, arbitrum, avalanche, binance_smart_chain, cardano, dogecoin, fantom, optimism, polkadot, ripple, tron
Inputs: no named parameters.
uw_darkpoolARead-onlyIdempotent
Access UnusualWhales darkpool trade data.
Available commands:
recent: Get recent darkpool trades across the market
ticker: Get darkpool trades for a specific ticker
price_levels: Get darkpool & lit volume concentration by price level for a ticker (ticker required; date optional)
Filtering options include premium range, size range, and volume range.
Inputs: no named parameters.
uw_earningsBRead-onlyIdempotent
Access UnusualWhales earnings data including premarket and afterhours earnings schedules.
Available commands:
premarket: Get premarket earnings for a date
afterhours: Get afterhours earnings for a date
ticker: Get historical earnings for a ticker (ticker required)
Inputs: no named parameters.
uw_etfARead-onlyIdempotent
Access UnusualWhales ETF data including holdings, exposure, inflows/outflows, and weights.
Available commands:
info: Get ETF information (ticker required)
holdings: Get ETF holdings (ticker required)
exposure: Get ETFs that hold a ticker (ticker required)
in_outflow: Get ETF inflow/outflow data (ticker required)
weights: Get sector and country weights (ticker required)
Inputs: no named parameters.
uw_flowARead-onlyIdempotent
Access UnusualWhales options flow data including flow alerts, full tape, net flow, group flow, and lit exchange flow.
Available commands:
flow_alerts: Get flow alerts with extensive filtering options
flow_alert: Get a single flow alert by ID with all constituent trades (id required; older_than optional). For multi-leg alerts returns all related legs; for RepeatedHits returns all transactions.
full_tape: Get full options tape for a date (date required)
net_flow_expiry: Get net flow by expiry date (date optional)
group_greek_flow: Get greek flow (delta & vega) for a flow group (flow_group required; date optional)
group_greek_flow_expiry: Get greek flow by expiry for a flow group (flow_group, expiry required; date optional)
lit_flow_recent: Get recent lit exchange trades across the market
lit_flow_ticker: Get lit exchange trades for a specific ticker (ticker required)
exchange_breakdown: Get exchange & trade-code breakdown for a date (date required; ticker, by_trade_code, min_premium, limit, page, order optional)
optionable_tickers: Get the list of optionable tickers (ticker optional)
option_trades: Filter the full option trades tape — same data and filters as the live options flow page (all params optional)
multi_leg_trades: Get detected multi-leg strategies (verticals, condors, butterflies, calendars, diagonals) with net price, premium and greeks (all params optional)
multi_leg_legs: Get the individual legs of one multi-leg strategy (id required)
Flow groups: airline, bank, basic materials, china, communication services, consumer cyclical, consumer defensive, crypto, cyber, energy, financial services, gas, gold, healthcare, industrials, mag7, oil, real estate, refiners, reit, semi, silver, technology, uranium, utilities
Flow alerts filtering options include: ticker, premium range, volume range, OI range, DTE range, and more. Lit flow filtering options include: premium range, size range, volume range, and timestamp filters.
Inputs: no named parameters.
uw_fundamentalsBRead-onlyIdempotent
Access fundamental financial data for stocks including financial statements, earnings, and revenue breakdowns.
Available commands:
fundamental_breakdown: Get fundamental breakdown with revenue segments, EPS, RSU data, and dividends for a ticker
financials: Get combined financial data (income statements, balance sheets, cash flows, and earnings) for a ticker
income_statements: Get income statement data (revenue, expenses, net income, EBITDA, etc.)
balance_sheets: Get balance sheet data (assets, liabilities, equity, debt, etc.)
cash_flows: Get cash flow data (operating, investing, financing cash flows, capex, dividends, etc.)
financial_earnings: Get reported and estimated EPS, earnings surprises
Inputs: no named parameters.
uw_insiderARead-onlyIdempotent
Access UnusualWhales insider trading data including transactions and flow.
Available commands:
transactions: Get insider transactions with filters. Use ticker_symbol for comma-separated tickers (e.g., AAPL,INTC)
sector_flow: Get aggregated insider flow for a sector (sector required)
ticker_flow: Get aggregated insider flow for a ticker (ticker required)
insiders: Get all insiders for a ticker (ticker required)
Inputs: no named parameters.
uw_institutionsARead-onlyIdempotent
Access UnusualWhales institutional holdings and ownership data.
Available commands:
list: List institutions with filters
holdings: Get holdings for an institution (name required)
activity: Get trading activity for an institution (name required)
activity_v2: Get trading activity v2 with enhanced data for an institution (name required; date, start_date, end_date optional)
sectors: Get sector exposure for an institution (name required)
ownership: Get institutional ownership of a ticker (ticker required)
latest_filings: Get latest institutional filings
Inputs: no named parameters.
uw_marketARead-onlyIdempotent
Access UnusualWhales market-wide data including market tide, sector ETFs, economic calendar, FDA calendar, and more.
Available commands:
market_tide: Get market tide data showing net premium flow (date optional; otm_only, interval_5m optional)
sector_tide: Get sector-specific tide (sector required; date optional)
etf_tide: Get ETF-based tide (ticker required; date optional)
sector_etfs: Get SPDR sector ETF statistics
economic_calendar: Get economic calendar events
fda_calendar: Get FDA calendar (announced_date_min/max, target_date_min/max, drug, ticker, limit optional)
correlations: Get correlations between tickers (tickers required; interval, start_date, end_date optional)
insider_buy_sells: Get total insider buy/sell statistics (limit optional)
oi_change: Get top OI changes (date, limit, order optional)
top_net_impact: Get top tickers by net premium (date, issue_types, limit optional)
total_options_volume: Get total market options volume (limit optional)
options_pulse_sectors: Get options pulse by sector/industry (date optional)
options_pulse_top: Options pulse scanner across the market (direction, date, ticker, min_score, max_score, min_txn, limit optional)
options_pulse_total: Get market-wide options pulse (date optional)
volatility_anomaly_top: Get top volatility anomalies (direction required; date, limit optional)
volatility_character_top: Get top volatility character (date, limit, sort, dir optional)
vix_term_structure: Get VIX term structure (history_days optional)
Inputs: no named parameters.
uw_newsARead-onlyIdempotent
Access UnusualWhales news headlines.
Available commands:
headlines: Get news headlines with optional filters (ticker, sources, search_term, major_only, page)
Inputs: no named parameters.
uw_optionsARead-onlyIdempotent
Access UnusualWhales option contract data including flow, historic prices, intraday data, and volume profiles.
Available commands:
flow: Get option contract flow (id required; side, min_premium, limit, date optional)
historic: Get historic option contract data (id required; limit optional)
intraday: Get intraday option contract data (id required; date optional)
volume_profile: Get volume profile for option contract (id required; date optional)
The 'id' parameter is the option contract symbol (e.g., AAPL240119C00150000).
Inputs: no named parameters.
uw_potusARead-onlyIdempotent
Access UnusualWhales data on the President of the United States, including social-media posts and the public schedule. Useful for tracking potentially market-moving statements and events.
Available commands:
posts: Get the President's recent posts (limit, page, search_term optional)
schedule: Get the President's public schedule (date, limit, page optional)
Inputs: no named parameters.
uw_predictionsARead-onlyIdempotent
Access UnusualWhales prediction market data including unusual activity, whale traders, smart money, insiders, market details, positions, liquidity, and user profiles.
Available commands:
unusual: Get prediction markets with unusual activity (categories, limit, offset optional)
whales: Get large prediction market traders
smart_money: Get profitable prediction market traders (categories, min_price, max_price optional)
insiders: Get potential insider activity on prediction markets
search_users: Search for prediction market users by query (q required)
market: Get prediction market details for a given asset (asset_id required)
positions: Get positions for a given prediction market asset (asset_id required)
liquidity: Get liquidity data for a given prediction market asset (asset_id required)
user: Get a prediction market user profile (user_id required)
Categories: Crypto, Culture, Finance, Politics, Science, Sports, Technology
Inputs: no named parameters.
uw_screenerARead-onlyIdempotent
Access UnusualWhales screeners for stocks, options, and analysts.
Available commands:
stocks: Screen stocks with various filters
option_contracts: Screen option contracts with filters
analysts: Screen analyst ratings
unusual_activity: Get option contracts flagged as unusual — the API equivalent of the live options flow "unusual" view (all params optional)
Inputs: no named parameters.
uw_seasonalityARead-onlyIdempotent
Access UnusualWhales seasonality data showing historical performance patterns.
Available commands:
market: Get market-wide seasonality data
performers: Get top/bottom performers for a month (month required, 1-12) Optional filters: min_years, ticker_for_sector, s_p_500_nasdaq_only, min_oi, limit, order, order_direction
monthly: Get monthly seasonality for a ticker (ticker required)
year_month: Get year-month breakdown for a ticker (ticker required)
Inputs: no named parameters.
uw_shortsARead-onlyIdempotent
Access UnusualWhales short selling data including short interest, FTDs, and volume.
Available commands:
data: Get short data for a ticker (ticker required)
ftds: Get failure to deliver data (ticker required)
interest_float: Get short interest as percent of float (ticker required)
volume_ratio: Get short volume and ratio (ticker required)
volumes_by_exchange: Get short volumes by exchange (ticker required)
interest_float_v2: Get short interest as percent of float v2 with enhanced data (ticker required)
short_screener: Screen for stocks by short interest metrics (all params optional)
Inputs: no named parameters.
uw_stockARead-onlyIdempotent
Access UnusualWhales stock data including options chains, greeks, IV, OHLC candles, open interest, and more.
Available commands:
info: Get stock information (ticker required)
ohlc: Get OHLC candles (ticker, candle_size required; date, timeframe, end_date, limit optional)
option_chains: Get option chains (ticker required; date, greeks optional)
option_contracts: Get option contracts (ticker required; expiry, option_type, min_dte, max_dte, filters, limit optional)
greeks: Get greeks data (ticker, expiry required; date optional)
greek_exposure: Get gamma/delta/vanna exposure (ticker required; date, timeframe optional)
greek_exposure_by_expiry: Get greek exposure by expiry (ticker required; date optional)
greek_exposure_by_strike: Get greek exposure by strike (ticker required; date optional)
greek_exposure_by_strike_expiry: Get greek exposure by strike and expiry (ticker, expiry required; date optional)
gex_levels: Get GEX (gamma exposure) levels (ticker required; date optional)
option_stance: Get option trade-stance ranking (ticker, stance required; limit, type, option_symbol, date optional)
options_pulse: Get options pulse for a ticker (ticker required; date optional)
greek_flow: Get greek flow (ticker required; date optional)
greek_flow_by_expiry: Get greek flow by expiry (ticker, expiry required; date optional)
iv_rank: Get IV rank (ticker required; date, timespan optional)
interpolated_iv: Get interpolated IV (ticker required; date optional)
max_pain: Get max pain (ticker required; date optional)
oi_change: Get OI change (ticker required; date, limit, page, order optional)
oi_per_expiry: Get OI per expiry (ticker required; date optional)
oi_per_strike: Get OI per strike (ticker required; date optional)
options_volume: Get options volume (ticker required; limit optional)
volume_oi_expiry: Get volume/OI by expiry (ticker required; date optional)
atm_chains: Get ATM chains for given expirations (ticker, expirations required)
expiry_breakdown: Get expiry breakdown (ticker required; date optional)
flow_per_expiry: Get flow per expiry (ticker required)
flow_per_strike: Get flow per strike (ticker required; date optional)
flow_per_strike_intraday: Get intraday flow per strike (ticker required; date, filter optional)
flow_recent: Get recent flow (ticker required; side, min_premium optional)
net_prem_ticks: Get net premium ticks (ticker required; date optional)
nope: Get NOPE data (ticker required; date optional)
stock_price_levels: Get stock price levels (ticker required; date optional)
stock_volume_price_levels: Get volume price levels (ticker required; date optional)
spot_exposures: Get spot exposures (ticker required; date optional)
spot_exposures_by_expiry_strike: Get spot exposures by expiry/strike (ticker, expirations required; date, filters optional)
spot_exposures_by_strike: Get spot exposures by strike (ticker required; date, filters optional)
spot_exposures_expiry_strike: Get spot exposures for specific expiry (ticker, expirations required; date, strike filters optional)
spot_exposures_by_expiry: DEPRECATED — Get spot GEX exposures by strike for a single expiry (ticker, expiry required; date, min_strike, max_strike optional)
historical_risk_reversal_skew: Get risk reversal skew (ticker, expiry, delta required; date, timeframe optional)
volatility_realized: Get realized volatility (ticker required; date, timeframe optional)
volatility_stats: Get volatility stats (ticker required; date optional)
volatility_term_structure: Get term structure (ticker required; date optional)
volatility_anomaly: Get volatility anomaly score (ticker required; date optional)
volatility_character: Get volatility character (ticker required; date optional)
volatility_variance_risk_premium: Get variance risk premium (ticker required; date optional)
stock_state: Get stock state (ticker required)
quote: Get the latest trade, NBBO and per-session quote change statistics (ticker required)
insider_buy_sells: Get insider buy/sells for stock (ticker required; limit optional)
ownership: PREMIUM — Get ownership data (ticker required; limit optional). Requires premium API plan, contact support@unusualwhales.com to upgrade
tickers_by_sector: Get tickers in sector (sector required)
ticker_exchanges: Get mapping of all tickers to their exchanges (no params required)
flow_alerts: Get flow alerts for a specific ticker (ticker required; limit, is_ask_side, is_bid_side optional)
fundamental_breakdown: Get fundamental financial data including EPS, revenue, dividends, share counts, and revenue breakdowns (ticker required)
Inputs: no named parameters.
uw_technicalsBRead-onlyIdempotent
Access technical indicator data for stocks.
Available commands:
technical_indicator: Get technical indicator time series data for a ticker
Supported indicators: SMA, EMA, RSI, MACD, BBANDS, STOCH, ADX, ATR, OBV, VWAP, CCI, WILLR, AROON, MFI
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 27 tools
The uw_* namespaces are mostly domain-distinct (crypto, congress, insider, etf, short, news), but several boundaries blur: uw_stock already exposes option chains, greeks, and per-strike flow that uw_options/uw_flow also cover, and within uw_stock the spot_exposures/greek_exposure variants are hard to tell apart. The seven flat get_* tools (get_income_statements, get_technical_indicator, get_earnings_history) directly duplicate uw_fundamentals/uw_technicals/uw_earnings commands, creating clear selection ambiguity.
Twenty tools use a consistent uw_<domain> prefix pattern with clear snake_case commands inside, which is highly predictable. The deviation is the seven standalone get_* tools (get_stock_financials, get_balance_sheets, etc.) mixed into the same set, which breaks the otherwise uniform convention.
27 tools sits at the heavy end, but most are namespaces bundling hundreds of commands, which is a sensible way to expose a very large API. The count feels slightly inflated by the redundant flat get_* tools that could have been folded into their uw_* namespaces.
Coverage spans options flow, equities, darkpool, congress, insider, institutions, ETFs, shorts, seasonality, crypto, predictions, fundamentals, technicals, news, and alerts — an exceptionally broad and deep surface. No obvious core lifecycle gap for the financial-data domain.
Maintenance
Related MCP Connectors
Official Intrinio MCP server. US stock prices, options and fundamentals for AI agents.
Read-only MCP server for live Polymarket, Kalshi, Limitless odds; Manifold sentiment.
Options flow, unusual activity, dark pool, insider and politician trades for US stocks. Read-only.
Production MCP server for US equity and options intelligence: real-time IV radar, Monte Carlo simulation, options pressure, strategy backtesting, AI prediction, pre-trade risk analysis, and automated stock research reports.
Related MCP Servers
- AlicenseBqualityDmaintenanceAn MCP server that provides comprehensive financial insights and analysis by leveraging real-time market data, news, and advanced analytics for stocks, options, financial statements, and economic indicators.1751PythonMIT
- -licenseNot gradedqualityNot gradedmaintenanceReal-time financial market data MCP server. Stocks, crypto, technicals, sentiment, FDA calendar. No API keys required.-
- AlicenseAqualityCmaintenanceComprehensive MCP server for real-time stock, cryptocurrency, options, and fundamental analysis, including SEC filings and insider trading data.269 npmMIT
- AlicenseNot gradedqualityCmaintenanceOptions analytics MCP server providing 40+ tools for options chain data, position valuation, Greeks, charts, and volatility analysis.MIT