convez.ai
MCP ServerFinanceiroIntermediário
erikmaday

Unusual Whales MCP Server

erikmaday/unusual-whales-mcp

Acesso a dados avançados de mercado de opções e dark pool via MCP

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor MCP que conecta Claude e aplicações LLM aos dados de mercado do Unusual Whales — opções, dark pool, trades congressionais e mais. Fornece análise de fluxo de opções, atividade institucional, exposição de gregos e tendências de mercado via interface de linguagem natural.

Instalação

$npx convez-ai erikmaday/unusual-whales-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
78
Forks
15
Acompanhando
1
Saúde
71%
Último commit
há 6 dias
Versão
v0.3.0
Issues abertas
4
Contribuidores
4

Casos de uso

  • Análise de fluxo de opções e max pain em tempo real
  • Rastreamento de atividades dark pool e trades congressionais
  • Pesquisa de exposição institucional e holdings de 13F
  • Análise de volatilidade, gregos e estrutura de termos
  • Screening de ações com dados de short interest e FTDs

Veredito

Ferramenta especializada para traders e analistas quantitativos que precisam integrar dados sofisticados de mercado (opções, dark pool, congressional trades) em fluxos de análise com Claude. Requer conhecimento de mercado e API do Unusual Whales, mas oferece acesso robusto a dados alternativos de alta qualidade.

README

A tradução para o português deste README ainda está na fila.

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).

What You Can Do

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"

Available Data

CategoryWhat's Included
StockOptions chains, Greeks, IV rank, OHLC candles, max pain, open interest, volatility
OptionsContract flow, historic prices, intraday data, volume profiles
FlowOptions flow alerts, full tape, net flow by expiry, sector flow (mag7, semis, etc.)
Dark PoolDark pool transactions with filtering
CongressCongressional trades, late reports, individual member activity
PoliticiansPortfolios, recent trades, holdings by ticker
InsiderInsider transactions, sector flow, ticker flow
Institutions13F filings, holdings, sector exposure, ownership
MarketMarket tide, sector tide, economic calendar, FDA calendar, correlations
EarningsPremarket and afterhours schedules, historical earnings
ETFHoldings, exposure, inflows/outflows, sector weights
ShortsShort interest, FTDs, short volume ratio
SeasonalityMarket seasonality, monthly performers, ticker patterns
ScreenerStock screener, options screener, analyst ratings
NewsMarket news headlines

Built-in Analysis Prompts

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

Market Overview

PromptDescriptionExample
daily-summaryComprehensive market overview with tide, sectors, flow, dark pool"Use the daily-summary prompt"
morning-briefingStart the day with tide, earnings, and key activity"Use the morning-briefing prompt"
end-of-day-recapEOD summary with top movers, sectors, and themes"Use end-of-day-recap"
weekly-expirationMax pain, gamma, and OI for weekly expiration"Use weekly-expiration for SPY, QQQ, IWM"
top-moversTop tickers by net premium and options impact"Use top-movers"

Ticker Analysis

PromptDescriptionExample
ticker-analysisDeep dive on a stock with options, dark pool, insiders, catalysts"Use ticker-analysis for NVDA"
options-setupIV rank, term structure, max pain - is premium cheap or expensive?"Use options-setup for TSLA"
pre-earningsHistorical moves, IV, positioning before earnings"Use pre-earnings for AAPL"
greek-exposureGamma, delta, vanna exposure by strike"Use greek-exposure for SPY"
short-interestShort interest, FTDs, squeeze potential"Use short-interest for GME"
option-contractDeep dive on a specific option contract"Use option-contract for AAPL240119C00150000"
correlation-analysisAnalyze correlations between tickers"Use correlation-analysis for NVDA,AMD,INTC"

Flow & Activity

PromptDescriptionExample
unusual-flowScan for unusual options activity across the market"Use unusual-flow with min_premium 500000"
dark-pool-scannerFind large dark pool prints and institutional activity"Use dark-pool-scanner"
sector-flowOptions flow sentiment for sector groups (mag7, semi, bank, etc.)"Use sector-flow for semi"

Smart Money

PromptDescriptionExample
congress-trackerRecent congressional trading with pattern detection"Use congress-tracker"
politician-portfolioPortfolio holdings and trades for a specific politician"Use politician-portfolio for Nancy Pelosi"
insider-scannerScan for insider buying/selling patterns"Use insider-scanner"
institutional-activity13F filings, holdings changes, sector rotation"Use institutional-activity for technology"
analyst-trackerAnalyst ratings with options flow correlation"Use analyst-tracker"

Calendars & Events

PromptDescriptionExample
earnings-calendarEarnings with IV, expected moves, and positioning"Use earnings-calendar for this week"
fda-calendarFDA events with biotech options activity"Use fda-calendar"
economic-calendarFOMC, CPI, jobs data with market positioning"Use economic-calendar"

Screening & Discovery

PromptDescriptionExample
iv-screenerFind high or low IV rank stocks for options strategies"Use iv-screener"
bullish-confluenceStocks with bullish flow + dark pool + insider buying"Use bullish-confluence"
bearish-confluenceStocks with bearish flow + distribution + insider selling"Use bearish-confluence"
news-scannerMarket news headlines with related flow"Use news-scanner" or "Use news-scanner for TSLA"

Other

PromptDescriptionExample
seasonalityHistorical seasonal patterns for a ticker or market"Use seasonality for AAPL"
etf-flowETF inflows/outflows or find ETF exposure for a stock"Use etf-flow for QQQ"

Combining Prompts

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

Getting Started

1. Get an API Key

Sign up at Unusual Whales and get your API key.

2. Install

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"
      }
    }
  }
}

3. Start Asking Questions

Once configured, just ask about the market. The Unusual Whales data will be used automatically.

Configuration (Optional)

The defaults work well for most users. All settings can be adjusted via environment variables:

VariableDescriptionDefault
UW_API_KEYYour Unusual Whales API keyRequired
UW_RATE_LIMIT_PER_MINUTEMax requests per minute120
UW_MAX_RETRIESRetry attempts for failed requests3
UW_CIRCUIT_BREAKER_THRESHOLDFailures before pausing requests5
UW_CIRCUIT_BREAKER_RESET_TIMEOUTMilliseconds before retrying after failures30000

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.

Contributing

See CONTRIBUTING.md for development setup, testing, and contribution guidelines.

License

MIT

Ver o original no GitHub

Bom para

Relacionados