# OptionsBell Options Flow

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/stockmarketscan/optionsbell-mcp  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/optionsbell-options-flow

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

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "optionsbell-options-flow": {
    "command": "npx",
    "args": ["-y","optionsbell-options-flow"]
  }
}
```

## Documentation & 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