Remora MCP Server
MCP server for Remora — 43 tools and 2 resources for options screening, chain browsing, trade finding, portfolio management, analytics, market data (including a market-regime readout and rolling options-flow history), Saber risk-adjusted income scoring, and the advisor-grade options optimizer (build plan, wheel co-pilot, target models, assignment calibration, multi-account blocks). Connect Claude Desktop, Cursor, or any MCP-compatible AI assistant.
Tools (43)
| Category | Tool | Description |
|---|---|---|
| Screening | screen_csp |
Screen for cash-secured puts |
| Screening | screen_cc |
Screen for covered calls |
| Screening | screen_credit_spreads |
Screen for credit spreads (bull put / bear call) |
| Screening | screen_long_calls |
Screen for long call options |
| Screening | screen_long_puts |
Screen for long put options |
| Screening | screen_debit_spreads |
Screen for debit spreads (bull call / bear put) |
| Screening | list_saved_screeners |
List your saved screener configs and their filter settings |
| Trade Finding | find_trades |
Find best strategies for a ticker given thesis, goal, and capital. Progressive fallback — never returns empty. |
| Trade Finding | best_trades_today |
Today's cross-ticker, Saber-ranked board of the top premium-selling trades — answers "what should I trade today?". Tier-gated (full board vs 3-trade preview). |
| Trade Finding | compare_strategies |
Compare CSP vs LEAP strategies side-by-side |
| Market Data | get_chain |
Browse raw options chain for a ticker with filtering by expiration, type, volume, and open interest |
| Market Data | get_option_quote |
Get detailed quote for a single option contract — pricing, greeks, activity, valuation, probabilities |
| Market Data | get_iv_rank |
Get IV rank and IV percentile for any ticker |
| Market Data | get_technicals |
Get trend, 50/200-day MAs, RSI(14) momentum, 13-week range, and support/resistance levels |
| Market Data | get_earnings |
Get earnings data or upcoming earnings calendar (with an implied-move estimate). 5-level fallback chain for reliable data. |
| Market Data | get_unusual_activity |
Options flow — where big premium is moving, by ticker or market-wide (with market breadth) |
| Market Data | get_options_sweeps |
REAL flow — tick-level sweeps, blocks & buy-vs-sell premium (signed at the bid/ask). Ultimate-tier. |
| Market Data | get_flow_history |
Rolling options-flow history — is net premium flow building or fading over the session / day-over-day |
| Market Data | get_market_regime |
Market regime snapshot — SPY trend + RSI, the IV environment, and flow breadth in one readout |
| Market Data | scan_stocks |
Scan stocks by IV rank, valuation, market cap, dividend, sector, signal, and earnings proximity |
| Portfolio | list_portfolios |
List your portfolios with their IDs (discovery for the tools below) |
| Portfolio | get_portfolio |
Get portfolio details, metrics, open trades, positions, and spreads |
| Portfolio | get_positions |
Get stock positions (shares held) |
| Portfolio | get_portfolio_analytics |
Track-record analytics — win rate, avg P&L, and what entry conditions are working |
| Portfolio | get_morning_briefing |
Daily snapshot — open positions, unrealized P&L, expirations, and action items |
| Portfolio | add_trade |
Add a trade (BUY/SELL, PUT/CALL) |
| Portfolio | close_trade |
Close a trade with exit price |
| Portfolio | add_spread |
Add a spread (12 types supported) |
| Portfolio | close_spread |
Close a spread with exit price |
| Portfolio | add_position |
Add a stock position |
| Portfolio | refresh_prices |
Refresh live market prices |
| Strategy | analyze_strategy |
Payoff analysis for any multi-leg strategy — max gain/loss, breakevens, net debit/credit, strategy name |
| Screening | save_screener_config |
Save the current screener filter set as a named preset |
| Portfolio | get_trade_dna |
Your trading-style profile from closed trades — sweet-spot delta/DTE/IV and best underlyings |
| Optimizer | build_plan |
The Build Plan — how to close the gap to a target model with cash-secured puts (and covered calls for income), leading with the decisive integers. Output-only. |
| Optimizer | list_target_models |
List your saved target model portfolios (the weightings the Build Plan builds toward) |
| Optimizer | create_target_model |
Create a target model from explicit weights or an equal-weight ticker list |
| Optimizer | wheel_status |
Wheel co-pilot — per-cycle state, honest effective basis, the next action, Actions Today, and a forward share/premium projection |
| Optimizer | assignment_calibration |
Learning loop — your realized vs predicted assignment per ticker and delta band |
| Optimizer | reopt_check |
Whether it's worth re-running the plan and what changed since the last one |
| Optimizer | block_trades |
Multi-account block sheet with fair (largest-remainder) per-account allocation. Ultimate-tier; output-only. |
| Saber | screen_by_saber |
Screen the best Saber-scored income trades (CSPs / covered calls) across tickers, ranked by Saber Score. Ultimate-tier. |
| Saber | get_saber |
Full Saber breakdown for a ticker's contracts — Score, TYE, τ, κ, ψ, σ. Ultimate-tier. |
Saber Options is Remora's risk-adjusted income score (Ultimate / Founding). The metrics — Saber Score, TYE (Theta Yield Equivalent), τ total-secured-yield, κ theta-efficiency, ψ theta-stability, and σ vol-sale-quality — also appear inline on every contract returned by the screeners (screen_csp, screen_cc, the spread screeners) and the optimizer's candidates, and can be requested as the ranking objective (saber / tye) in build_plan for Ultimate users.
Example prompts
- "What should I look at today?" →
list_portfolios, thenget_morning_briefing(portfolio_id) - "Build a bull put spread on AAPL at 180/175 for Jul 17 and show me the payoff" →
analyze_strategy(legs=[...]) - "Screen for CSPs the way I usually trade" →
get_trade_dna(), thenscreen_cspwith the sweet-spot delta/DTE - "Save this screen as 'weekly income'" →
save_screener_config(name, config) - "Generate a build plan for my IRA against a 70% PLTR / 30% SOFI target" →
build_plan(portfolio_id, inline_weights={...}) - "What wheels are open and what should I do today?" →
wheel_status(portfolio_id) - "How well is the assignment model tracking for my account?" →
assignment_calibration(portfolio_id) - "Rank the best Saber-scored CSPs across my watchlist" →
screen_by_saber(tickers=[...], side="put") - "What's the Saber breakdown on AAPL's July puts?" →
get_saber("AAPL", side="put")
Resources (2)
remora://watchlists— List all watchlists and tickersremora://watchlist/{id}— Get a specific watchlist
Key Features
- Filter rejection summaries — Screeners explain WHY contracts were filtered out when results are empty
- Progressive fallback —
find_tradeswidens DTE, tries all defined-risk strategies, and returns diagnostics with suggestions - 5-level earnings fallback —
get_earningschains multiple data sources for reliable coverage - Staleness timestamps — All read tools show when data was last retrieved
Setup
- Generate an API key at your account page (Pro subscription required)
- Install:
pip install heyremora - Set environment variables (
REMORA_API_KEY,REMORA_API_URL) and add to Claude Desktop config
See the full setup guide at /docs/mcp-setup on the Remora website.
Metadata
Release files for heyremora 0.10.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| heyremora-0.10.2.tar.gz | 127.5 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| heyremora-0.10.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 175.3 kB
Release files / heyremora-0.10.2.tar.gz
| Download URL | heyremora-0.10.2.tar.gz |
|---|---|
| Size | 127.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1de6b550d60ab860a640fe6a922366e9b84510dcd881823d7c4d89d2c82d4218
|
|
BLAKE2b-256 checksum How to use checksums |
2e2ae576347b71b3e3aa04bd955b659130900d4ccb1872714c2eb70a7372cc11
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
Release files / heyremora-0.10.2-py3-none-any.whl
| Download URL | heyremora-0.10.2-py3-none-any.whl |
|---|---|
| Size | 47.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a9226624a3b6dff5f5524466e7ebaee370c9508cfebeb21037446735d3866f06
|
|
BLAKE2b-256 checksum How to use checksums |
aa8f5119ec1ac5c2de398463bb72d133cdcb58389a566c258e9bcd0c5575d1be
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
Security for heyremora 0.10.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.