ryansilk/apexvol-mcp

A Model Context Protocol (MCP) server that gives AI assistants live access to ApexVol's options analytics platform: options chains, IV rank, volatility risk premium, Greeks, gamma exposure (GEX), expected moves, strategy building, and market screening. **44 tools**, one connector.
Works with Claude Code, Claude Desktop, claude.ai (remote connector — no install), and any MCP-compatible client.
- **Setup guide (step by step):** https://apexvol.com/learn/claude-options-data-mcp
- **REST API docs:** https://apexvol.com/docs/api
- **Single-file API reference, sized for LLM context windows:** https://apexvol.com/docs/api/apexvol-api.md
Quickstart
Option A — Remote connector (no install)
ApexVol is listed in Claude's connector directory: open **https://claude.ai/directory/apexvol** (or **Customize → Connectors → Discover** in claude.ai or Claude Desktop and search for ApexVol), then select **Connect to Claude**.
Sign in with your ApexVol account when prompted (OAuth). That's it — no Python, no config files.
To add it by hand instead (or in another MCP client), use this URL as a custom connector:
Claude Code can use the remote server too:
then authenticate when prompted (the /mcp command shows login state).
Option B — Local install (stdio)
**Access requires any paid ApexVol plan (from $55/mo).** Every tool returns the same data tier your web plan includes; Pro unlocks the full toolset. Tokens are self-served at **apexvol.com/account → API Access**.
Example session
Real output, 2026-08-15:
> **You:** What's the IV rank for SPY?
>
> **Claude** calls get_iv_rank("SPY"):
>
> | Metric | Value |
> |--------|-------|
> | Current IV | 12.3% |
> | IV Rank | 7.8 |
> | IV Percentile | 8.3% |
> | 52-Week Low | 11.2% |
> | 52-Week High | 25.0% |
>
> **Assessment**: LOW — consider buying premium rather than selling it.
Follow-ups like "so is a calendar spread better than an iron condor here?" work because Claude can pull the term structure, build both strategies, and compare the Greeks — in the same conversation.
Architecture
The local server runs on your machine and calls the ApexVol platform API. The remote server is the same toolset hosted by ApexVol, authenticated with OAuth instead of a token.
Features
- **43 Analytics Tools** — every /api/mcp/data endpoint is reachable from Claude
- **Built-in reference** — a help tool answers "which tool gives me X" from a bundled copy of the API docs, and 41 prompts appear in your client's prompt picker: 33 starters, three per data family, plus 8 whole-job recipes
- **Natural Language Interface** - Ask questions like "What's the IV rank for SPY?"
- **Remote or local** - hosted OAuth connector, or a pipx-installed stdio server
- **Token Authentication** - Secure API token validation (local mode)
- **Built-in health check** - apexvol-mcp --check verifies your install and token
Available Tools
Options Chain (6 tools)
- get_options_chain - Full options chain for any ticker
- get_expirations - Available expiration dates
- get_options_by_delta - Find options at specific delta
- get_stock_price - Current price and company info
- calculate_expected_move - Expected move from straddle pricing; tickers="SPY,AAPL,NVDA" prices up to 25 symbols in one call (0.1.4)
- get_historical_chain - Chain snapshot on any past trading day
Volatility Analysis (7 tools)
- get_iv_rank - IV rank and percentile; tickers="SPY,QQQ,IWM" ranks up to 25 symbols in one call (0.1.4)
- get_volatility_cone - IV vs historical realized volatility
- get_volatility_risk_premium - VRP (IV minus RV)
- get_term_structure - IV across expirations
- find_iv_opportunities - Mean reversion opportunities
- get_vix_snapshot - VIX level and term-structure state
- get_monies_surface - Smoothed vol surface: implied, forecast, or model-vs-market comparison
Greeks & GEX (5 tools)
- get_gex - Gamma Exposure by strike; tickers= batches up to 25 symbols, strikes_around and detail size the payload (0.1.4)