WhaleSignal MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| UW_API_KEY | No | Your Unusual Whales API key. Required for live mode. | |
| WHALESIGNAL_DEMO | No | Set to '1' to run in demo mode with synthetic data, no API key required. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| conviction_scoreA | Composite 0-100 bullish/bearish conviction for a ticker. Fuses options flow alerts, net premium, call/put volume, dark pool accumulation, dealer gamma regime and recent congressional trades into one explainable score with per-signal breakdown and a plain-English rationale. |
| rank_watchlistB | Rank a watchlist of tickers by WhaleSignal conviction score (highest first). |
| market_briefingA | One-call plain-English daily market brief. Blends Market Tide sentiment, WhaleSignal conviction ranking over a watchlist,
and notable congressional trades into a written narrative plus structured data.
Pass your own |
| flow_alertsC | Raw unusual options flow alerts for a ticker (whale trades). |
| dark_poolC | Recent dark pool prints for a ticker. |
| market_pulseB | Overall market sentiment from Unusual Whales Market Tide (net premium flow). |
| congress_tradesA | Recent congressional trades, optionally filtered to one ticker. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Each tool has a distinct primary role: raw signal viewers (flow_alerts, dark_pool, market_pulse, congress_trades), composite scoring (conviction_score), ranking (rank_watchlist), and narrative output (market_briefing). The only mild overlap is that market_briefing includes ranking and congressional-trade data, but its output format and intent are clearly different.
The naming styles are mixed: rank_watchlist uses verb_noun, while most others use noun or noun_noun forms like flow_alerts, dark_pool, and market_briefing. Snake_case is consistent, but the lack of a uniform verb or part-of-speech pattern makes the set feel somewhat ad hoc.
Seven tools is a well-scoped size for a market-intelligence server. Each tool maps to a meaningful capability without redundancy or bloat.
The surface covers raw whale-flow data, market sentiment, congressional trades, composite conviction scores, watchlist ranking, and a briefing. Minor gaps exist around deeper drill-downs, such as standalone dealer-gamma or historical conviction breakdowns, but core workflows are not blocked.