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
U
Unusual Whales MCP
Official
Official Unusual Whales MCP server with 100+ market data endpoints
GitHub source repository ↗
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.
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.
Tools
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.
Setup
- Get an API key at unusualwhales.com/settings/api-dashboard.
- Configure your client using either remote (recommended) or local mode.
- Remote: use URL https://api.unusualwhales.com/api/mcp and add header Authorization: Bearer YOUR_KEY.
- Local: set command npx -y @unusualwhales/mcp and environment variable UW_API_KEY.
- 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"
}
}
}
}
Fit and risk
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
Troubleshooting
- Server not connecting: Ensure URL is exactly https://api.unusualwhales.com/api/mcp, not the docs page
- Tools not appearing: Fully quit and reopen your client after adding config; check for trailing commas in JSON
- 401 Unauthorized: Verify API key is correct and active; remote config needs proper Authorization header, local config needs UW_API_KEY env
- npx not found (nvm users): Use full path to npx in command field and set PATH env variable
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
ClaudeFull support
Claude DesktopFull support
CursorFull support
VS CodeFull support
WindsurfFull support