Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@unusual-whales-mcp What's the options flow for AAPL today?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
An MCP server that provides access to Unusual Whales market data - options flow, dark pool activity, congressional trades, and more. Works with any MCP-compatible client (Claude, or any LLM/application that supports MCP).
Ask about the market using natural language:
"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"
"What are institutions buying in the tech sector?"
"Give me a daily market summary"
"Deep dive on NVDA - options, dark pool, insider activity"
Category | What's Included |
Stock | Options chains, Greeks, IV rank, OHLC candles, max pain, open interest, volatility |
Options | Contract flow, historic prices, intraday data, volume profiles |
Flow | Options flow alerts, full tape, net flow by expiry, sector flow (mag7, semis, etc.) |
Dark Pool | Dark pool transactions with filtering |
Congress | Congressional trades, late reports, individual member activity |
Politicians | Portfolios, recent trades, holdings by ticker |
Insider | Insider transactions, sector flow, ticker flow |
Institutions | 13F filings, holdings, sector exposure, ownership |
Market | Market tide, sector tide, economic calendar, FDA calendar, correlations |
Earnings | Premarket and afterhours schedules, historical earnings |
ETF | Holdings, exposure, inflows/outflows, sector weights |
Shorts | Short interest, FTDs, short volume ratio |
Seasonality | Market seasonality, monthly performers, ticker patterns |
Screener | Stock screener, options screener, analyst ratings |
News | Market news headlines |
The server includes many ready-to-use prompts. Just ask to use any prompt by name.
Prompt | Description | Example |
| Comprehensive market overview with tide, sectors, flow, dark pool | "Use the daily-summary prompt" |
| Start the day with tide, earnings, and key activity | "Use the morning-briefing prompt" |
| EOD summary with top movers, sectors, and themes | "Use end-of-day-recap" |
| Max pain, gamma, and OI for weekly expiration | "Use weekly-expiration for SPY, QQQ, IWM" |
| Top tickers by net premium and options impact | "Use top-movers" |
Prompt | Description | Example |
| Deep dive on a stock with options, dark pool, insiders, catalysts | "Use ticker-analysis for NVDA" |
| IV rank, term structure, max pain - is premium cheap or expensive? | "Use options-setup for TSLA" |
| Historical moves, IV, positioning before earnings | "Use pre-earnings for AAPL" |
| Gamma, delta, vanna exposure by strike | "Use greek-exposure for SPY" |
| Short interest, FTDs, squeeze potential | "Use short-interest for GME" |
| Deep dive on a specific option contract | "Use option-contract for AAPL240119C00150000" |
| Analyze correlations between tickers | "Use correlation-analysis for NVDA,AMD,INTC" |
Prompt | Description | Example |
| Scan for unusual options activity across the market | "Use unusual-flow with min_premium 500000" |
| Find large dark pool prints and institutional activity | "Use dark-pool-scanner" |
| Options flow sentiment for sector groups (mag7, semi, bank, etc.) | "Use sector-flow for semi" |
Prompt | Description | Example |
| Recent congressional trading with pattern detection | "Use congress-tracker" |
| Portfolio holdings and trades for a specific politician | "Use politician-portfolio for Nancy Pelosi" |
| Scan for insider buying/selling patterns | "Use insider-scanner" |
| 13F filings, holdings changes, sector rotation | "Use institutional-activity for technology" |
| Analyst ratings with options flow correlation | "Use analyst-tracker" |
Prompt | Description | Example |
| Earnings with IV, expected moves, and positioning | "Use earnings-calendar for this week" |
| FDA events with biotech options activity | "Use fda-calendar" |
| FOMC, CPI, jobs data with market positioning | "Use economic-calendar" |
Prompt | Description | Example |
| Find high or low IV rank stocks for options strategies | "Use iv-screener" |
| Stocks with bullish flow + dark pool + insider buying | "Use bullish-confluence" |
| Stocks with bearish flow + distribution + insider selling | "Use bearish-confluence" |
| Market news headlines with related flow | "Use news-scanner" or "Use news-scanner for TSLA" |
Prompt | Description | Example |
| Historical seasonal patterns for a ticker or market | "Use seasonality for AAPL" |
| ETF inflows/outflows or find ETF exposure for a stock | "Use etf-flow for QQQ" |
Chain prompts together for comprehensive analysis:
Use morning-briefing, then use unusual-flow to dig into the top moversUse pre-earnings for NVDA, then use greek-exposure to see dealer positioningUse bullish-confluence to find candidates, then use ticker-analysis on the top resultRelated MCP server: quiver-quant-mcp
Sign up at Unusual Whales and get your API key.
Claude Code:
claude mcp add unusualwhales -e UW_API_KEY=your_api_key -- npx -y @erikmaday/unusual-whales-mcpClaude Desktop:
Add to your config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"unusualwhales": {
"command": "npx",
"args": ["-y", "@erikmaday/unusual-whales-mcp"],
"env": {
"UW_API_KEY": "your_api_key"
}
}
}
}Once configured, just ask about the market. The Unusual Whales data will be used automatically.
The defaults work well for most users. All settings can be adjusted via environment variables:
Variable | Description | Default |
| Your Unusual Whales API key | Required |
| Max requests per minute |
|
| Retry attempts for failed requests |
|
| Failures before pausing requests |
|
| Milliseconds before retrying after failures |
|
The server automatically handles rate limiting, retries failed requests with backoff, and temporarily pauses requests if the API is having issues (circuit breaker). See CONTRIBUTING.md for technical details.
See CONTRIBUTING.md for development setup, testing, and contribution guidelines.
MIT
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Real SEC, 13F, insider, congress & macro data your AI agent can cite. Hosted MCP, 24 tools.
Query normalized U.S. Congress STOCK Act trades with member, ticker, and performance data.
US/HK markets — 151 tools: quotes, options, orders, fundamentals, screener, IPO, alerts & DCA
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/erikmaday/unusual-whales-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server