How do I install the Unusual Whales MCP MCP server?

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.

Does Unusual Whales MCP work with Cursor?

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.

What API key does the Unusual Whales MCP server need?

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.

Does Unusual Whales MCP include futures data?

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.

Unusual Whales MCP

financemarket-dataoptionstradingmcp

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

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Also available as a hosted endpoint

Clients with native remote MCP support can connect directly to this URL instead of the stdio install above.

Remote endpoint

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

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Configure Environment Variables (API Keys, Tokens, Options):

Add required secrets below — values are included directly in the generated snippet so you can copy and paste with confidence.

Quick Add:

Choose your client or environment

Target File:~/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"
      }
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

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

Capabilities & Tool Schemas (7)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Unusual Whales 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

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

Read the full README →View source on GitHub →

Related MCP Servers

View all in Finance & Fintech View all alternatives

Adoption & maintenance

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

GitHub stars

Stargazers on the source repository.

Last commit

1mo ago

Most recent push to the default branch.

Maintenance

Actively maintained

Status declared by the project or listing owner.

Tools exposed

Callable tools this server registers over MCP.

Reviews

No reviews yet — be the first to share how this listing 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.

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 Preview

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

Technical Specs & Signals

CategoryFinance & Fintech

PricingPaid

69Quality signal: Great · 69/100How this signal is calculated ▾

Server availability25/25

Verified ownership10/20

Documentation & tools28/30

Adoption & activity6/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Featured

AllMCPs Server

The official MCP server for AllMCPs.com - submit and manage tools directly from your AI. The open directory for MCP servers. Connect Claude, Cursor, Windsurf, and AI agents to databases, tools, files, and APIs. Explore 10,000+ servers. AllMCPs is the premier, open directory for discovering, evaluating, and installing Model Context Protocol (MCP) servers to equip AI agents and LLMs with real-world superpowers.

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💰 Finance & Fintech →Best MCP servers for Finance & Fintech →Alternatives to Unusual Whales MCP →Install in Claude Desktop Install in Cursor Install in VS Code Setup guides for all 13 MCP clients