# unusual-whales-mcp

> MCP server for Unusual Whales API - access options flow, dark pool, congress trades, and more

- **URL**: https://www.freshcrate.ai/projects/unusual-whales-mcp
- **Author**: erikmaday
- **Category**: MCP Servers
- **Latest version**: `v0.3.0` (2026-01-13)
- **License**: MIT
- **Source**: https://github.com/erikmaday/unusual-whales-mcp
- **Language**: TypeScript
- **GitHub**: 50 stars, 9 forks
- **Registry**: github
- **Tags**: `typescript`

## Description

MCP server for Unusual Whales API - access options flow, dark pool, congress trades, and more

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v0.3.0` | 2026-01-13 | Low | **Full Changelog**: https://github.com/erikmaday/unusual-whales-mcp/compare/v0.2.2...v0.3.0 |
| `v0.2.2` | 2026-01-13 | Low | ## What's Changed * feat(issue-4): add Zod schema validation for all MCP tools by @erikmaday in https://github.com/erikmaday/unusual-whales-mcp/pull/16 * feat(issue-5): add sliding window rate limiter for API requests by @erikmaday in https://github.com/erikmaday/unusual-whales-mcp/pull/17 * fix(issue-22): adding missing flow tool query params by @erikmaday in https://github.com/erikmaday/unusual-whales-mcp/pull/31 * fix(stock): add missing required expirations[] parameter for spot-exposures/exp |
| `v0.2.1` | 2026-01-13 | Low | ## What's Changed * fix(flow): rename ticker param to ticker_symbol to match API spec by @erikmaday in https://github.com/erikmaday/unusual-whales-mcp/pull/58 * fix(screener): add missing optional parameters and improve check-api script by @erikmaday in https://github.com/erikmaday/unusual-whales-mcp/pull/59 * feat: add idempotentHint annotation to all tools by @erikmaday in https://github.com/erikmaday/unusual-whales-mcp/pull/70 * feat(client): add exponential backoff retry for transient failur |
| `v0.1.3` | 2026-01-08 | Low | ## What's Changed * feat(issue-4): add Zod schema validation for all MCP tools by @erikmaday in https://github.com/erikmaday/unusual-whales-mcp/pull/16 * feat(issue-5): add sliding window rate limiter for API requests by @erikmaday in https://github.com/erikmaday/unusual-whales-mcp/pull/17 * fix(issue-22): adding missing flow tool query params by @erikmaday in https://github.com/erikmaday/unusual-whales-mcp/pull/31 * fix(stock): add missing required expirations[] parameter for spot-exposures/exp |
| `v0.1.2` | 2026-01-05 | Low | ## What's Changed * feat(issue-2): implement politician disclosures endpoint by @erikmaday in https://github.com/erikmaday/unusual-whales-mcp/pull/3  ## New Contributors * @erikmaday made their first contribution in https://github.com/erikmaday/unusual-whales-mcp/pull/3  **Full Changelog**: https://github.com/erikmaday/unusual-whales-mcp/compare/v0.1.1...v0.1.2 |
| `v0.1.1` | 2026-01-03 | Low | **Full Changelog**: https://github.com/erikmaday/unusual-whales-mcp/compare/v0.1.0...v0.1.1 |

## Citation

- HTML: https://www.freshcrate.ai/projects/unusual-whales-mcp
- Markdown: https://www.freshcrate.ai/projects/unusual-whales-mcp.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/unusual-whales-mcp/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._