Skip to content
OptionsBell logo

OptionsBell MCP server

Which servers in the official MCP registry are OptionsBell's own, whether they answer, and what they offer. A program checked each of these, nobody copied them from a product page.

read 2026-10-20

← Back to OptionsBell

Whose server it is
  • Registry namecom.optionsbell/options-flowverified in the MCP registry

The registry name sits under optionsbell.com. The registry only lets a publisher use that namespace after proving control of the domain through DNS or HTTP.

When we asked itchecked 2026-10-20
  • Stateanswerschecked 2026-10-20
  • Tools13
  • Server calls itselfoptionsbell
  • Server version2.0.0
  • Protocol version2025-06-18

On 2026-10-20 the server answered initialize and tools/list without a sign-in. First answer in 217 ms.

Should an agent connect itNot proven either way yet
  • Whether its tools do the product's job has not been judged yet.
  • Checked on 2 of the 7 days it takes to judge reliability.

Once connected

  • For "filter unusual options trades by ticker, premium and volume", the likely first call is get_unusual_activity.
  • Parameters are untyped or undescribed in 6 of 13 tools: check arguments before calling.

Said by rules from the measurements above. The likely first call is a model's pick from the tool list; read its description before relying on it.

Measured dailydaily checks: 2, the first on 2026-10-20
  • INITE MCP scoreafter a weeka score needs 7 daily checks: 2 so far
  • Answeredmeasuring2 of the 7 daily checks it takes to print a share
  • Median first answer239 ms
  • Space in an agent's context≈ 3,240 tokensthe definitions of all its tools (13), which an agent carries on every turn
  • Tool definitionsB · 76 of 100
  • Typed results0 of 13 toolsdeclared outputSchema: results come typed, read once
  • Parameters without a description: in 6 of 13
  • Not saying whether it only reads or can destroy: 13 of 13

What an agent can do with it

  • not sure · get email alerts when large options bets hit your stocks
  • can do · filter unusual options trades by ticker, premium and volume
  • not sure · pull options flow signals into your own tools through an API

Each of the product's use cases, put to Jev against this server's tool list: can an agent do it with these tools?

Worth a look

None of the five warning signs in these definitions.

A program checks the server once a day: initialize and tools/list, no model. Tokens are the definitions' length at about four characters a token. The grade averages six checks of every tool's name, description, schema and annotations; it says how well the tools are described, not whether they work. The score weighs what was measured and nothing else: answering (30%), doing the product's job (25%), definitions (20%), context (10%) and use (15%). A part that was not measured is left out, and a hidden instruction caps the score at 40. The state of vendors' MCP servers: method and numbers →

Tools it offers13 tools · read 2026-10-20
  • ping

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

  • get_dataset_stats

    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.

  • get_unusual_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…

  • get_symbol_flow

    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.

  • get_top_prints

    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?'

  • get_flow_history

    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…

  • get_flow_streaks

    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?'

  • get_expiry_concentration

    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.

  • get_flow_sentiment

    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…

  • get_iv_rank

    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…

  • get_oi_changes

    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.

  • get_sector_flow

    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…

  • get_market_regime

    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?'

How to connect

Add the server to your MCP client config. Claude Desktop, Cursor and most other clients read this shape:

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

Add it

Claude Code, in a terminal

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

Add to CursorAdd to VS Code

claude.ai, ChatGPT and other clients: add https://optionsbell.com/mcp as a custom connector in the settings.

OpenAPI spec

22 paths, read 2026-10-20. Open the spec ↗

Each line is something a program found when it went looking: the registry entry, the server's own answer, a spec that parses. A missing line means we did not find it, not that it does not exist.