com.optionsbell/options-flow MCP Server

The com.optionsbell/options-flow Model Context Protocol (MCP) server provides an interface for querying unusual options activity across 7,000+ US-listed stocks. It rescans the full US options tape every 5 minutes and exposes “unusual prints” plus analytics derived from them, including top prints, streaks, IV rank, sentiment, and sectors.

🛠️ Key Features

Unusual options activity on 7,000+ US stocks
Unusual print “top prints” outputs
Streaks analytics
IV rank analytics
Sentiment analytics
Sector-based categorization

🚀 Use Cases

Investigating unusual trading patterns on US options markets
Reviewing IV rank and sentiment signals tied to unusual prints
Filtering or aggregating results by sectors

⚡ Developer Benefits

Remote access via Streamable HTTP endpoint: https://optionsbell.com/mcp
Registry name for MCP clients: com.optionsbell/options-flow
Documented setup guide: https://optionsbell.com/docs/mcp
Known tool set size: 13 tools

⚠️ Limitations

Scope limited to unusual options activity from the US options tape
Data updates occur on a 5-minute rescan cycle

OptionsBell MCP Server

Ask Claude (or any MCP client) about unusual options activity on 7,000+ US-listed stocks. The whole US options tape is rescanned every 5 minutes; this server exposes the unusual prints and the analytics derived from them.

Endpoint: https://optionsbell.com/mcp (Streamable HTTP)
Registry name: com.optionsbell/options-flow
Website: optionsbell.com
Setup guide: optionsbell.com/docs/mcp

This repository hosts the registry manifest and documentation for the hosted (remote) server. The server itself runs at optionsbell.com.

What you can ask

"What unusual put buying hit TSLA today?"
"Where has unusual flow shown up for 10+ consecutive days?"
"Which sectors is premium concentrating in this week?"
"Show me stocks with put IV rank above 0.8 - and pull the biggest prints on each."

Tools (13)

Tool	Description
`get_unusual_activity`	Contract-level unusual activity scan with full filters
`get_symbol_flow`	Every unusual contract on a single ticker
`get_top_prints`	The day's biggest bets, ranked by premium
`get_flow_history`	Per-symbol EOD unusual-flow series for back-tests
`get_flow_streaks`	Symbols with N+ consecutive days of unusual flow
`get_expiry_concentration`	Premium along the DTE axis (event bets vs. positioning)
`get_flow_sentiment`	Bullish/bearish classification with 0-9 strength
`get_iv_rank`	IV rank & percentile vs. rolling history
`get_oi_changes`	Day-over-day open-interest gainers/losers
`get_sector_flow`	Which sectors the unusual premium concentrates in
`get_market_regime`	Unusual-flow breadth score & regime label per day
`get_dataset_stats`	Available date ranges & coverage discovery
`ping`	Liveness check, no key required

Authentication (BYOK)

Connect with your own OptionsBell API key - generated at optionsbell.com/settings (active subscription required):

X-API-Key: sms_... header, or Authorization: Bearer sms_...
Recommended: a personal connector URL (https://optionsbell.com/u/mct_xxx/mcp) generated in Settings - named, revocable, no key handling in client configs.

Anonymous connections can list tools; calls return a friendly hint. Tool calls count 1:1 against your API rate limits (Pro: 30/min, 2,000/day).

Quick connect

Claude Code:

bash

claude mcp add --transport http optionsbell https://optionsbell.com/u/mct_xxx/mcp

Claude Desktop (claude_desktop_config.json):

json

{
  "mcpServers": {
    "optionsbell": {
      "url": "https://optionsbell.com/u/mct_xxx/mcp"
    }
  }
}

claude.ai (web): Settings → Connectors → Add custom connector → paste your connector URL.

Full walkthrough: optionsbell.com/docs/mcp

Data notes

Coverage is unusual activity only - contracts that passed the unusual filter, not the full options tape. Derived analytics are aggregated from those prints (~75 trading days of history).
Premium values are estimates (last_price × volume × 100).
Market data, not investment advice.

Support

Docs: optionsbell.com/docs · openapi.yaml · llms.txt
Contact: contact@optionsbell.com

symbols	string	optional	Comma-separated tickers, e.g. 'AAPL,NVDA,TSLA'.
type	string	optional	Side: c = calls, p = puts (default all).
min_voloi	number	optional	Minimum volume/open-interest ratio, e.g. 5.
min_premium	number	optional	Minimum estimated premium in USD, e.g. 250000.
min_iv	number	optional	Minimum implied volatility in percent, e.g. 60.
max_dte	integer	optional	Maximum days to expiration, e.g. 30.
date	string	optional	Trading day, YYYY-MM-DD. Defaults to the latest available day.
date_from	string	optional	Range start, YYYY-MM-DD inclusive.
date_to	string	optional	Range end, YYYY-MM-DD inclusive.
limit	integer	optional	Max rows (default 300).

symbol	string	required	Single ticker, e.g. 'TSLA'.
type	string	optional
min_voloi	number	optional
min_premium	number	optional
date	string	optional	Trading day, YYYY-MM-DD. Defaults to the latest available day.
date_from	string	optional	Range start, YYYY-MM-DD inclusive.
date_to	string	optional	Range end, YYYY-MM-DD inclusive.
limit	integer	optional

date	string	optional	Trading day, YYYY-MM-DD. Defaults to the latest available day.
type	string	optional
symbols	string	optional	Comma-separated tickers, e.g. 'AAPL,NVDA,TSLA'.
min_premium	number	optional	Minimum premium in USD (default 25000).
limit	integer	optional	Max rows (default 20).

symbol	string	required	Single ticker, e.g. 'TSLA'.
date_from	string	optional	Range start, YYYY-MM-DD inclusive.
date_to	string	optional	Range end, YYYY-MM-DD inclusive.
limit	integer	optional	Max rows, newest first (default 90).

min_streak	integer	optional	Minimum consecutive days (default 3).
side	string	optional	Dominant side by C/P volume ratio.
symbols	string	optional	Comma-separated tickers, e.g. 'AAPL,NVDA,TSLA'.
date	string	optional	Trading day, YYYY-MM-DD. Defaults to the latest available day.
min_volume	number	optional
limit	integer	optional

OptionsBell Options Flow

com.optionsbell/options-flow MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

ping

get_dataset_stats

get_unusual_activity

get_symbol_flow

get_top_prints

get_flow_history

get_flow_streaks

get_expiry_concentration

get_flow_sentiment

get_iv_rank

get_oi_changes

get_sector_flow

get_market_regime

OptionsBell MCP Server

What you can ask

Tools (13)

Authentication (BYOK)

Quick connect

Data notes

Support

Install

Remote endpoint

Related servers