Unusual Whales MCP
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LOG_LEVEL | No | Logging verbosity (debug, info, warn, error) | info |
| UW_API_KEY | Yes | Your Unusual Whales API key | |
| UW_MAX_RETRIES | No | Retry attempts for failed requests | 3 |
| UW_PREMIUM_TOOLS | No | Comma-separated allowlist of premium tools/commands to expose, e.g. uw_futures,uw_flow.full_tape | |
| UW_ENABLE_PREMIUM_TOOLS | No | Set to 1/true to expose every premium tool and command | |
| UW_RATE_LIMIT_PER_MINUTE | No | Max requests per minute | 120 |
| UW_CIRCUIT_BREAKER_THRESHOLD | No | Failures before circuit opens | 5 |
| UW_CIRCUIT_BREAKER_RESET_TIMEOUT | No | Ms before retrying after circuit opens | 30000 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| uw_stockA | Access UnusualWhales stock data including options chains, greeks, IV, OHLC candles, open interest, and more. Available commands:
|
| uw_optionsA | Access UnusualWhales option contract data including flow, historic prices, intraday data, and volume profiles. Available commands:
The 'id' parameter is the option contract symbol (e.g., AAPL240119C00150000). |
| uw_flowA | Access UnusualWhales options flow data including flow alerts, full tape, net flow, group flow, and lit exchange flow. Available commands:
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. |
| uw_marketA | Access UnusualWhales market-wide data including market tide, sector ETFs, economic calendar, FDA calendar, and more. Available commands:
|
| uw_darkpoolA | Access UnusualWhales darkpool trade data. Available commands:
Filtering options include premium range, size range, and volume range. |
| uw_congressA | Access UnusualWhales congress trading data including trades by congress members. Available commands:
|
| uw_insiderA | Access UnusualWhales insider trading data including transactions and flow. Available commands:
|
| uw_institutionsA | Access UnusualWhales institutional holdings and ownership data. Available commands:
|
| uw_earningsB | Access UnusualWhales earnings data including premarket and afterhours earnings schedules. Available commands:
|
| uw_etfA | Access UnusualWhales ETF data including holdings, exposure, inflows/outflows, and weights. Available commands:
|
| uw_screenerA | Access UnusualWhales screeners for stocks, options, and analysts. Available commands:
|
| uw_shortsA | Access UnusualWhales short selling data including short interest, FTDs, and volume. Available commands:
|
| uw_seasonalityA | Access UnusualWhales seasonality data showing historical performance patterns. Available commands:
|
| uw_newsA | Access UnusualWhales news headlines. Available commands:
|
| uw_alertsA | Access UnusualWhales user alerts and configurations. Available commands:
Call 'filters' and 'query_grammar' before constructing an alert configuration: they describe exactly which fields, values and expressions are valid. |
| uw_cryptoA | Access UnusualWhales crypto data including prices, OHLC candles, whale trades, and whale transactions across 3 blockchains. Available commands:
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 |
| uw_fundamentalsB | Access fundamental financial data for stocks including financial statements, earnings, and revenue breakdowns. Available commands:
|
| uw_technicalsB | Access technical indicator data for stocks. Available commands:
Supported indicators: SMA, EMA, RSI, MACD, BBANDS, STOCH, ADX, ATR, OBV, VWAP, CCI, WILLR, AROON, MFI |
| uw_predictionsA | Access UnusualWhales prediction market data including unusual activity, whale traders, smart money, insiders, market details, positions, liquidity, and user profiles. Available commands:
Categories: Crypto, Culture, Finance, Politics, Science, Sports, Technology |
| uw_potusA | 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:
|
| get_fundamental_breakdownA | 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. |
| get_stock_financialsA | Get combined stock financials for a ticker, including income statements, balance sheets, cash flows, and earnings. |
| get_income_statementsB | Get income statement data for a ticker, including revenue, gross profit, operating income, EBITDA, and net income. |
| get_balance_sheetsB | Get balance sheet data for a ticker, including assets, liabilities, equity, debt structure, and shares outstanding. |
| get_cash_flowsB | Get cash flow statement data for a ticker, including operating, investing, and financing cash flows, capex, dividends, and buybacks. |
| get_earnings_historyB | Get earnings history for a ticker with reported EPS, estimated EPS, surprise amount, surprise percentage, report date, and report timing. |
| get_technical_indicatorB | Get a technical indicator time series for a ticker. Supports: SMA, EMA, RSI, MACD, BBANDS, STOCH, ADX, ATR, OBV, VWAP, CCI, WILLR, AROON, MFI. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| daily-summary | Generate a comprehensive daily market summary with unusual activity |
| ticker-analysis | Comprehensive analysis of a single ticker with stock info, options, dark pool, and insider activity |
| congress-tracker | Track recent congressional trading activity and identify notable patterns |
| morning-briefing | Morning market briefing with tide, sectors, dark pool, and earnings on deck |
| options-setup | Analyze options pricing, IV rank, and volatility structure for a ticker |
| pre-earnings | Pre-earnings analysis with historical moves, IV, and positioning |
| unusual-flow | Scan for unusual options activity with large premium and volume |
| dark-pool-scanner | Scan for significant dark pool activity across the market |
| insider-scanner | Scan for notable insider buying and selling activity |
| institutional-activity | Analyze recent institutional filings, holdings changes, and sector exposure |
| sector-flow | Compare options flow sentiment across sectors or a specific sector group |
| greek-exposure | Analyze gamma, delta, and vanna exposure for a ticker |
| iv-screener | Screen for stocks with high or low IV rank for options strategies |
| earnings-calendar | Earnings calendar with IV levels and options positioning |
| fda-calendar | FDA calendar with PDUFA dates and biotech options activity |
| short-interest | Analyze short interest, FTDs, and squeeze potential for a ticker |
| seasonality | Analyze historical seasonality patterns for a ticker or the market |
| etf-flow | Analyze ETF inflows, outflows, and sector exposure |
| bullish-confluence | Find stocks with multiple bullish signals across flow, dark pool, and insiders |
| bearish-confluence | Find stocks with multiple bearish signals across flow, dark pool, and insiders |
| politician-portfolio | [Premium] Analyze a politician's portfolio holdings and recent trades — requires premium plan, contact support@unusualwhales.com to upgrade |
| weekly-expiration | Analyze max pain, gamma, and positioning for weekly options expiration |
| economic-calendar | Economic calendar with FOMC, CPI, jobs data and market positioning |
| end-of-day-recap | End of day market recap with flow, dark pool, and sector summary |
| correlation-analysis | Analyze correlations between tickers over a time period |
| top-movers | Top tickers by net premium and options impact today |
| news-scanner | Market news headlines with related options and dark pool activity |
| option-contract | Deep dive analysis of a specific option contract |
| analyst-tracker | Recent analyst ratings changes with options flow correlation |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| API Reference | Complete reference documentation for all Unusual Whales API tools |
| Tools Summary | Summary of available tools with their actions and parameters |
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.