# OptionWhales

> OptionWhales is a freemium MCP server for stock market data. MCP server giving AI assistants options flow, gamma exposure and IV data for research. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $19 a month
- **Platforms:** API, Web
- **Website:** https://optionwhales.io/for-ai-agents
- **MCP Registry name:** io.optionwhales/options-flow
- **Categories:** [stock market data](https://ai-powered.com/categories/stock-market-data), [financial data](https://ai-powered.com/categories/financial-data)
- **Listing updated:** 2026-11-20

## About

The OptionWhales MCP server lets ChatGPT, Claude and coding agents pull US options market data into a conversation. Requests can cover unusual options activity, gamma exposure (GEX) levels, implied volatility, earnings dates and general stock market context, all drawn from the same data the OptionWhales dashboard uses.

The server is a remote endpoint reached over streamable HTTP. Users connect with OAuth sign-in in clients that support it, or send an API key in a header for clients that do not. The website's example shows an assistant choosing which tools to call for a question such as SPY gamma levels, then returning the numbers with their snapshot timestamps.

It suits traders and analysts who already work with an AI assistant and want options data in that workflow, as well as developers who want REST or WebSocket access alongside MCP. The product is positioned as market-data research software; it does not place trades, and its own materials describe the outputs as informational rather than investment advice.

## Features

- **Options flow retrieval:** Assistants can fetch unusual options activity and flow data for US equities.
- **Gamma exposure levels:** Returns GEX snapshots such as gamma flip, call wall and put wall for supported tickers.
- **Volatility and earnings data:** Covers implied volatility and earnings information alongside market context.
- **OAuth or API key access:** Sign in through OAuth in supported clients, or pass an API key in a request header.
- **Dashboard-matched data:** The site states MCP answers use the same underlying data as the OptionWhales dashboard.
- **Free key registration:** A compatible assistant can register a free key, which is kept active after email confirmation.

## Good for

- Asking an AI assistant for SPY or QQQ gamma levels before reviewing a dashboard
- Pulling unusual options activity for a watchlist of tickers during market research
- Checking implied volatility and upcoming earnings while drafting a market note
- Connecting options data to a coding agent that builds internal research tools

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http options-flow https://api.optionwhales.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.optionwhales.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "options-flow": {
      "url": "https://api.optionwhales.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "options-flow": {
      "type": "http",
      "url": "https://api.optionwhales.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "options-flow": {
      "serverUrl": "https://api.optionwhales.io/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://api.optionwhales.io/mcp
```

Enter a Name (for example "OptionWhales"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "options-flow": {
      "type": "http",
      "url": "https://api.optionwhales.io/mcp"
    }
  }
}
```

## FAQ

### Does OptionWhales place trades?

No. The site describes OptionWhales as market-data research software that does not execute trades.

### How do I connect OptionWhales to Claude Code?

Run claude mcp add --transport http optionwhales https://api.optionwhales.io/mcp/connect as shown on the site.

### How much does the Pro plan cost?

The pricing page lists Pro at $19 per month, billed monthly via Stripe or PayPal.

### Is there a free plan?

Yes. The Free plan offers limited access, including a market-wide flow view, an SPY and QQQ GEX panel and limited API access.

### How do I add OptionWhales to Claude Code?

Run this command in your terminal: claude mcp add --transport http options-flow https://api.optionwhales.io/mcp

### What are the best alternatives to OptionWhales?

The closest alternatives to OptionWhales are OpticAlpha Data, Alpha Vantage MCP, TGMCharts, Finance: Stock, ETF & Crypto Data and FinanceQuery.

## Where this comes from

- Description: written from the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [OpticAlpha Data](https://ai-powered.com/mcp/opticalpha-data): OpticAlpha Data is a free MCP server for financial data.
- [Alpha Vantage MCP](https://ai-powered.com/mcp/alpha-vantage-mcp): Alpha Vantage MCP is a freemium MCP server for finance and payments.
- [TGMCharts](https://ai-powered.com/mcp/tgmcharts): TGMCharts is a freemium MCP server for finance and payments.
- [Finance: Stock, ETF & Crypto Data](https://ai-powered.com/mcp/finance-stock-etf-and-crypto-data): Finance: Stock, ETF & Crypto Data is a paid MCP server for finance and payments.
- [FinanceQuery](https://ai-powered.com/mcp/financequery): FinanceQuery is an open-source MCP server for finance and payments.
- [Quantdata](https://ai-powered.com/mcp/quantdata): Quantdata is a freemium MCP server for trading analysis.
- [Market Pi-Rates](https://ai-powered.com/mcp/market-pi-rates): Market Pi-Rates is a freemium MCP server for finance and payments.
- [Ko MCP](https://ai-powered.com/mcp/ko-mcp): Ko MCP is a freemium MCP server for financial data.

---
Source: https://ai-powered.com/mcp/optionwhales
