M
MCP Directory CURATED DIRECTORY
911 MCP servers indexed
中文
← Back to directory
U

Unusual Whales MCP

Official
Official Unusual Whales MCP server with 100+ market data endpoints
How to install ↓ Compare GitHub source repository ↗
Category
Other #168 of 230
Stars
★ 92 Popular
Transport
SSE · Streamable HTTP
Runtime
Node.js 18+ · Hosted (no local runtime)
Credentials
API key / credential required
License
MIT
Last commit
Tools
7
47FMRS · D

Official MCP server offering extensive market data endpoints with remote and local deployment options, supporting various clients, but requires a paid API key and remote mode depends on network service.

Strongest · Documentation 11/20 Weakest · Reliability 7/20

Reliability
7/20
Security and permissions
10/20
Maintenance
9/20
Documentation
11/20
Setup experience
10/20
Why each score
Reliability 7/20
The README details tools and endpoints, but no server source code is present in the repo, so startup, tool registration, and error handling cannot be verified. Local usage via npx @unusualwhales/mcp is mentioned, but the package source is not included, and no tests or CI are present. Thus, reliability is low based on static evidence.
Security and permissions 10/20
Documentation requires an API key, and remote endpoint uses Bearer header, but no clear statement on key storage or least privilege. No mention of key rotation or leak response. No malicious code found, but implementation not visible, so unknown risks.
Maintenance 9/20
Repository is active with recent commits and releases, and has MIT license. However, there are 8 open issues and no security response channel. Maintenance is decent but with governance and versioning gaps.
Documentation 11/20
README provides detailed setup instructions, client config examples, and troubleshooting table, with clear explanation of API key and config variables. However, no tool parameters, rate limits, or cost info, and no evidence of how configs affect usage.
Setup experience 10/20
README provides remote and local installation instructions for Claude Code, Desktop, Cursor, VS Code, and Windsurf, with clear steps. However, local mode requires Node.js 20+, and remote mode may require extra client configuration, which might be cumbersome for some users.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessUses the network

Best for

  • Traders and investors needing real-time market data
  • MCP client users who want to query options flow, dark pool, and congressional trades in natural language
  • Researchers interested in smart money flows and institutional holdings

Not for

  • Users without a need for market data or unable to provide an API key
  • Users preferring traditional APIs over MCP integration for latency-sensitive applications
  • Users requiring free or anonymous access

Required permissions

  • Requires a valid Unusual Whales API key (UW_API_KEY)
  • Access to public stock fundamentals and technical indicator endpoints
  • Local mode requires Node.js 20+ runtime
  • Remote mode requires network access to api.unusualwhales.com

Risks and side effects

  • API key leakage could lead to unauthorized use or charges; keep it secure
  • Market data usage may be rate-limited (default 120 requests per minute)
  • Remote server availability and stability depend on the provider
  • Data accuracy is guaranteed by the provider; may have delays or errors

Setup

Before you start

Runtime：Node.js 18+ · Hosted (no local runtime)

UW_API_KEY requiredsecret Unusual Whales API key from unusualwhales.com/settings/api-dashboard; required for local mode.
Other optional settings (5)
UW_RATE_LIMIT_PER_MINUTE optional Max requests per minute, default 120, optional.
UW_MAX_RETRIES optional Retry attempts for failed requests, default 3, optional.
UW_CIRCUIT_BREAKER_THRESHOLD optional Failures before the circuit breaker opens, default 5, optional.
UW_CIRCUIT_BREAKER_RESET_TIMEOUT optional Milliseconds before retrying after the circuit opens, default 30000, optional.
LOG_LEVEL optional Logging verbosity (debug/info/warn/error), default info, optional.
  1. Get an API key at unusualwhales.com/settings/api-dashboard.
  2. Configure your client using either remote (recommended) or local mode.
  3. Remote: use URL https://api.unusualwhales.com/api/mcp and add header Authorization: Bearer YOUR_KEY.
  4. Local: set command npx -y @unusualwhales/mcp and environment variable UW_API_KEY.
  5. Fully quit and reopen your AI assistant after configuration.
claude_desktop_config.json 
{
  "mcpServers": {
    "unusualwhales": {
      "command": "npx",
      "args": ["-y", "@unusualwhales/mcp"],
      "env": {
        "UW_API_KEY": "YOUR_KEY"
      }
    }
  }
}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json
{
  "servers": {
    "unusualwhales": {
      "command": "npx",
      "args": [
        "-y",
        "@unusualwhales/mcp"
      ],
      "env": {
        "UW_API_KEY": "YOUR_KEY"
      }
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal
claude mcp add unusualwhales -e UW_API_KEY=YOUR_KEY -- npx -y @unusualwhales/mcp

Run it in a terminal; replace any <…> placeholders with your own values first.

Generate and validate client config

Check that it works

After connecting, check that tools like get_fundamental_breakdown appear in your client's tool list, or ask "What's the options flow for AAPL today?" — a data response confirms the setup.

Troubleshooting

  1. Server not connecting: Ensure URL is exactly https://api.unusualwhales.com/api/mcp, not the docs page
  2. Tools not appearing: Fully quit and reopen your client after adding config; check for trailing commas in JSON
  3. 401 Unauthorized: Verify API key is correct and active; remote config needs proper Authorization header, local config needs UW_API_KEY env
  4. npx not found (nvm users): Use full path to npx in command field and set PATH env variable

Things to try

Once connected, you can ask your AI assistant things like:

  • What's the options flow for AAPL today?
  • Get the fundamental breakdown and earnings history for NVDA
  • Show me RSI and MACD technical indicators for TSLA
  • Show me the latest congressional trades

Tools 7

get_fundamental_breakdown read-only
Filing-based fundamentals, revenue segmentation, EPS, dividends, and balance-sheet trends.
get_stock_financials read-only
Combined financials payload with income statements, balance sheets, cash flows, and earnings.
get_income_statements read-only
Income statement history with optional report_type filter.
get_balance_sheets read-only
Balance sheet history with optional report_type filter.
get_cash_flows read-only
Cash flow history with optional report_type filter.
get_earnings_history read-only
Historical reported/estimated EPS and earnings surprises with optional report_type filter.
get_technical_indicator read-only
Indicator series for SMA, EMA, RSI, MACD, BBANDS, STOCH, ADX, ATR, OBV, VWAP, CCI, WILLR, AROON, and MFI.

Use cases

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

Supported clients

Claude
Claude Desktop
Cursor
VS Code
Windsurf

Listed from the project's documentation, not tested by this site.

Overview

The official Unusual Whales MCP server. Connect any MCP-compatible client to 100+ market data endpoints covering options flow, dark pool, congressional trading, Greek exposure, volatility, and more. Supports remote hosted and local modes, with 30+ ready-to-use analysis prompts.

Similar servers

BioMCP 75 · B

One binary. One grammar. Evidence from the biomedical sources you already trust.

★ 654 · Tools 11 Compare with this →
Compare with other MCP servers

Source revision 4f57b36ecc4f Data synced 2026-10-12 Read the FMRS scoring method