OptionsBell Options Flow

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:

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

• Docs: optionsbell.com/docs · openapi.yaml · llms.txt
• Contact: [email protected]