OptionsBell Options Flow

com.optionsbellPublished by optionsbell.comOfficial publisherv2.0.0Updated Oct 24, 2026

Unusual options activity on 7,000+ US stocks: top prints, streaks, IV rank, sentiment, sectors.

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

Remote MCP server for querying unusual options activity on 7,000+ US stocks: top prints, streaks, IV rank, sentiment and sector flow.

What you can do
  • Scan contract-level unusual options activity with filters for symbols, side, Vol/OI, premium, IV, DTE, volume and open interest
  • Drill into one ticker's unusual contracts, its end-of-day flow history and consecutive-day streaks
  • Rank the day's biggest prints by estimated premium and see where premium sits along the expiry axis
  • Get bullish/bearish sentiment scores, IV rank and percentile, and day-over-day open-interest changes
  • View sector concentration of unusual premium and a market-wide breadth and regime label
  • Check dataset coverage and date ranges, plus a liveness ping
When to use it
Useful when you want an assistant to answer questions about unusual US options flow — large prints, persistent multi-day activity, IV rank screens, sector concentration or overall tape tone — without building your own data pipeline.
Requirements
A remote Streamable HTTP endpoint at optionsbell.com; no local package. An active OptionsBell subscription and an API key sent as the X-API-Key header (or a personal connector URL from Settings, which avoids handling the key). Anonymous connections can list tools but calls need credentials; usage counts against API rate limits.
Before you install
Requires a paid subscription and an API key or personal connector URL, which should be kept out of shared configs. Tool calls consume your API rate limits. Data covers only contracts that passed the unusual filter, not the full options tape, premium figures are estimates, and output is market data rather than investment advice.

Installation

In SourceWeft

  1. Open OptionsBell Options Flow in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.optionsbell%2Foptions-flow/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "optionsbell-options-flow": {
      "type": "http",
      "url": "https://optionsbell.com/mcp"
    }
  }
}

README

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.

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)

ToolDescription
get_unusual_activityContract-level unusual activity scan with full filters
get_symbol_flowEvery unusual contract on a single ticker
get_top_printsThe day's biggest bets, ranked by premium
get_flow_historyPer-symbol EOD unusual-flow series for back-tests
get_flow_streaksSymbols with N+ consecutive days of unusual flow
get_expiry_concentrationPremium along the DTE axis (event bets vs. positioning)
get_flow_sentimentBullish/bearish classification with 0-9 strength
get_iv_rankIV rank & percentile vs. rolling history
get_oi_changesDay-over-day open-interest gainers/losers
get_sector_flowWhich sectors the unusual premium concentrates in
get_market_regimeUnusual-flow breadth score & regime label per day
get_dataset_statsAvailable date ranges & coverage discovery
pingLiveness 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

Source: README.md at commit 4e59eca

Tools

13

ping

Ping

Liveness check for the OptionsBell MCP server. No API key required.

Takes no parameters.

get_dataset_stats

Dataset coverage

Discover what data is available before querying: date ranges, contract counts, symbol counts and sector coverage for the unusual-activity dataset and its daily aggregates. Call this first when unsure about available history.

Takes no parameters.

get_unusual_activity

Unusual options activity

Contract-level unusual options activity scan across 7,000+ US stocks (the dataset behind OptionsBell alerts). Filter by symbols, side and thresholds: Vol/OI ratio, premium (USD), IV, days-to-expiration, volume, open interest. Rows include strike, expiry, volume, open interest, IV, delta, sector and an estimated premium. Use for questions like 'what unusual put buying hit TSLA today?'

Parametersrawdatetypelimitsincemin_ivmin_oioffsetdate_tomax_dtesymbolsdate_from+3 more

get_symbol_flow

Per-symbol unusual activity

Every unusual contract on a single ticker, ranked by score (Vol/OI weighted by premium). Use when the question is about one specific stock's unusual options flow.

Parametersdatetypelimitsymbolrequireddate_todate_frommin_voloimin_premium

get_top_prints

Top prints of the day

The day's biggest options bets ranked by estimated premium - the same view OptionsBell alert emails lead with. Perfect for 'what were the largest options trades today?'

Parametersdatetypelimitoffsetsymbolsmin_premium

get_flow_history

Per-symbol unusual-flow history (Pro)

End-of-day series of one symbol's UNUSUAL options flow (aggregated from the contracts that passed the unusual filter - not the full tape): daily call/put volume, premium, C/P ratios, average IV, net delta and the consecutive-day streak. ~75 trading days - the series behind back-tests and 'how has unusual flow on NVDA developed?'

Parameterslimitsymbolrequireddate_todate_from

get_flow_streaks

Multi-day unusual-flow streaks (Pro)

Symbols with unusual options activity on N+ consecutive trading days, with the dominant side (call/put). Persistent unusual flow is a stronger signal than a single print - use for 'where does money keep showing up?'

Parametersdatesidelimitoffsetsymbolsmin_streakmin_volume

get_expiry_concentration

Expiry (DTE) concentration (Pro)

Where the day's unusual premium sits along the expiry axis, in DTE buckets (0-7, 8-30, 31-90, 90+) with call/put splits. Heavy short-dated premium reads as event bets; heavy long-dated as positioning.

Parametersdatesymbols

get_flow_sentiment

Flow sentiment (Pro)

Bullish/bearish classification of each symbol's unusual flow with a 0-9 strength score, based on call/put volumes, premium and net delta. Pass a symbol for that ticker's sentiment time series (date_from, date_to, limit apply); omit it for the cross-market snapshot (filterable by sector, side, minimum strength or premium).

Parametersdatesidelimitoffsetsectorsymboldate_tosymbolsdate_frommin_premiumsignal_onlymin_strength

get_iv_rank

IV rank (Pro)

IV rank and IV percentile per symbol against its rolling history (needs 20+ days). Pass a symbol for its IV-rank time series (lookback_days, limit apply); omit it for a ranked snapshot (e.g. side=put&min_rank=0.8 finds elevated put IV; side=both ranks by the higher of call/put IV rank).

Parameterssidelimitsymbolmax_rankmin_ranklookback_days

get_oi_changes

Open-interest changes (Pro)

Day-over-day open-interest change per symbol (total, calls, puts) - fresh positioning being built or unwound. Pass a symbol for its OI-change series (date_from, date_to, limit apply); omit it for market-wide gainers/losers.

Parametersdatesidelimitoffsetsymboldate_tosymbolsdate_frommin_prev_oimin_change_pct

get_sector_flow

Sector unusual-flow rollup (Pro)

Which sectors the day's unusual options premium is concentrating in: total premium, volume, average net delta and bullish/bearish symbol counts per sector label (11 GICS sectors plus Diversified, Unknown and Unclassified; only labels with activity, at most 14 rows).

Parametersdatelimit

get_market_regime

Market breadth & regime (Pro)

Market-wide breadth of unusual flow per trading day: breadth score 0-100, aggregate call/put ratio, regime label (bullish/bearish/mixed) and signal counts. Use for 'what's the overall tone of the unusual-flow tape?'

Parametersdatelimitdate_todate_from

Version history

1
  1. v2.0.0LatestSep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.