# Unusual Whales MCP [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/unusual-whales/unusual-whales-official-mcp  
**GitHub Stars:** 91  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/unusual-whales-mcp

## Description
The official Unusual Whales MCP server. Options flow, dark pool prints, congressional trades, Greek exposure, volatility, futures and prediction markets as MCP tools. Needs a UW API key.

## Tools
Capabilities this server exposes over MCP:

- **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

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "unusual-whales-mcp": {
    "command": "npx",
    "args": ["-y","@unusualwhales/mcp"],
    "env": {
      "UW_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `UW_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What Unusual Whales MCP does

The Unusual Whales MCP MCP server makes Unusual Whales market data available to MCP-compatible AI clients. The service covers more than 200 market-data endpoints across stock, options, flow, dark pool, congress, insider, institutions, market, earnings, ETF, shorts, seasonality, screener, and news categories.

Its explicitly documented stock-data tools include filing-based fundamental breakdowns, combined financial statements, income statements, balance sheets, cash flows, earnings history, and technical-indicator series. The technical tool supports SMA, EMA, RSI, MACD, Bollinger Bands, stochastic, ADX, ATR, OBV, VWAP, CCI, Williams %R, Aroon, and MFI indicators.

## How it works

The remote deployment is available at `https://api.unusualwhales.com/api/mcp` and accepts the API key as a Bearer authorization header. The local option runs the published `@unusualwhales/mcp` npm package and reads the key from `UW_API_KEY`.

After the client connects, it can select tools based on natural-language requests. Example requests include checking a ticker’s options flow, finding recent congressional trades, reviewing dark pool activity, examining max pain for an expiry, or combining options, dark pool, and insider information for a ticker. The README also lists more than 30 named analysis prompts, including market summaries, ticker analysis, unusual-flow scans, dark-pool scans, and Greek-exposure analysis.

## Setup and configuration

An Unusual Whales API key is required. Keys are obtained through the API dashboard on unusualwhales.com. Remote configuration is supported for Claude Code, Claude Desktop through the `mcp-remote` bridge, Cursor, VS Code, and Windsurf. Claude Desktop’s remote setup requires Node.js 18 or newer because it uses that bridge.

For local execution, the package requires Node.js 20 or newer. Configure `UW_API_KEY` in the client’s MCP server environment, then restart the client completely so it loads the server at startup. The documented local configurations cover Claude Code, Claude Desktop, Cursor, and VS Code.

The Unusual Whales MCP MCP server uses different configuration field names in some clients: VS Code uses `servers`, Cursor uses `url`, and Windsurf uses `serverUrl`. For remote connections, use the API endpoint exactly as documented rather than the public API documentation page.

## Tools and capabilities

- Query options chains, Greeks, implied-volatility data, candles, open interest, quotes, max pain, and volatility.
- Inspect options flow, trade tapes, multi-leg strategies, expiry flow, and sector flow.
- Review dark pool transactions with NBBO context and price-level filtering.
- Retrieve congressional, insider, and institutional activity, including 13F holdings and ownership changes.
- Analyze market tides, sectors, economic and FDA calendars, earnings, ETFs, short interest, borrow rates, seasonality, screeners, and market news.
- Retrieve financial statements, EPS history, filing-based fundamentals, and technical-indicator series.

## Limitations and notes

A valid and active API key is required; an invalid key can produce a 401 response. Futures data requires the Advanced tier or a `futures` add-on. Politician portfolios, recent trades, and holdings require a premium upgrade through Unusual Whales support.

Clients may not display tools until they are fully quit and reopened after configuration changes. Claude Desktop may also need the full filesystem path to `npx` when its shell PATH does not include Node.js, such as in some nvm installations. The README identifies the project license as MIT.

## Getting started with this Unusual Whales MCP MCP server
Always refer to the official documentation for the most accurate and up-to-date information.

_Full upstream README: https://allmcps.com/mcp/unusual-whales-mcp/readme_