Skip to content
MCP server

OptionWhales

MCP server giving AI assistants options flow, gamma exposure and IV data for research

Install

OptionWhales is a freemium MCP server for stock market data. It runs as a hosted remote server, so there is nothing to install locally.

Pricing
Freemium
Platforms
API, Web
Runs
Remotely
Version
1.4.0
Listing updated

Similar MCP servers

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://api.optionwhales.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "options-flow": {
      "url": "https://api.optionwhales.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to Grok Bot desktop app → Connect apps → Add a custom connector

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.

Full Grok Bot setup guide

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

About OptionWhales

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.

What it does

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

Pricing

Freemium, from $19 a month

Free plan with limited access; Pro at $19/month for full tool access and API allowance

Prices change. Check optionwhales.io before you buy.

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

How AIPoweredBot checks servers