AI agents & LLMs

The market data layer for AI agents

Give Claude, ChatGPT, Grok, Cursor or your own agent live options flow, greeks and gamma exposure, dark pool prints, congressional and insider trades, 13F holdings and more. Connect over MCP in one line, or build on the REST API, WebSocket and Kafka feeds behind it.

Connect your AI →Get an API key

Claude
Claude Code
ChatGPT
Codex
Grok
Perplexity
Cursor

Every way an agent can connect

Use the hosted MCP server for assistants, the apps for people who just want to ask questions, and the API, WebSocket or Kafka feeds when you are building your own agent.

MCP server

A hosted Model Context Protocol server with 100+ tools for options flow, greeks, dark pool, congress, insiders, earnings and more. Authenticate with your API key.

https://api.unusualwhales.com/api/mcpSet up MCP →

Apps in ChatGPT, Claude and Grok

Sign in with your Unusual Whales account and ask questions in plain English. In ChatGPT, answers come with interactive charts.

No API key to pasteAdd the app →

Agent skill file

A Markdown skill that tells coding agents the base URL, auth, which endpoints exist and which commonly guessed ones don't. Six more skills cover 13F, WebSocket, earnings and dashboards.

unusualwhales.com/skill.mdRead skill.md →

REST API

200+ documented endpoints with an OpenAPI spec, so agents can generate correct clients instead of guessing.

api.unusualwhales.com/docsAPI docs →

WebSocket streams

Around 50 live channels: option trades, flow alerts, GEX by strike and expiry, dark pool and lit trades, news, halts and SEC filings.

wss://api.unusualwhales.com/socketWebSocket docs →

Kafka

36 protobuf topics with 72 hours of retention, for teams that run their own models and pipelines at scale.

EnterpriseKafka streaming →

One line to connect

In Claude Code, this adds the server. Other clients take the same URL, https://api.unusualwhales.com/api/mcp, with your API key as a Bearer token.

claude mcp add --transport http unusual-whales \
  https://api.unusualwhales.com/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Built so agents get it right

Agents fail on financial data when they guess endpoints or parse web pages. Every part of our setup is designed to stop that.

Real tools, not scraped pages

Every MCP tool calls the same data our platform uses, with typed inputs. Agents get structured JSON back, not HTML to parse.

A public tool catalog

GET api.unusualwhales.com/api/mcp/tools lists every tool without a key, so you can see what an agent can do before you connect.

Build recipes and working examples

The server points agents to build recipes (dashboards, alerts, trading bots, data streams, backtests), the open api-examples repo and the live docs, and tells them never to invent endpoint paths.

A list of endpoints that don't exist

skill.md names the endpoints models commonly hallucinate and maps plain-English requests to the right ones, so generated code works on the first run.

What you can ask

Each question maps to a real MCP tool. The assistant picks the tool, calls it and answers from the data.

You ask	Tool the agent calls
“Show me the largest NVDA call sweeps today”	`get_flow_alerts`
“Which SPX strikes hold the most gamma for this Friday's expiry?”	`get_greek_exposure_by_strike_expiry`
“What did members of Congress buy this week?”	`get_recent_congress_trades`
“Biggest dark pool prints in SPY today”	`get_dark_pool_trades`
“Build me a dashboard of unusual options activity for my watchlist”	`get_build_recipe`

Data your agent can query

The same datasets that power Unusual Whales, available to agents through MCP and the API.

Dataset	Source	History since
Option Trades	US OPRA feed	2022
Multi leg Trades	US OPRA feed	2025
Option Screener	US OPRA feed	2022
Interval Flow	US OPRA feed	2024
End-of-Day Option States (including greeks)	US OPRA feed	2022
Aggregate greek exposure ("GEX" etc.)	US OPRA feed	2023
SPX Market Exposure	CBOE C1 only	2025
Volatility	US OPRA feed	2022
Net Premium Ticks and Market Tide	US OPRA feed	2022
Delta / Vega Ticks	US OPRA feed	2024
Flex options	US Equity and Option Markets	2026
Account options volume	US OPRA feed	2026
Stock trades (lit + off lit)	US Equity Markets	2022
OHLC	US Equity Markets	2000
Trading Halts	US Equity Markets	2021
News
Earnings	US Equity Markets	2022
Analyst Ratings	US Equity Markets	2022
Alerts (TradeAlert compatible)
Futures Trades	CME Futures feed	2026
13F	SEC-regulated US securities	Full
Insider (3/4/5/144)	SEC-regulated US securities	Full
Ownership (super set of 13F)	SEC-regulated US securities	Full
Politician Portfolios	STOCK Act	Full
Lobbying and Campaign Contribution	US LDA and FEC	2015
Predictions	Global	Full

Frequently asked

Which AI assistants work with Unusual Whales?+

Claude (including Claude Code), ChatGPT, Codex, Grok, Perplexity and Cursor have step-by-step setup. Any other MCP client can connect to the hosted server at api.unusualwhales.com/api/mcp with an API key.

How does authentication work?+

The MCP server and REST API take your Unusual Whales API key as a Bearer token in the Authorization header. The ChatGPT, Claude and Grok apps let you sign in with your Unusual Whales account instead, so there is no key to paste.

Is the data real-time?+

Yes. Options flow, trades, greeks and exposures update through the trading day on paid API plans, and the WebSocket and Kafka feeds stream them as they happen.

What data can an agent access?+

Options trades and flow alerts from the full OPRA tape, option chains, greeks and gamma exposure, volatility, dark pool and lit stock trades, congressional trades, insider transactions, 13F holdings, earnings, short data, prediction markets, crypto and macro data. History goes back to 2022 for most options datasets.

Can an agent write code against the API without hallucinating endpoints?+

That is what skill.md and the MCP build tools are for. They give the agent the exact endpoint list, working examples and build recipes, and name the endpoints models tend to make up.

How much does it cost?+

API access, including MCP, is part of the API plans. See the API pricing page for current plans, and contact us for enterprise feeds like Kafka.