Unusual Whales MCP
The official Unusual Whales MCP server: options flow, dark pool, congressional trades and 200+ market data endpoints for an agent
- 94 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The API key sits in the client configuration or a request header and opens paid data on your tier.
- The agent's requests go to an external service together with the tickers and questions you discuss.
Install
- Works in
Manual install
claude mcp add --transport http unusualwhales https://api.unusualwhales.com/api/mcp --header "Authorization: Bearer YOUR_KEY"Remote mode with no install. Get the API key on the Unusual Whales settings page.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The API key sits in the client configuration or a request header and opens paid data on your tier.
- The agent's requests go to an external service together with the tickers and questions you discuss.
This is third-party code. Review the repository files before installing.
What it does
The Unusual Whales MCP server connects an agent to the service's market data: options flow, dark pool trades, congressional and insider trades, institutional 13F filings, Greeks, volatility, short interest and futures. The tools are split into 16 categories, and the agent picks the ones it needs from a question like "what is the options flow for AAPL today". The remote mode needs no install: the address `https://api.unusualwhales.com/api/mcp` and an API key in the `Authorization: Bearer` header. A local run goes through `npx -y @unusualwhales/mcp` with the `UW_API_KEY` variable. More than thirty ready-made prompts come with it: a daily summary, a pre-earnings review, Greeks by strike, a dark pool scan, short interest.
Who it is for. Traders and analysts with an Unusual Whales API key who work through options flow and insider trades by asking an agent.
Good fit when
- In the morning an agent builds a market summary: tide, sectors, flow and dark pools.
- Before an issuer's earnings, historical price moves, implied volatility and positioning get compared.
- A ticker needs fresh congressional and insider trades.
- For options expiring on Friday, the agent finds max pain, open interest and Greeks.
- A note pulls multi-year filing data: balance sheet, cash flow and EPS.
Not a fit when
- There is no Unusual Whales API key: without it the server answers with a 401 error.
- You need CME futures or politicians' portfolios: they open on the Advanced tier, with the `futures` add-on or after a support request.
- The agent must place orders: the server returns data and makes no trades.
- The agent's answers would be the only basis for a trade: the server gives no forecasts or recommendations.
Example request
Show today's options flow and dark pool activity for TSLA and the latest insider trades.MCP
- Transport
- http, stdio
- Authentication
- API key
Environment variables
UW_API_KEYrequired, secret- Unusual Whales API key for the local run.
Limitations
An Unusual Whales API key is required, and part of the data, such as futures and politicians' portfolios, is gated by tier. A local run needs Node.js 20 or newer. Claude Desktop does not support remote servers directly and connects through `mcp-remote`, which needs Node.js 18 or newer. After editing the configuration, fully quit and reopen the client, or the tools will not appear. The server address must be exact: `unusualwhales.com/public-api/mcp` leads to the documentation page.
How to disable. Run `claude mcp remove unusualwhales` or delete the `unusualwhales` block from the client configuration, then revoke the key on the `unusualwhales.com/settings/api-dashboard` page.
FAQ
How do I connect Unusual Whales MCP to Claude Code?
Run `claude mcp add --transport http unusualwhales https://api.unusualwhales.com/api/mcp --header "Authorization: Bearer YOUR_KEY"`. The key is issued on the `unusualwhales.com/settings/api-dashboard` page.
Can I run the server myself?
Yes, with `claude mcp add unusualwhales -e UW_API_KEY=YOUR_KEY -- npx -y @unusualwhales/mcp` or an `npx` block in the client configuration. Node.js 20 or newer is required.
What data does the server return?
Stocks, options, flow, dark pools, futures, Congress, insiders, institutions, the market, earnings, ETFs, short interest, seasonality, a screener and news: 16 categories. Part of it is available only on higher tiers.
What if the tools do not appear?
Quit the client completely and reopen it. Then check the address `https://api.unusualwhales.com/api/mcp` and the key: a 401 error means the key is wrong.
Are there ready-made prompts?
Yes, more than thirty: `daily-summary`, `morning-briefing`, `ticker-analysis`, `options-setup`, `pre-earnings`, `unusual-flow`, `dark-pool-scanner` and more. Name the prompt in your request to the agent.
Discussion
No questions or reviews yet.
Related
MCP serversTwelve Data MCP connects an assistant to a market data API: quotes, historical prices, indicators, fundamentals and company news.
Financial Datasets MCP
Financial Datasets MCP Server
An MCP server for the Financial Datasets API: company financials, stock and crypto prices and news for the agent
investor-agent gives an agent quotes, price history, options, an earnings calendar and a fear and greed index with no key.
Financial data MCP server: stocks, funds, bonds, macro indicators, news and crypto via Tushare and Binance
MCP server that gives an agent Yahoo Finance data by ticker: price history, financial statements and option chains
The Massive.com market data MCP server: quotes, options, forex and crypto through three tools for search, API calls and SQL
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Unusual Whales MCP (this card) | yes | API key | 94 | |
| Alpha Vantage MCP Server | yes | OAuth | 227 | returns Alpha Vantage quotes and fundamentals; Unusual Whales MCP adds options flow, dark pools and congressional trades |
| SEC EDGAR MCP | no | not required | 387 | reads SEC EDGAR filings; Unusual Whales MCP gathers market data and trades behind a single API |
README in short
The project shows setup for Claude Code, Claude Desktop, Cursor, VS Code and Windsurf, a table of sixteen tool categories, dedicated filing and technical indicator tools and a list of ready-made prompts.