Back to Home
erikmaday icon

unusual-whales-mcp

Verified Safe

by erikmaday

Overview

Provides an AI assistant with comprehensive Unusual Whales market data, including options flow, dark pool activity, congressional trades, and more, for natural language market analysis.

Installation

Run Command
npx -y @erikmaday/unusual-whales-mcp

Environment Variables

  • UW_API_KEY
  • UW_RATE_LIMIT_PER_MINUTE
  • UW_MAX_RETRIES
  • UW_CIRCUIT_BREAKER_THRESHOLD
  • UW_CIRCUIT_BREAKER_RESET_TIMEOUT
  • UW_CIRCUIT_BREAKER_SUCCESS_THRESHOLD
  • LOG_LEVEL
  • UW_API_BASE_URL

Security Notes

The server uses `process.env.UW_API_KEY` for API authentication, preventing hardcoded secrets. Path parameters are explicitly validated and encoded to prevent path traversal (`/`, `\`, `..`) attempts. It implements robust resilience features like client-side rate limiting and a circuit breaker pattern, enhancing stability and preventing API abuse. While reliance on an external API inherently carries some risk, the server's design focuses on data retrieval rather than arbitrary code execution from API responses, mitigating direct code injection risks.

Similar Servers

Stats

Interest Score34
Security Score9
Cost ClassMedium
Avg Tokens750
Stars2
Forks0
Last Update2026-01-19

Tags

mcpunusual-whalesoptionstradingfinancialllm