Skip to main content
Glama
Unusual Whales MCP

Unusual Whales MCP

Official

Unusual Whales MCP

Inspired by erikmaday/unusual-whales-mcp - the original community MCP server for Unusual Whales by Erik Maday.

npm License: MIT

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-remote to 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.json

  • Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json

  • Cursor: .cursor/mcp.json or ~/.cursor/mcp.json

  • VS Code: .vscode/mcp.json

  • Windsurf: ~/.codeium/windsurf/mcp_config.json

Troubleshooting

Problem

Fix

Server not connecting

Make sure the URL is exactly https://api.unusualwhales.com/api/mcp. Common mistake: using unusualwhales.com/public-api/mcp (that's the docs page, not the server).

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 "Authorization: Bearer YOUR_KEY" in the --header arg. Local config needs UW_API_KEY in env.

npx not found (nvm users)

Claude Desktop doesn't inherit your shell PATH. Use the full path to npx in the command field (e.g. /Users/you/.nvm/versions/node/v20.x.x/bin/npx) and add "env": { "PATH": "/Users/you/.nvm/versions/node/v20.x.x/bin:/usr/local/bin:/usr/bin:/bin" }.

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 activity

Related 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 futures add-on

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

get_fundamental_breakdown

Filing-based fundamentals, revenue segmentation, EPS, dividends, and balance-sheet trends

get_stock_financials

Combined financials payload with income statements, balance sheets, cash flows, and earnings

get_income_statements

Income statement history with optional report_type filter

get_balance_sheets

Balance sheet history with optional report_type filter

get_cash_flows

Cash flow history with optional report_type filter

get_earnings_history

Historical reported/estimated EPS and earnings surprises with optional report_type filter

get_technical_indicator

Indicator series for SMA, EMA, RSI, MACD, BBANDS, STOCH, ADX, ATR, OBV, VWAP, CCI, WILLR, AROON, and MFI

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

daily-summary

Market overview with tide, sectors, flow, dark pool

morning-briefing

Morning tide, earnings, and key activity

end-of-day-recap

EOD top movers, sectors, and themes

weekly-expiration

Max pain, gamma, and OI for weekly expiry

top-movers

Top tickers by net premium and options impact

Prompt

What it does

ticker-analysis

Deep dive: options, dark pool, insiders, catalysts

options-setup

IV rank, term structure, max pain analysis

pre-earnings

Historical moves, IV, positioning before earnings

greek-exposure

Gamma, delta, vanna exposure by strike

short-interest

Short interest, FTDs, squeeze potential

option-contract

Deep dive on a specific option contract

correlation-analysis

Cross-ticker correlation analysis

Prompt

What it does

unusual-flow

Scan for unusual options activity

dark-pool-scanner

Large dark pool prints and institutional activity

sector-flow

Options flow sentiment by sector group

Prompt

What it does

congress-tracker

Recent congressional trading with patterns

politician-portfolio

Portfolio holdings for a specific politician

insider-scanner

Insider buying/selling patterns

institutional-activity

13F filings, holdings changes, sector rotation

analyst-tracker

Analyst ratings with options flow correlation

Prompt

What it does

earnings-calendar

Earnings with IV and expected moves

fda-calendar

FDA events with biotech options activity

economic-calendar

FOMC, CPI, jobs data with positioning

Prompt

What it does

iv-screener

High/low IV rank stocks for options strategies

bullish-confluence

Bullish flow + dark pool + insider buying

bearish-confluence

Bearish flow + distribution + insider selling

news-scanner

Headlines with related options flow

seasonality

Historical seasonal patterns

etf-flow

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 result

Configuration

All optional. The defaults work for most users.

Variable

Default

Description

UW_API_KEY

required

Your Unusual Whales API key

UW_RATE_LIMIT_PER_MINUTE

120

Max requests per minute

UW_MAX_RETRIES

3

Retry attempts for failed requests

UW_CIRCUIT_BREAKER_THRESHOLD

5

Failures before circuit opens

UW_CIRCUIT_BREAKER_RESET_TIMEOUT

30000

Ms before retrying after circuit opens

LOG_LEVEL

info

Logging verbosity (debug, info, warn, error)

UW_ENABLE_PREMIUM_TOOLS

unset

Set to 1/true to expose every premium tool and command

UW_PREMIUM_TOOLS

unset

Comma-separated allowlist of premium tools/commands to expose, e.g. uw_futures,uw_flow.full_tape

Endpoint Schema

Every endpoint the server exposes is published as machine-readable JSON, generated from the same catalog the server registers from:

File

Contents

docs/endpoints.json

Full JSON Schema for every command's parameters, plus route and query-param renames

docs/endpoints-compact.json

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 drift

WebSocket 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 tools
get_balance_sheetsB
Read-onlyIdempotent

Get balance sheet data for a ticker, including assets, liabilities, equity, debt structure, and shares outstanding.

Inputs: ticker (required), report_type.

get_cash_flowsB
Read-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_historyB
Read-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_breakdownA
Read-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_statementsB
Read-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_financialsA
Read-onlyIdempotent

Get combined stock financials for a ticker, including income statements, balance sheets, cash flows, and earnings.

Inputs: ticker (required).

get_technical_indicatorB
Read-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_alertsA
Read-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_congressA
Read-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_cryptoA
Read-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_darkpoolA
Read-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_earningsB
Read-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_etfA
Read-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_flowA
Read-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_fundamentalsB
Read-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_insiderA
Read-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_institutionsA
Read-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_marketA
Read-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_newsA
Read-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_optionsA
Read-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_potusA
Read-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_predictionsA
Read-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_screenerA
Read-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_seasonalityA
Read-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_shortsA
Read-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_stockA
Read-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_technicalsB
Read-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

    A3.6/5.0

    Scored across 27 tools

    Disambiguation3/5

    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.

    Naming Consistency4/5

    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.

    Tool Count4/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      An 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.
      17
      51
      Python
      MIT
    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      Real-time financial market data MCP server. Stocks, crypto, technicals, sentiment, FDA calendar. No API keys required.
      -
    • A
      license
      A
      quality
      C
      maintenance
      Comprehensive MCP server for real-time stock, cryptocurrency, options, and fundamental analysis, including SEC filings and insider trading data.
      26
      9 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Options analytics MCP server providing 40+ tools for options chain data, position valuation, Greeks, charts, and volatility analysis.
      MIT