OptionClaws

npx add-mcp 'https://api.optionclaws.com/optionclaws/mcp'

An options scanner your AI assistant can call

OptionClaws runs a remote MCP (Model Context Protocol) server. Connect it once and your assistant can pull today's Top Trades, run curated preset and custom scans across covered calls, cash-secured puts, the wheel, credit spreads, iron condors, LEAPS and every other supported strategy, run custom multi-leg scans, check a ticker's IV rank, option chain and volatility reaction, price an exact position or a roll, find the best trade for your price target, and read or update your trade journal. Nothing places a trade; the only changes it can make are to your own saved scans, watchlists and journal, and journal changes only after you confirm.

MCP server URL

https://api.optionclaws.com/optionclaws/mcp

Claude

1. 1Open OptionClaws in Claude's connector directory.
2. 2Click Connect, then sign in to OptionClaws when prompted.
3. 3Ask for a scan, or mention OptionClaws by name in any chat. Add to Claude

Team and Enterprise owners turn on connectors from organization settings. Not in your directory? Under Settings, Connectors, add a connector by URL with the MCP server URL above.

ChatGPT

1. 1Open OptionClaws in ChatGPT.
2. 2Add the plugin and sign in to OptionClaws when prompted.
3. 3Ask for a scan, mention OptionClaws by name in any chat, or open the OptionClaws Scanner from ChatGPT's sidebar. Add to ChatGPT

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

1. 1Go to grok.com/connectors.
2. 2Choose New Connector, then Custom.
3. 3Paste the MCP server URL above, save, and sign in to OptionClaws when prompted.

Try asking

“What are the best cash-secured puts this week?”

“Find me high-probability iron condors on large caps with a max loss under $500”

“I think NVDA hits $210 by December. What's the best options trade?”

“Should I roll my AAPL 190 covered call out a month?”

“Find LEAPS calls on MSFT that could replace owning the shares”

“Log my trade: sold 1 SPY 560 put expiring Nov 21 for 3.10, then show my win rate this month”

Tools

All tools are read-only except saving, editing, and deleting your own saved scans and watchlists, journal changes you confirm, and sending feedback you approve. None of them place, modify, or cancel a real 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 the curated preset scans: cash-secured puts, the wheel, covered calls, iron condors, Fresh Money Flow, LEAPS Stock Replacement, SPY 0DTE and more.
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 IV rank, option chain (bid/ask, IV and greeks per contract), stock stats, and how its IV reacts to price moves.
run_scan_v2	Run a preset, saved or custom scan and page through the ranked results (up to rank 500), with per-leg greeks; long calls and puts can reach LEAPS out to about three years.
run_custom_scan	Find trades for a position built leg by leg (up to 4 legs: calls, puts and shares), with strikes by delta, distance from the stock price or width, on one of your watchlists or a short symbol list; saved custom scans rerun here.
optimize_trade	Rank options positions on one stock for a price target (or a bullish, bearish or neutral view) by a date, from maximum return to maximum chance of profit.
analyze_position	The strategy builder for AI: price an exact position or a roll leg by leg on one stock (up to 8 legs): cost, max profit and loss, breakevens, chance of profit, margin, greeks, a P&L table and a what-if, plus a link to open it in the strategy builder.
get_vol_reaction	See how a stock's implied volatility has been reacting to its price moves, versus its own usual pattern, and whether it broke that pattern today or recently.
find_vol_reaction_breaks	Find stocks and ETFs whose IV broke its usual reaction to the price move (IV up on a rally, IV ignoring a selloff, and more), market-wide or on the watchlist.
create_saved_scan	Save a preset or custom scan to the caller's account (up to 10 saved scans).
update_saved_scan	Edit one of the caller's saved scans in place (rename it, change its filters or sort, or remove filters); the scan keeps its id.
delete_saved_scan	Delete one of the caller's saved scans.
list_universes	List what the caller can scan: their watchlists and the index member lists.
get_top_trades	Get today's Top Trades, a short list of the best income trades across the curated presets, or the best trades for one symbol (or the reason none pass).
get_watchlist	Get one of the user's watchlists (My watchlist by default) and the list of all of them, shared with the website and the app.
add_to_watchlist	Add tickers to one of the user's watchlists when the user asks.
remove_from_watchlist	Remove tickers from one of the user's watchlists when the user asks.
create_watchlist	Create a watchlist in the user's account (up to 20 watchlists of 200 tickers).
update_watchlist	Rename one of the user's watchlists.
delete_watchlist	Delete one of the user's watchlists (My watchlist can't be deleted).
preview_journal_change	Preview a change to the caller's trade journal (log, close, roll, settle, edit, or a practice order; covered calls on shares already held can be logged as just the calls); nothing is saved until confirmed.
confirm_journal_change	Apply a previewed journal change after the user explicitly says yes.
list_journal_trades	List the caller's journal trades, including ones imported from a broker, with realized and open P&L.
get_journal_trade	Get one journal trade in full, with its change history.
get_journal_stats	Get journal stats: win rate, P&L, expectancy, equity curve (more on paid plans).
get_journal_portfolio	Get open journal positions as a portfolio: net greeks, exposure, estimated margin (paid plans).
review_journal	Get an AI review of the caller's journal: what worked, what lost money, what to reconsider (paid plans).
revert_journal_change	Undo one journal change by its event id.
list_journal_accounts	List the caller's journal accounts and playbooks, with the ids the other journal tools filter by.
list_paper_orders	List the caller's practice (paper) orders: working limit orders and filled, canceled or expired ones.
cancel_paper_order	Cancel one of the caller's working practice orders.
open_scanner	ChatGPT only: open the OptionClaws Scanner full screen from ChatGPT's sidebar, pick a curated idea, a saved scan or a strategy, and adjust filters.
open_trade_board	ChatGPT only: open the Trade Board beside a chat, run a curated idea or saved scan, and add trades to the conversation.
send_feedback	Send the user's bug report, feature request, or support question to the OptionClaws team, after the user confirms it.

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/mcp

Then run /mcp inside Claude Code to sign in.

Signing in requires an OptionClaws account. Start free, no card required. Every plan then starts with a 7-day free trial. Pick a plan and add a card: $0 today, cancel anytime. See pricing →