MCP Tool Reference

27 tools available via the Remora MCP server. All tools return filtered analysis, not financial advice. All read tools include staleness timestamps showing when data was last retrieved.

Premium Selling (Sell Side)
screen_csp
Screen for cash-secured puts (CSPs). Finds put options to sell for premium income. Shows filter rejection summaries when results are empty.
ParameterTypeDefaultDescription
tickers requiredstring[]Ticker symbols to screen
min_dteint20Minimum days to expiration
max_dteint60Maximum days to expiration
min_deltafloat0.15Minimum delta (0-1)
max_deltafloat0.40Maximum delta (0-1)
min_yieldfloatMinimum annual yield %
min_open_interestintMinimum open interest
max_bid_ask_spread_pctfloatMaximum bid-ask spread %
topint25Max results to return
"Find me CSPs on AAPL and NVDA with delta 0.20-0.35, at least 30 DTE, yielding 10%+"
screen_cc
Screen for covered calls (CCs). Finds call options to sell against held shares. Shows filter rejection summaries when results are empty.
ParameterTypeDefaultDescription
tickers requiredstring[]Ticker symbols to screen
min_dteint20Min DTE
max_dteint60Max DTE
min_deltafloat0.15Min delta
max_deltafloat0.40Max delta
min_yieldfloatMin annual yield %
min_open_interestintMin open interest
topint25Max results
"Screen covered calls on my TSLA shares, 30-45 DTE, 0.25 delta or lower"
screen_credit_spreads
Screen for credit spreads (bull put or bear call). Sell premium with defined risk.
ParameterTypeDefaultDescription
tickers requiredstring[]Ticker symbols
spread_typestringbull_putbull_put or bear_call
min_dte / max_dteint20 / 60DTE range
spread_widthsfloat[]Allowed spread widths ($)
min_return_on_riskfloatMin return on risk %
min_short_delta / max_short_deltafloatShort leg delta range
topint25Max results
"Find bull put spreads on AMZN, $5 wide, 30-45 DTE, at least 20% return on risk"
Directional (Buy Side)
screen_long_calls
Screen for long call options to buy. Bullish directional plays. Shows filter rejection summaries when results are empty.
ParameterTypeDefaultDescription
tickers requiredstring[]Ticker symbols
dte_min / dte_maxint30 / 180DTE range
delta_min / delta_maxfloat0.30 / 0.80Delta range
max_premiumfloatMax premium per contract ($)
min_iv_rankfloatMin IV rank (0-100)
topint25Max results
"Find LEAP calls on GOOGL with delta 0.50-0.70, at least 6 months out, under $50 premium"
screen_long_puts
Screen for long put options to buy. Bearish or hedging plays. Shows filter rejection summaries when results are empty.
ParameterTypeDefaultDescription
tickers requiredstring[]Ticker symbols
dte_min / dte_maxint30 / 180DTE range
delta_min / delta_maxfloat0.30 / 0.80Delta range (absolute value)
max_premiumfloatMax premium per contract ($)
min_iv_rankfloatMin IV rank (0-100)
topint25Max results
"Find protective puts on SPY, 0.40 delta, 90+ DTE"
screen_debit_spreads
Screen for debit spreads (bull call or bear put). Directional with defined risk.
ParameterTypeDefaultDescription
tickers requiredstring[]Ticker symbols
spread_typestringbull_callbull_call or bear_put
min_dte / max_dteint20 / 90DTE range
spread_widthsfloat[]Allowed spread widths ($)
min_return_on_riskfloatMin return on risk %
topint25Max results
"Bull call spreads on TSLA, $10 wide, 60-90 DTE"
list_saved_screeners
List your saved screener configs and the filter settings stored with each one.
"What screeners do I have saved?"
Strategy & Trade Finder
find_trades
Find the best option strategies for a ticker given your market thesis, goal, and risk tolerance. Evaluates 18 strategies and returns the top picks with scores, P&L metrics, and reasoning. Uses progressive fallback: widens DTE range, tries all defined-risk strategies, then returns diagnostics with suggestions. Never returns empty.
ParameterTypeDefaultDescription
ticker requiredstringTicker symbol
capitalfloat10000Available capital ($)
viewstringbullish_mildbullish_strong, bullish_mild, neutral, bearish_mild, bearish_strong
goalstringincomeincome, appreciation, hedge, speculation
risk_tolerancestringmoderateconservative, moderate, aggressive
dte_preferencestringanyshort (0-30d), medium (30-90d), long (90d+), any
"Find me the best income trades on NVDA — I'm mildly bullish with $20k"
compare_strategies
Compare CSP vs LEAP strategies for a ticker given your capital and market view.
ParameterTypeDefaultDescription
ticker requiredstringTicker symbol
capitalfloat10000Available capital ($)
viewstringbullish_mildbullish_strong, bullish_mild, or neutral
"Compare CSP vs LEAP on AAPL with $15k, mildly bullish view"
Portfolio
list_portfolios
List your portfolios with their IDs. Start here — the other portfolio tools need a portfolio_id.
"What portfolios do I have?"
get_portfolio
Get portfolio details including metrics, open trades, positions, and spreads.
ParameterTypeDefaultDescription
portfolio_id requiredstringPortfolio UUID
"Show me my portfolio's metrics and open trades"
get_positions
Get stock positions in a portfolio (shares held).
ParameterTypeDefaultDescription
portfolio_id requiredstringPortfolio UUID
add_trade
Add a trade (BUY or SELL, PUT or CALL) to a portfolio.
ParameterTypeDefaultDescription
portfolio_id requiredstringPortfolio UUID
ticker requiredstringTicker symbol
option_type requiredstringPUT or CALL
direction requiredstringBUY or SELL
strike requiredfloatStrike price
premium requiredfloatPer-contract premium
expiration requiredstringExpiration date (YYYY-MM-DD)
quantityint1Number of contracts
entry_datestringEntry date (YYYY-MM-DD, defaults to today)
notesstringOptional notes
"Add a SELL PUT on AAPL at $190 strike, $2.50 premium, expiring June 20"
close_trade
Close a trade with exit price and status. Calculates realized P&L.
ParameterTypeDefaultDescription
portfolio_id requiredstringPortfolio UUID
trade_id requiredstringTrade ID (e.g. T0001)
exit_price requiredfloatPer-share exit price
statusstringCLOSEDCLOSED, EXPIRED, ASSIGNED, or CALLED_AWAY
exit_datestringExit date (YYYY-MM-DD, defaults to today)
"Close trade T0001 at $0.30 — it expired mostly worthless"
add_spread
Add a spread (12 types supported) to a portfolio. Set net_credit for credit spreads, net_debit for debit spreads.
ParameterTypeDefaultDescription
portfolio_id requiredstringPortfolio UUID
ticker requiredstringTicker symbol
spread_type requiredstringbull_put, bear_call, bull_call, bear_put, iron_condor, jade_lizard, short_straddle, long_straddle, short_strangle, long_strangle, calendar_call, calendar_put
short_strike requiredfloatShort leg strike
long_strike requiredfloatLong leg strike
expiration requiredstringExpiration date (YYYY-MM-DD)
net_creditfloat0Net credit received (credit spreads)
net_debitfloat0Net debit paid (debit spreads)
quantityint1Number of contracts
entry_datestringEntry date (YYYY-MM-DD, defaults to today)
notesstringOptional notes
"Add a bull put spread on NVDA, 130/120, $1.80 credit, expiring July 18"
close_spread
Close a spread with exit price. Calculates realized P&L (credit or debit).
ParameterTypeDefaultDescription
portfolio_id requiredstringPortfolio UUID
spread_id requiredstringSpread ID (e.g. S0001)
exit_price requiredfloatPer-contract close price
statusstringCLOSEDCLOSED or EXPIRED
exit_datestringExit date (YYYY-MM-DD, defaults to today)
"Close spread S0002 at $0.15 — taking profits"
add_position
Add a stock position to a portfolio. Used for tracking assignments or manual entries.
ParameterTypeDefaultDescription
portfolio_id requiredstringPortfolio UUID
ticker requiredstringTicker symbol
shares requiredintNumber of shares
cost_basis requiredfloatCost basis per share
acquired_datestringDate acquired (YYYY-MM-DD)
notesstringOptional notes
"Add 100 shares of AAPL at $185 cost basis from my put assignment"
refresh_prices
Refresh live market prices for all open trades in a portfolio.
ParameterTypeDefaultDescription
portfolio_id requiredstringPortfolio UUID
"Refresh my portfolio prices"
get_portfolio_analytics
Analyze your closed-trade track record — win rate, average P&L per trade, risk-adjusted return, and a breakdown of which tickers, entry deltas, DTEs, and IV levels have actually worked.
ParameterTypeDefaultDescription
portfolio_idstringPortfolio UUID. Omit to combine all your portfolios.
periodstringallall, 30d, 90d, or ytd
"How am I doing? What entry conditions are paying off?"
get_morning_briefing
Daily snapshot for a portfolio — open positions, unrealized P&L, capital utilization, expirations, and action items.
ParameterTypeDefaultDescription
portfolio_id requiredstringPortfolio UUID
"Give me my morning briefing"
Market Data
get_chain
Browse raw options chain for a ticker. Returns a markdown table with Strike, Type, Exp, Bid, Ask, Vol, OI, Delta, and IV columns plus available expirations.
ParameterTypeDefaultDescription
ticker requiredstringTicker symbol
expirationstringExpiration date (YYYY-MM-DD). Recommended — without one, the nearest weekly ≥7 DTE is auto-selected. Check available_expirations in the response for other dates.
option_typestringcall or put. Omit for both.
min_volumeintMinimum volume filter
min_open_interestintMinimum open interest filter
topintMax contracts to return
"Show me the AAPL options chain for the June 20 expiration, calls only, with at least 100 OI"
get_option_quote
Get detailed quote for a single option contract. Returns pricing (bid/ask/spread), greeks (delta/gamma/theta/vega/rho), activity (volume/OI), valuation (intrinsic/extrinsic/breakeven), and probabilities (OTM/ITM).
ParameterTypeDefaultDescription
ticker requiredstringTicker symbol
expiration requiredstringExpiration date (YYYY-MM-DD)
strike requiredfloatStrike price
option_type requiredstringcall or put
"Get me a detailed quote on the NVDA 130 call expiring July 18"
get_iv_rank
Get IV rank and IV percentile for a ticker. Read-only cache lookup (no API write).
ParameterTypeDefaultDescription
ticker requiredstringTicker symbol
"What's the IV rank for NVDA right now?"
get_earnings
Get earnings data for a ticker, or the upcoming earnings calendar. Uses a 5-level fallback chain for reliable data coverage. Shows "(estimated)" suffix when using quarterly estimates. Calendar mode shows upcoming earnings with days-until.
ParameterTypeDefaultDescription
tickerstringTicker (omit for calendar)
within_daysint14Calendar lookahead (days)
"When are AAPL earnings?" or "What earnings are coming up this week?"
get_technicals
Technical analysis for a ticker — trend direction, 50/200-day moving averages, 13-week high/low range, and support/resistance levels.
ParameterTypeDefaultDescription
ticker requiredstringTicker symbol
"What do the technicals look like on AAPL?"
get_unusual_activity
Unusual options activity / flow — where the big premium is moving. With a ticker, shows detailed call/put flow and notable contracts; without one, shows the top tickers by net premium flow market-wide.
ParameterTypeDefaultDescription
tickerstringTicker symbol. Omit for market-wide flow.
limitint20Max rows for market-wide flow
"Where's the unusual options flow today?" or "Show me the flow on NVDA"
scan_stocks
Scan stocks by IV rank, valuation, market cap, dividend yield, sector, technical signal, and earnings proximity to surface candidates worth a closer look. All filters optional.
ParameterTypeDefaultDescription
iv_rank_min / iv_rank_maxfloatIV rank range (0-100)
pe_min / pe_maxfloatP/E ratio range
market_cap_minintMinimum market cap ($)
dividend_yield_minfloatMinimum dividend yield %
sectorstringSector filter
signalstringTechnical signal filter
earnings_withinintEarnings within N days
sort_bystringiv_rank, current_iv, pe_ratio, market_cap, dividend_yield, current_price, days_to_earnings, ticker
sort_dirstringdescasc or desc
limitint25Max results
"Scan for high IV rank stocks with earnings in the next 2 weeks, sorted by IV rank"
Resources
remora://watchlists
List all your watchlists and their tickers.
remora://watchlist/{id}
Get a specific watchlist by ID.
Remora — Setup Guide · Pricing · Account