English Français العربية

OptionsBell Options Flow

Official registry Finance and payments

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

Source code Website Documentation

What can you do with OptionsBell Options Flow?

  • "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."

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http optionsbell-options-flow 'https://optionsbell.com/mcp' --header 'X-API-Key: <Your OptionsBell API key (sms_...). Generate at https://optionsbell.com/settings - requires an active subscription. Alternatively connect via a personal connector URL from Settings, which needs no header at all.>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "optionsbell-options-flow": {
            "type": "http",
            "url": "https://optionsbell.com/mcp",
            "headers": {
                "X-API-Key": "<Your OptionsBell API key (sms_...). Generate at https://optionsbell.com/settings - requires an active subscription. Alternatively connect via a personal connector URL from Settings, which needs no header at all.>"
            }
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. OptionsBell MCP Server
  2. What you can ask
  3. Tools (13)
  4. Authentication (BYOK)
  5. Quick connect
  6. Data notes
  7. Support

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:

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

Claude Desktop (claude_desktop_config.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

Frequently asked questions

What is OptionsBell Options Flow?

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

How do I install OptionsBell Options Flow?

It runs as a remote server. In Claude Code: claude mcp add --transport http optionsbell-options-flow 'https://optionsbell.com/mcp' --header 'X-API-Key: <Your OptionsBell API key (sms_...). Generate at https://optionsbell.com/settings - requires an active subscription. Alternatively connect via a personal connector URL from Settings, which needs no header at all.>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does OptionsBell Options Flow need an API key?

Yes. It expects X-API-Key, which you set in its configuration.

Is OptionsBell Options Flow open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains OptionsBell Options Flow?

It is published by stockmarketscan. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.