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:

Terminal

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

Claude Desktop (claude_desktop_config.json):

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: contact@optionsbell.com