ApexVol Options Analytics
Options analytics for AI assistants: chains, IV rank, VRP, Greeks, GEX, expected moves, screeners.
Connector by ryansilk · GitHub account verified by the MCP Registry
Install
Works with Claude Code, VS Code, Codex, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/ryansilk-apexvol-mcp
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Remote endpoint
https://apexvol.com/mcp-serverRemote (HTTP)
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 26, 2026.
- Tools
- 39 read · 2 write · 0 delete · 3 not yet classified
- Secrets
- 1 (API keys, tokens or passwords)
- Install scripts
- None found
- Runs as
- Python package
Tools by what they do 44
Read from the source code; the running server may list different tools.
Read 39 · Look things up without changing anything.
analyze_earnings_historyanalyze_strategycalculate_expected_movecalculate_portfolio_greekscalculate_probability_of_profitfind_iv_opportunitiesget_charm_exposureget_cross_index_gexget_earnings_calendarget_earnings_move_analysisget_economic_calendarget_expirations
Show 27 more tools
get_gexget_greeks_heatmapget_hedge_recommendationsget_historical_chainget_iv_rankget_market_overviewget_max_painget_monies_surfaceget_options_by_deltaget_options_chainget_options_flowget_orats_coresget_smart_money_flowget_stock_priceget_term_structureget_third_order_greeksget_ticker_analyticsget_vix_snapshotget_volatility_coneget_volatility_risk_premiumget_volume_profileget_zero_dtehelpoptimize_strategyscan_relative_valuescan_volatility_arbsearch_tickers
Write 2 · Create, change, send or run things.
build_strategygenerate_stress_tests
Not yet classified 3 · We could not tell from the name and description.
run_scenario_analysisscreen_marketsimulate_option_chain
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
APEXVOL_API_TOKEN
Network hosts it talks to 2
apexvol.com· found in remote endpoint, install command, codegithub.com· found in code
Tools (44)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
analyze_earnings_historyAnalyze historical earnings moves for a stock. Shows how the stock has moved on past earnings announcements, compared to the expected move implied by options. Use this tool when the user asks about: - Historical earnings moves - Past earnings reactions - Beat/miss patterns - Options pricing accuracy Args: ticker: Stock symbol Returns: Historical earnings move analysis
analyze_strategyAnalyze a custom options strategy. Calculates full P&L profile, Greeks, probability of profit, and risk metrics for a custom strategy. Use this tool when the user asks about: - Analyzing a specific trade - Strategy P&L profile - Greeks for a position Args: ticker: Stock symbol legs: Strategy legs in format "BUY 1 C 150, SELL 1 C 155" Returns: Full analysis with P&L, Greeks, and probabilities
build_strategyBuild an options strategy with optimal parameters. Supports various strategy types and automatically selects strikes based on target delta or other criteria. Strategy types: iron_condor, credit_spread, debit_spread, straddle, strangle, butterfly, calendar Use this tool when the user asks about: - Building a specific strategy - Iron condor, credit spread, etc. - Strategy construction Args: ticker: Stock symbol strategy_type: Type of strategy (iron_condor, credit_spread, etc.) expiration: Target expiration or None for nearest monthly width: Strike width for spreads in dollars…
calculate_expected_moveCalculate the expected move based on ATM straddle pricing. The expected move represents the market's implied price range through the expiration date, derived from options pricing. Use this tool when the user asks about: - Expected move or implied move - How much a stock might move - Options-implied price range - Event risk pricing Args: ticker: Stock symbol expiration: Specific expiration or None for nearest tickers: Comma-separated list of up to 25 symbols ("SPY,AAPL,NVDA") for one batch call; `ticker` is ignored and every symbol's move comes back in one table. …
calculate_portfolio_greeksCalculate aggregate Greeks for a portfolio of positions. Takes a portfolio of options positions and calculates net delta, theta, and vega exposure plus a risk-level assessment. Use this tool when the user asks about: - Portfolio Greeks - Net delta/theta/vega - Position exposure Args: positions: JSON array of positions, e.g. '[{"ticker": "AAPL", "position_type": "STOCK", "quantity": 100, "current_price": 210}, {"ticker": "AAPL", "position_type": "CALL", "quantity": -2, "strike": 220, "expiration": "2026-08-21", "current_price": 4.10, "delta": 0.31, "theta": -8.2, "vega": 21.0}]'. Get opt…
calculate_probability_of_profitCalculate the probability of profit for a set of option legs. Uses N(d2)-based probabilities on the combined position payoff. Use this tool when the user asks about: - Probability of profit / PoP for a trade - Odds a spread or condor expires profitable Args: legs: JSON array of legs, e.g. '[{"option_type": "put", "action": "sell", "strike": 95, "iv": 32.5, "premium": 1.20, "quantity": 1}]' (iv accepts percent or decimal; premium is per share) stock_price: Current stock price days_to_exp: Days to expiration Returns: Probability of profit percentage
find_iv_opportunitiesFind IV mean reversion trading opportunities. Identifies when IV is statistically extreme (>2 std from mean) and suggests strategies to capture mean reversion. Use this tool when the user asks about: - Mean reversion opportunities - Extreme IV levels - When to sell/buy volatility - IV statistical analysis Args: ticker: Stock symbol z_score_threshold: Statistical threshold (default 2.0) Returns: Opportunity assessment with strategy recommendations
generate_stress_testsRun stress test scenarios on a portfolio. Tests portfolio under extreme market conditions like crashes, vol spikes, and rallies. Use this tool when the user asks about: - Stress testing - Crash scenarios - Worst-case analysis Args: positions: JSON array of positions, e.g. '[{"ticker": "AAPL", "position_type": "STOCK", "quantity": 100, "current_price": 210}, {"ticker": "AAPL", "position_type": "CALL", "quantity": -2, "strike": 220, "expiration": "2026-08-21", "current_price": 4.10, "delta": 0.31, "theta": -8.2, "vega": 21.0}]'. Get option Greeks from get_options_chain first. Plain text (…
get_charm_exposureGet charm (delta decay) exposure by strike. Charm measures how delta changes with time. High charm exposure indicates significant delta changes as time passes, affecting hedging flows. Use this tool when the user asks about: - Charm exposure - Delta decay - Time-based hedging flows Args: ticker: Stock symbol expiration: Specific expiration or None for nearest Returns: Charm exposure by strike
get_cross_index_gexCompare GEX across major indices. Shows gamma exposure comparison between SPY, QQQ, IWM, and other major indices to understand market-wide positioning. Use this tool when the user asks about: - Cross-index GEX comparison - Market-wide gamma positioning - Index relative GEX Args: tickers: Comma-separated tickers or None for defaults (SPY,QQQ,IWM,DIA) Returns: GEX comparison across indices
get_earnings_calendarGet upcoming earnings announcements. Shows companies reporting earnings in the upcoming period, including expected move implied by options pricing. Use this tool when the user asks about: - Upcoming earnings - What companies report this week - Earnings calendar Args: days_ahead: Number of days to look ahead (default 7) min_market_cap: Minimum market cap filter in billions Returns: List of upcoming earnings with expected moves
get_earnings_move_analysisAnalyze how a stock moves around earnings and whether options misprice it. Pick via the `analysis` argument: - "mispricing" (default): IV rank + VRP + expected-vs-actual history combined into an over/underpriced assessment - "historical_moves": realized post-earnings moves over several horizons - "expected_vs_actual": straddle-implied expected move vs what actually happened - "verdict": combined buy/sell-the-straddle verdict for the next earnings - "seasonality": monthly/quarterly return and volatility seasonality - "post_drift": post-earnings drift statistics over recent quarters - "iv_cru…
get_economic_calendarGet the macro economic-event calendar (CPI, FOMC, jobs reports...). Use this tool when the user asks about: - Upcoming macro events or data releases - When the next CPI/FOMC/NFP is - Event risk beyond earnings Args: from_date: Start date YYYY-MM-DD (default today) to_date: End date YYYY-MM-DD (default ~1 week out) Returns: Economic events with dates and importance
get_expirationsGet available expiration dates for a ticker. Returns a list of all available options expiration dates, useful for planning trades or understanding the term structure. Use this tool when the user asks about: - When options expire - Available expiration dates - Weekly vs monthly expirations Args: ticker: Stock symbol Returns: List of expiration dates
get_gexGet Gamma Exposure (GEX) levels and flip points. GEX measures the gamma exposure of market makers at each strike level. Positive GEX suggests dealer hedging will dampen moves (supportive). Negative GEX suggests dealer hedging will amplify moves (volatile). Use this tool when the user asks about: - Gamma exposure or GEX - Support and resistance from options - Dealer hedging levels - Market maker positioning Args: ticker: Stock symbol (e.g., "SPY", "QQQ") expiration: Specific expiration or None for aggregate aggregate: Whether to aggregate across all expirations tickers: Comma…
Show 29 more tools
get_greeks_heatmapGet Greeks visualization data across strikes and expirations. Returns a matrix of Greek values that can be visualized as a heatmap. Useful for understanding the Greek landscape across the chain. Use this tool when the user asks about: - Greeks across strikes - Delta/gamma/theta/vega heatmap - Greek distribution Args: ticker: Stock symbol greek: Which Greek to show ("delta", "gamma", "theta", "vega") option_type: "calls" or "puts" Returns: Heatmap matrix data with strikes and expirations
get_hedge_recommendationsGet delta-hedge recommendations for a portfolio. Computes net portfolio delta and suggests a stock hedge plus an option-based alternative on the hedge ticker to reach the target delta. Recommendations are share-equivalent, not beta-weighted. Use this tool when the user asks about: - How to hedge a position or portfolio - Getting delta-neutral - Protective puts / reducing directional risk Args: positions: JSON array of positions, e.g. '[{"ticker": "AAPL", "position_type": "STOCK", "quantity": 100, "current_price": 210}, {"ticker": "AAPL", "position_type": "CALL", "quantity": -2, "strike"…
get_historical_chainGet the options chain as it looked on a past trading day (EOD snapshot). Historical chains go back years — see how an option was priced before an earnings event, through a selloff, or at any point in its life. Use this tool when the user asks about: - What an option was trading at on a past date - How a chain looked before/after an event - Backtesting entries against real historical quotes Args: ticker: Stock symbol expiration: Expiration date YYYY-MM-DD trade_date: The historical date to snapshot YYYY-MM-DD Returns: End-of-day chain snapshot for that date
get_iv_rankGet IV Rank and percentile for a stock. IV Rank shows where current implied volatility stands relative to its historical range. High IV Rank (>50) suggests elevated volatility, potentially favorable for selling premium. Low IV Rank (<30) suggests cheap options, potentially favorable for buying premium. Use this tool when the user asks about: - Whether options are expensive or cheap - IV rank or IV percentile - Historical volatility context - Premium selling/buying opportunities Args: ticker: Stock symbol (e.g., "AAPL", "SPY") lookback_days: Historical lookback period (default 252 = …
get_market_overviewGet market-wide volatility overview. Shows aggregate volatility metrics across major indices and sectors, including VIX levels, put/call ratios, and GEX regime. Use this tool when the user asks about: - Market overview - Overall market volatility - VIX and market sentiment - Broad market positioning Returns: Market-wide volatility and positioning overview
get_max_painGet the max pain strike for a ticker. Max pain is the strike where option holders lose the most at expiry (and writers keep the most premium) — often watched as a magnet level into expiration. Use this tool when the user asks about: - Max pain level - Where the stock might pin at expiration - Option-writer positioning Args: ticker: Stock symbol expiration: Expiration date YYYY-MM-DD (default: nearest) Returns: Max pain strike with the loss profile by strike
get_monies_surfaceGet the ORATS monies volatility surface for a ticker. - "implied" (default): the market's current smoothed vol surface - "forecast": ORATS's model-forecast surface - "comparison": implied vs forecast side by side — where the model disagrees with the market (potential rich/cheap spots) Use this tool when the user asks about: - The vol surface or smoothed IV by delta - Model-vs-market vol disagreement - Where IV looks rich or cheap across the surface Args: ticker: Stock symbol surface: "implied", "forecast", or "comparison" Returns: Monies surface rows per expiration
get_options_by_deltaFind options at a specific delta. Useful for finding options at standard delta levels (e.g., 0.30 delta calls for covered calls, 0.16 delta puts for credit spreads). Use this tool when the user asks about: - Options at a specific delta - 30 delta calls or 20 delta puts - Finding strikes by delta Args: ticker: Stock symbol target_delta: Target delta (0.0 to 1.0, default 0.30) option_type: "call" or "put" expiration: Specific expiration or None for nearest Returns: Strike and option details at the target delta
get_options_chainGet the options chain for a ticker. Returns calls and puts with all Greeks, IV, volume, and open interest per strike. Defaults to the nearest expiration and the 20 strikes each side of the money — widen only when the analysis genuinely needs it. Use this tool when the user asks about: - Options prices for a stock - Call or put prices at specific strikes - Volume and open interest data - Full options chain information Args: ticker: Stock symbol (e.g., "AAPL", "SPY", "TSLA") expiration: Specific expiration date (YYYY-MM-DD); overrides num_expirations num_expirations: How many of t…
get_options_flowAnalyze options flow and unusual activity for a ticker. Returns call/put volumes, premiums, and identifies unusual activity that may indicate institutional positioning. Use this tool when the user asks about: - Options flow or order flow - Call/put ratio - Unusual options activity - Large trades or sweeps Args: ticker: Stock symbol limit: Rows kept in the flow lists under compact detail (server default 25; 1 to 500). detail: "compact" (default) or "full" for every row. Returns: Flow analysis with volumes, premiums, and unusual activity
get_orats_coresGet raw ORATS "cores" analytics for a ticker — 340+ pre-computed fields. The deepest single call available: IV surface summary metrics, IV/HV history stats, term-structure slope/contango, earnings-move components, borrow rates, betas, percentiles, and more, straight from the data vendor. Use when the curated endpoints don't carry the specific field you need. Use this tool when the user asks about: - A specific ORATS field by name - Deep vendor-level analytics not in other tools - Bulk fundamentals+vol context for one ticker Args: ticker: Stock symbol fields: Comma-separated field na…
get_smart_money_flowIdentify institutional/smart money options trades. Filters for large trades, sweeps, and block orders that may indicate informed positioning. Use this tool when the user asks about: - Smart money or institutional flow - Large options trades - Block trades or sweeps - Whale activity Args: ticker: Stock symbol Returns: Smart money flow patterns and significant trades
get_stock_priceGet the current stock price and basic company stats. Returns the price plus sector, market cap, one-year beta and the next earnings date when the feed carries one. Use this tool when the user asks about: - Current stock price - Company information (sector, market cap, beta, next earnings) Args: ticker: Stock symbol Returns: Current price and company information
get_term_structureGet IV term structure across all expirations. Shows how implied volatility varies across different expiration dates. Contango (upward slope) is normal; backwardation suggests near-term event risk. Use this tool when the user asks about: - Term structure of volatility - Calendar spread opportunities - Event-driven vol bumps - Contango vs backwardation Args: ticker: Stock symbol Returns: Term structure data by expiration
get_third_order_greeksGet third-order Greeks: Speed, Zomma, Color, Vomma, Ultima. These advanced Greeks measure higher-order sensitivities: - Speed: Rate of change of gamma - Zomma: Gamma sensitivity to volatility - Color: Gamma sensitivity to time - Vomma: Vega sensitivity to volatility - Ultima: Vomma sensitivity to volatility Use this tool when the user asks about: - Third-order Greeks - Speed, zomma, color - Advanced Greeks analysis Args: ticker: Stock symbol expiration: Specific expiration or None for nearest Returns: Third-order Greeks data
get_ticker_analyticsGet a specific per-ticker analytics view. One tool, eight analyses — pick via the `analysis` argument: - "skew": put/call IV skew (view: "analysis" default, "history", "curvature") - "dividends": dividend history, yield, and ex-date behavior - "borrow_rate": stock borrow cost / hard-to-borrow signals (short-squeeze context) - "correlation": correlation and beta vs SPY and sector; pass compare_with to get the pairwise correlation vs another ticker instead - "hv_regimes": historical volatility regimes (view: "dashboard" default, "signals", "decomposition", "ex_earnings") - "price_context": …
get_vix_snapshotGet the current VIX snapshot: level, change, and term-structure state. Use this tool when the user asks about: - The VIX or overall market fear level - Whether index vol is elevated or calm - Vol regime context before a trade Returns: VIX level, change, and context
get_volatility_coneGet volatility cone comparing current IV to historical realized volatility. The volatility cone shows the historical distribution of realized volatility at different time horizons, allowing comparison with current implied volatility. This helps identify if options are over/underpriced relative to historical moves. Use this tool when the user asks about: - IV vs realized volatility comparison - Volatility cone analysis - Historical volatility distribution - Whether options are fairly priced Args: ticker: Stock symbol periods: Comma-separated periods in days (default "10,20,30,60,90")…
get_volatility_risk_premiumCalculate the volatility risk premium (IV minus realized volatility). VRP measures the spread between implied and realized volatility. Positive VRP means options are pricing in more volatility than actually occurs - favorable for sellers. Negative VRP means options are cheap relative to actual moves. Use this tool when the user asks about: - Volatility risk premium or VRP - IV vs RV spread - Whether to sell or buy volatility - Premium edge assessment Args: ticker: Stock symbol lookback_days: Days for realized vol calculation (default 30) view: "current" (snapshot), "timeseries" …
get_volume_profileGet the option volume and open-interest profile by strike. Shows where volume and OI concentrate across strikes — support/ resistance implied by positioning, plus notable OI changes. Use this tool when the user asks about: - Where the open interest sits - Volume by strike - OI-implied support and resistance Args: ticker: Stock symbol expiration: Expiration date YYYY-MM-DD (default: nearest) Returns: Per-strike volume/OI profile
get_zero_dteGet 0DTE (same-day expiration) analytics for a ticker. Includes 0DTE gamma exposure, gamma flip level, max pain, theta decay projection, and the chain for today's expiration. Only meaningful for tickers with daily expirations (SPY, QQQ, SPX...) on trading days. Use this tool when the user asks about: - 0DTE setups or same-day options - Intraday gamma/pinning levels - Today's expiration chain Args: ticker: Stock symbol with 0DTE listings (e.g., "SPY") strikes_around: Strikes kept each side of spot in by_strike and chain_table (server default 15); 0 keeps every strike. det…
helpLook up the ApexVol tool or endpoint that answers a question, before calling it. Reads a bundled copy of the API reference: no network call, no market-data cost, works before a token is configured. Use this tool when: - You are not sure which tool returns a number (IV rank, dealer gamma, expected move, borrow rate) - You need an endpoint's parameters, units, basis, fields or plan - You want the starter prompts for a data family - A call failed with 403 or 404 and you want the documented shape Args: topic: None for the overview (families, counts, how to ask); a tool name ("get_i…
optimize_strategyFind optimal strikes for a strategy type. Optimizes strike selection based on target criteria like max credit, best risk/reward, or target probability. Use this tool when the user asks about: - Best strikes for a strategy - Optimal iron condor strikes - Maximizing credit or probability Args: ticker: Stock symbol strategy_type: Type of strategy target: Optimization target (credit, risk_reward, probability) Returns: Optimized strategy parameters
run_scenario_analysisRun what-if scenario analysis on a portfolio. Shows how portfolio value changes under different market conditions (linear delta/vega/theta approximation). Use this tool when the user asks about: - What-if scenarios - Portfolio P&L under different conditions - Price/vol sensitivity Args: positions: JSON array of positions, e.g. '[{"ticker": "AAPL", "position_type": "STOCK", "quantity": 100, "current_price": 210}, {"ticker": "AAPL", "position_type": "CALL", "quantity": -2, "strike": 220, "expiration": "2026-08-21", "current_price": 4.10, "delta": 0.31, "theta": -8.2, "vega": 21.0}]'. Get …
scan_relative_valueMarket-wide relative-value scans. - "mean_reversion" (default): tickers whose IV/SPY ratio is stretched vs its own 1-year average — rich or cheap vol candidates - "pairs": rich-vs-cheap ticker pairs for pairs trading Args: view: "mean_reversion" or "pairs" limit: Max results (1-50) threshold: Z-score threshold for mean_reversion (default 1.5) Returns: Scan results ranked by stretch
scan_volatility_arbScan for cross-index volatility arbitrage opportunities. Identifies when implied volatility relationships between correlated assets are mispriced, creating potential arbitrage opportunities. Use this tool when the user asks about: - Volatility arbitrage - Cross-asset vol relationships - Vol dislocations - Relative value opportunities Returns: Volatility arbitrage opportunities across indices
screen_marketScreen the market for trading opportunities. Preset screens run against the full ~6,000-ticker universe using bulk data (cheap on quota). Pass screen_type="list" to fetch the catalog. Screen types: - high_iv_rank / low_iv_rank: elevated or depressed IV vs 1-year range - high_vrp: IV rich vs realized — premium-selling edge - earnings_this_week: reporting in the next 7 days - high_skew: elevated put skew (hedging demand / fear) - steep_contango: large front-to-back IV spread (calendar spreads) - mean_reversion: IV/SPY ratio stretched vs its 1-year average - vol_pairs: rich-vs-cheap ticker pair…
search_tickersSearch or validate tickers against the platform's coverage universe. Use before deep analysis when unsure a symbol is supported, or to resolve a company name to its ticker. Args: query: Symbol or company-name fragment (e.g. "NVDA" or "nvidia") limit: Max matches to return (1-20) Returns: Ranked matches plus exact-match/supported flags
simulate_option_chainRe-price an options chain at a hypothetical stock price, DTE, and IV shift. Black-Scholes "what-if" for the whole chain: what would these options be worth if the stock were at X, with Y days left, and IV up/down Z%? Use this tool when the user asks about: - What an option would be worth if the stock moves - How theta decay reshapes the chain over time - IV crush / IV spike what-ifs Args: ticker: Stock symbol (server fetches the current chain) sim_price: Hypothetical stock price sim_dte: Days to expiration to simulate (0 = at expiry) iv_adjustment: IV shift in percent, -50 to…
Signals
- Stars
- 2
- Forks
- 0
- Open issues
- 0
- Weekly downloads
- 36
- Last commit
- Oct 9, 2026 (20 days ago)
- Last release
- Sep 9, 2026 (1 month ago)
- Last package publish
- Sep 9, 2026 (1 month ago)
From GitHub (fetched Oct 24, 2026) and the package registry.
Details
- Registry name
io.github.ryansilk/apexvol-mcp- Version
- 0.1.4
- Auth
- Auth not stated, API key
- Packages
- pypi apexvol-mcp
- License
- MIT
- Repository
- github.com/ryansilk/apexvol-mcp
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
Cite this page
ApexVol Options Analytics MCP server. Agent Mart. https://agentmart.dev/connectors/ryansilk-apexvol-mcp (last updated 2026-10-24)