An options scanner your AI assistant can call
OptionClaws runs a remote MCP (Model Context Protocol) server. Connect it once and your assistant can search optionable symbols, run curated preset scans, and run custom scans across covered calls, cash-secured puts, credit spreads, iron condors, and every other supported strategy, returning ranked candidates in the chat. Every tool is read-only; nothing places a trade.
MCP server URL
https://api.optionclaws.com/optionclaws/mcpClaude
- 1Open Settings, then Connectors.
- 2Choose Add custom connector.
- 3Paste the MCP server URL above and click Add. Sign in to OptionClaws when prompted.
Available on Free (one custom connector), Pro, Max, Team, and Enterprise. Team and Enterprise owners add connectors from organization settings.
ChatGPT
- 1Open OptionClaws in ChatGPT.
- 2Add the plugin and sign in to OptionClaws when prompted.
- 3Ask for a scan, or mention OptionClaws by name in any chat.
Prefer a custom connector? Turn on Developer mode under Settings, Apps & Connectors, Advanced settings, then create a connector with the MCP server URL above and OAuth (Plus, Pro, Team, Enterprise, and Edu).
Grok
- 1Go to grok.com/connectors.
- 2Choose New Connector, then Custom.
- 3Paste the MCP server URL above, save, and sign in to OptionClaws when prompted.
Try asking
“Find me high-probability iron condors on large caps with a max loss under $500”
“Scan for weekly covered calls on my watchlist with annualized return over 20%”
“What cash-secured puts on blue chips expire in 30-45 days with PoP above 80%?”
Tools
All 10 tools are read-only. None of them place, modify, or cancel a trade.
| Tool | What it does |
|---|---|
| get_account_status | Check the caller's subscription or trial status. |
| describe_scan_filters | List available strategies, filters, sort keys, and universes. |
| list_presets | List curated preset scans (e.g. high-probability cash-secured puts). |
| run_preset_scan | Run a named preset scan and return the top-N results. |
| run_scan | Run a custom scan definition (strategy, filters, sort) and return the top-N results. |
| list_saved_scans | List the caller's saved scans. |
| run_saved_scan | Re-run one of the caller's saved scans and return the top-N results. |
| search_symbols | Look up optionable symbols by ticker or company name. |
| get_symbol_details | Get a symbol's stock stats, IV rank, and an option chain with bid/ask, IV, and greeks. |
| run_scan_v2 | Run a preset, saved or custom scan and page through the ranked results (up to rank 500), with per-leg greeks. |
Your assistant signs in to your OptionClaws account with OAuth 2.1 (authorization code with PKCE); no API key is pasted into the assistant. Scans run on OptionClaws servers and only the ranked results are returned.
Auth & discovery
- OAuth 2.1 authorization code flow with PKCE (S256).
- Single scope:
mcp. - Dynamic Client Registration and Client ID Metadata Documents are both supported.
- Authorization server metadata: https://api.optionclaws.com/.well-known/oauth-authorization-server
- Protected resource metadata: https://api.optionclaws.com/.well-known/oauth-protected-resource/optionclaws/mcp
Limits
- Data is refreshed intraday.
- Scans require an active trial or subscription.
- Rate limited to 10 scans per minute.
- Results are top-N (default 15, max 200), and run_scan_v2 pages through the rest.
Claude Code
claude mcp add --transport http optionclaws https://api.optionclaws.com/optionclaws/mcpThen run /mcp inside Claude Code to sign in.
Signing in requires an OptionClaws account, and running scans requires an active trial or subscription. New accounts start with a 7-day trial, no card required. See pricing →