Unusual Whales MCP logo

Unusual Whales MCP

Connects MCP-compatible clients to Unusual Whales market data for options, financials, technicals, dark pools, and congressional trades.

Install Unusual Whales MCP

Pick your client, then add it in one click or paste the config.

Streamable HTTP (Remote)
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "unusual-whales-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@unusualwhales/mcp"
      ],
      "env": {
        "UW_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Hosted endpointLive · 1d agoLive Remote EndpointOur automated health check connected to this remote MCP endpoint successfully.Last checked 1d ago · Nov 19, 2026, 01:30 UTC

Clients with native remote MCP support can connect directly to this URL.

Remote endpoint
https://api.unusualwhales.com/api/mcp

Automated check passed— started and listed 27 tools correctly ().

Overview

Unusual Whales MCP MCP server connects MCP-compatible clients to the Unusual Whales market-data API through a hosted HTTP endpoint or a local npm package. It exposes tools for options flow, dark pool activity, congressional and insider trades, financial statements, earnings, and technical indicators, along with broader market-data categories. Use it when an agent needs market research based on Unusual Whales data and you have an active UW API key. Premium data such as futures and politician portfolios may require an eligible subscription or add-on.

Use cases

  • Analyze options flow for a ticker
  • Review recent congressional trades
  • Inspect dark pool activity
  • Compare financial statements and earnings history
  • Calculate technical indicator series

Key features

  • Options flow and Greek exposure data
  • Dark pool and congressional trade data
  • Financial statements and fundamentals
  • Technical indicator series
  • Market, ETF, short-interest, and news data
  • Ready-to-use analysis prompts

Tools27

What Unusual Whales MCP lets your agent do. Expand a tool for its parameters.

Verified live~5.3k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked

Recent health check succeeded.

18/18 checks healthy over the last 45d

What it can do

From the 27 tools this server returned when we ran it; 27 declare their own safety hints.

Makes network requests · 27Read-only tools · 27
Network at startup3 connections
Files written at startupNone
Install scriptsprepare
npm provenanceNot published
Package age251 days
Maintainers1

Observed 2026-11-09 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 13d ago via OSV.dev · @unusualwhales/mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars95Stargazers on the source repository.
npm downloads673Package downloads in the last 30 days.
Last commit3mo agoMost recent push to the default branch.
MaintenanceActively maintainedStatus declared by the project or listing owner.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed27Callable tools this server registers over MCP.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How Unusual Whales MCP works

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.

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.

Written by AllMCPs with AI assistance from the project’s README and listing data. How we build listings

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Unusual Whales MCP

Unusual Whales MCP is an MCP server that connects AI clients to the Unusual Whales market-data API. Its main tools cover options flow, dark pool activity, congressional and insider trades, financial statements, earnings history, fundamental breakdowns, and technical indicators. It requires an active Unusual Whales API key.

Install it locally with `npx -y @unusualwhales/mcp` and provide `UW_API_KEY`, or connect remotely to `https://api.unusualwhales.com/api/mcp` with a Bearer API-key header. Local execution requires Node.js 20 or newer.

Yes, Unusual Whales MCP works with Cursor. Add the remote URL and authorization header to `.cursor/mcp.json` or `~/.cursor/mcp.json`, or configure the local npm package with `UW_API_KEY`, then restart Cursor.

It needs an active Unusual Whales API key. Get the key from the Unusual Whales API dashboard, then pass it as `Authorization: Bearer YOUR_KEY` for remote connections or set `UW_API_KEY` for the local package.

Yes, futures capabilities are listed, but they require the Advanced subscription tier or a `futures` add-on. The listed futures coverage includes CME contracts, cross-contract flow, time and sales, OHLCV candles, and session statistics.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewUnusual Whales MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/unusual-whales-mcp?style=directory)](https://allmcps.com/mcp/unusual-whales-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/unusual-whales-mcp"><img src="https://allmcps.com/api/badge/unusual-whales-mcp?style=directory" alt="Unusual Whales MCP on AllMCPs" /></a>