Unusual Whales MCP Server

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"

The server includes many ready-to-use prompts. Just ask to use any prompt by name.

Chain prompts together for comprehensive analysis:

Use morning-briefing, then use unusual-flow to dig into the top movers

Use pre-earnings for NVDA, then use greek-exposure to see dealer positioning

Use bullish-confluence to find candidates, then use ticker-analysis on the top result

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

Claude 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:

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