{
  "markdown": "# OptionsBell MCP Server\n\nAsk Claude (or any MCP client) about **unusual options activity** on 7,000+\nUS-listed stocks. The whole US options tape is rescanned every 5 minutes;\nthis server exposes the unusual prints and the analytics derived from them.\n\n- **Endpoint:** `https://optionsbell.com/mcp` (Streamable HTTP)\n- **Registry name:** `com.optionsbell/options-flow`\n- **Website:** [optionsbell.com](https://optionsbell.com)\n- **Setup guide:** [optionsbell.com/docs/mcp](https://optionsbell.com/docs/mcp)\n\n> This repository hosts the registry manifest and documentation for the\n> hosted (remote) server. The server itself runs at optionsbell.com.\n\n## What you can ask\n\n- \"What unusual put buying hit TSLA today?\"\n- \"Where has unusual flow shown up for 10+ consecutive days?\"\n- \"Which sectors is premium concentrating in this week?\"\n- \"Show me stocks with put IV rank above 0.8 - and pull the biggest prints on each.\"\n\n## Tools (13)\n\n| Tool | Description |\n|---|---|\n| `get_unusual_activity` | Contract-level unusual activity scan with full filters |\n| `get_symbol_flow` | Every unusual contract on a single ticker |\n| `get_top_prints` | The day's biggest bets, ranked by premium |\n| `get_flow_history` | Per-symbol EOD unusual-flow series for back-tests |\n| `get_flow_streaks` | Symbols with N+ consecutive days of unusual flow |\n| `get_expiry_concentration` | Premium along the DTE axis (event bets vs. positioning) |\n| `get_flow_sentiment` | Bullish/bearish classification with 0-9 strength |\n| `get_iv_rank` | IV rank & percentile vs. rolling history |\n| `get_oi_changes` | Day-over-day open-interest gainers/losers |\n| `get_sector_flow` | Which sectors the unusual premium concentrates in |\n| `get_market_regime` | Unusual-flow breadth score & regime label per day |\n| `get_dataset_stats` | Available date ranges & coverage discovery |\n| `ping` | Liveness check, no key required |\n\n## Authentication (BYOK)\n\nConnect with your own OptionsBell API key - generated at\n[optionsbell.com/settings](https://optionsbell.com/settings) (active\nsubscription required):\n\n- `X-API-Key: sms_...` header, or `Authorization: Bearer sms_...`\n- **Recommended:** a personal connector URL\n  (`https://optionsbell.com/u/mct_xxx/mcp`) generated in Settings - named,\n  revocable, no key handling in client configs.\n\nAnonymous connections can list tools; calls return a friendly hint.\nTool calls count 1:1 against your API rate limits (Pro: 30/min, 2,000/day).\n\n## Quick connect\n\n**Claude Code:**\n\n```bash\nclaude mcp add --transport http optionsbell https://optionsbell.com/u/mct_xxx/mcp\n```\n\n**Claude Desktop** (`claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"optionsbell\": {\n      \"url\": \"https://optionsbell.com/u/mct_xxx/mcp\"\n    }\n  }\n}\n```\n\n**claude.ai (web):** Settings → Connectors → Add custom connector → paste\nyour connector URL.\n\nFull walkthrough: [optionsbell.com/docs/mcp](https://optionsbell.com/docs/mcp)\n\n## Data notes\n\n- Coverage is **unusual activity only** - contracts that passed the unusual\n  filter, not the full options tape. Derived analytics are aggregated from\n  those prints (~75 trading days of history).\n- Premium values are estimates (`last_price × volume × 100`).\n- Market data, not investment advice.\n\n## Support\n\n- Docs: [optionsbell.com/docs](https://optionsbell.com/docs) · [openapi.yaml](https://optionsbell.com/openapi.yaml) · [llms.txt](https://optionsbell.com/llms.txt)\n- Contact: contact@optionsbell.com\n",
  "bytes": 3444,
  "sha": "52f0276f2d4439dfc42dcf81f12970f2d80c38099b6e7071913dade6ea3b76ad",
  "repo_slug": "stockmarketscan/optionsbell-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_optionsbell_options_flow_6f521b2b/readme"
}