OptionsBell Options Flow
Unusual options activity on 7,000+ US stocks: top prints, streaks, IV rank, sentiment, sectors.
Open source Repository Open in the app JSON README (API)
About
Unusual options activity on 7,000+ US stocks: top prints, streaks, IV rank, sentiment, sectors.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- com.optionsbell
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 2.0.0
- Last push
- 2026-07-03T17:33:07Z
- Repository state
- ativo
- License
- NOASSERTION
- Added
- 2026-08-29 03:01:18
- Updated
- 2026-08-29 03:01:18
- Origin id
com.optionsbell/options-flow
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.
- **Endpoint:** `https://optionsbell.com/mcp` (Streamable HTTP)
- **Registry name:** `com.optionsbell/options-flow`
- **Website:** [optionsbell.com](https://optionsbell.com)
- **Setup guide:** [optionsbell.com/docs/mcp](https://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](https://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](https://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](https://optionsbell.com/docs) · [openapi.yaml](https://optionsbell.com/openapi.yaml) · [llms.txt](https://optionsbell.com/llms.txt)
- Contact: contact@optionsbell.com