{
  "markdown": "# ApexVol MCP Server\n\n[![PyPI](https://img.shields.io/pypi/v/apexvol-mcp)](https://pypi.org/project/apexvol-mcp/)\n[![Python](https://img.shields.io/pypi/pyversions/apexvol-mcp)](https://pypi.org/project/apexvol-mcp/)\n[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)\n\nA 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. **43 tools**, one connector.\n\nWorks with Claude Code, Claude Desktop, claude.ai (remote connector — no install), and any MCP-compatible client.\n\n- **Setup guide (step by step):** https://apexvol.com/learn/claude-options-data-mcp\n- **REST API docs:** https://apexvol.com/docs/api\n- **Single-file API reference, sized for LLM context windows:** https://apexvol.com/docs/api/apexvol-api.md\n\n## Quickstart\n\n### Option A — Remote connector (no install)\n\nAdd a custom connector in claude.ai or Claude Desktop (**Settings → Connectors → Add custom connector**) with this URL:\n\n```\nhttps://apexvol.com/mcp-server\n```\n\nSign in with your ApexVol account when prompted (OAuth). That's it — no Python, no config files.\n\nClaude Code can use the remote server too:\n\n```bash\nclaude mcp add --transport http apexvol https://apexvol.com/mcp-server\n```\n\nthen authenticate when prompted (the `/mcp` command shows login state).\n\n### Option B — Local install (stdio)\n\n```bash\npipx install apexvol-mcp\nclaude mcp add apexvol -e APEXVOL_API_TOKEN=avmcp_YOUR_TOKEN_HERE -- apexvol-mcp\n```\n\n**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**.\n\n## Example session\n\nReal output, 2026-08-15:\n\n> **You:** What's the IV rank for SPY?\n>\n> **Claude** calls `get_iv_rank(\"SPY\")`:\n>\n> | Metric | Value |\n> |--------|-------|\n> | Current IV | 12.3% |\n> | IV Rank | 7.8 |\n> | IV Percentile | 8.3% |\n> | 52-Week Low | 11.2% |\n> | 52-Week High | 25.0% |\n>\n> **Assessment**: LOW — consider buying premium rather than selling it.\n\nFollow-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.\n\n## Architecture\n\n```\nRemote (no install)\n┌─────────────────────────┐            ┌──────────────────────────────┐\n│ claude.ai / Desktop /   │── OAuth ──▶│ https://apexvol.com/mcp-server│\n│ Claude Code (HTTP)      │            │ (streamable HTTP)             │\n└─────────────────────────┘            └──────────────────────────────┘\n\nLocal (stdio)\n┌─────────────────────┐               ┌─────────────────────┐\n│ Claude Code/Desktop │               │ apexvol.com         │\n│         │           │               │                     │\n│         ▼           │               │                     │\n│   ApexVol MCP       │──── HTTPS ───▶│  /api/mcp/data/...  │\n│   (runs locally)    │               │                     │\n└─────────────────────┘               └─────────────────────┘\n```\n\nThe 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.\n\n## Features\n\n- **43 Analytics Tools** — every `/api/mcp/data` endpoint is reachable from Claude\n- **Natural Language Interface** - Ask questions like \"What's the IV rank for SPY?\"\n- **Remote or local** - hosted OAuth connector, or a pipx-installed stdio server\n- **Token Authentication** - Secure API token validation (local mode)\n- **Built-in health check** - `apexvol-mcp --check` verifies your install and token\n\n## Available Tools\n\n### Options Chain (6 tools)\n- `get_options_chain` - Full options chain for any ticker\n- `get_expirations` - Available expiration dates\n- `get_options_by_delta` - Find options at specific delta\n- `get_stock_price` - Current price and company info\n- `calculate_expected_move` - Expected move from straddle pricing\n- `get_historical_chain` - Chain snapshot on any past trading day\n\n### Volatility Analysis (7 tools)\n- `get_iv_rank` - IV rank and percentile\n- `get_volatility_cone` - IV vs historical realized volatility\n- `get_volatility_risk_premium` - VRP (IV minus RV)\n- `get_term_structure` - IV across expirations\n- `find_iv_opportunities` - Mean reversion opportunities\n- `get_vix_snapshot` - VIX level and term-structure state\n- `get_monies_surface` - Smoothed vol surface: implied, forecast, or model-vs-market comparison\n\n### Greeks & GEX (5 tools)\n- `get_gex` - Gamma Exposure by strike\n- `get_charm_exposure` - Delta decay exposure\n- `get_third_order_greeks` - Speed, zomma, color, vomma, ultima\n- `get_greeks_heatmap` - Greeks across strikes and expirations\n- `get_cross_index_gex` - Compare GEX across indices\n\n### Options Flow (3 tools)\n- `get_options_flow` - Flow and unusual activity (end-of-day figures while the market is closed; answers with an explanation, never zeros, if the volume feed goes quiet)\n- `get_smart_money_flow` - Institutional flow patterns ⚠️ *same limitation as above*\n- `scan_volatility_arb` - Cross-index volatility arbitrage\n\n### Strategy Building (5 tools)\n- `build_strategy` - Build options strategies (iron condor, spreads, etc.)\n- `analyze_strategy` - Full P&L and Greeks analysis\n- `optimize_strategy` - Find optimal strikes\n- `simulate_option_chain` - Black-Scholes what-if re-pricing (price/DTE/IV shift)\n- `calculate_probability_of_profit` - PoP for any set of legs\n\n### Risk Management (4 tools)\n- `calculate_portfolio_greeks` - Aggregate portfolio Greeks\n- `run_scenario_analysis` - What-if scenarios\n- `generate_stress_tests` - Stress test results\n- `get_hedge_recommendations` - Delta-hedge suggestions (stock + option legs)\n\nPositions are passed as a JSON array (ticker, position_type, quantity, strike,\nexpiration, Greeks) — pull option Greeks from `get_options_chain` first. Plain\ntext (\"AAPL 100 shares\") works for stock-only portfolios.\n\n### Events & Screening (5 tools)\n- `get_earnings_calendar` - Upcoming earnings\n- `analyze_earnings_history` - Historical earnings moves\n- `screen_market` - Market screening (high IV, unusual volume, etc.)\n- `get_market_overview` - Market-wide volatility overview\n- `get_economic_calendar` - Macro events (CPI, FOMC, jobs...)\n\n### Ticker Analytics (8 tools)\n- `get_ticker_analytics` - One tool, eight views: `skew`, `dividends`,\n  `borrow_rate`, `correlation`, `hv_regimes`, `price_context`,\n  `relative_value`, `greeks_exposure`\n- `get_earnings_move_analysis` - seven views: `mispricing`, `historical_moves`,\n  `expected_vs_actual`, `verdict`, `seasonality`, `post_drift`, `iv_crush`\n- `get_max_pain` - Max pain strike and loss profile\n- `get_volume_profile` - Volume/OI by strike with OI-implied support/resistance\n- `get_zero_dte` - 0DTE gamma, flip level, max pain, theta decay (SPY/QQQ/SPX…)\n- `get_orats_cores` - Raw vendor cores row (340+ fields) with field selection\n- `search_tickers` - Resolve names to symbols / check coverage\n- `scan_relative_value` - Market-wide IV/SPY mean-reversion and pairs scans\n\n## Installation (local mode, in detail)\n\n### Prerequisites\n\n- Python 3.10+\n- Any paid ApexVol plan and an API token (see \"Getting a Token\" below)\n\n### Install the Package\n\nWe recommend [pipx](https://pipx.pypa.io) so the `apexvol-mcp` command is\nisolated and always on your PATH:\n\n```bash\npipx install apexvol-mcp\n```\n\nPlain `pip install apexvol-mcp` also works.\n\nOr install from source:\n\n```bash\ngit clone https://github.com/ryansilk/apexvol-mcp.git\ncd apexvol-mcp\npip install -e .\n```\n\n### Verify the install\n\nBefore touching any Claude config, confirm the command works and your token\nauthenticates:\n\n```bash\nAPEXVOL_API_TOKEN=avmcp_YOUR_TOKEN_HERE apexvol-mcp --check\n```\n\n`--check` prints the client version, auth result, and your remaining\nrate-limit/monthly budget. If it says OK, the only step left is wiring it\ninto Claude.\n\n## Configuration\n\n### Claude Code (CLI)\n\nOne command:\n\n```bash\nclaude mcp add apexvol -e APEXVOL_API_TOKEN=avmcp_YOUR_TOKEN_HERE -- apexvol-mcp\n```\n\nOr add to your project's `.mcp.json` or global `~/.claude.json` by hand:\n\n```json\n{\n  \"mcpServers\": {\n    \"apexvol\": {\n      \"command\": \"apexvol-mcp\",\n      \"env\": {\n        \"APEXVOL_API_TOKEN\": \"avmcp_YOUR_TOKEN_HERE\"\n      }\n    }\n  }\n}\n```\n\n### Claude Desktop App\n\n**macOS**: Edit `~/Library/Application Support/Claude/claude_desktop_config.json`\n\n**Windows**: Edit `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"apexvol\": {\n      \"command\": \"apexvol-mcp\",\n      \"env\": {\n        \"APEXVOL_API_TOKEN\": \"avmcp_YOUR_TOKEN_HERE\"\n      }\n    }\n  }\n}\n```\n\n(Claude Desktop also supports the remote connector under Settings → Connectors — see Quickstart Option A.)\n\n### Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `APEXVOL_API_TOKEN` | Yes | Your ApexVol API token |\n| `APEXVOL_API_URL` | No | API URL (default: https://apexvol.com) |\n\n### Rate limits\n\n60 requests/min, 1,000/hour, 10,000/month per account — shared across local\nand remote modes. `apexvol-mcp --check` shows your remaining budget.\n\n## Usage\n\nAfter configuration, restart Claude Code or Claude Desktop to load the MCP server.\n\n### Example Queries\n\n**Volatility Analysis:**\n- \"What's the IV rank for AAPL?\"\n- \"Show me the volatility cone for SPY\"\n- \"Is there a volatility risk premium in TSLA?\"\n\n**Options Chain:**\n- \"Get the options chain for QQQ expiring next week\"\n- \"Find a 30 delta put on NVDA\"\n- \"What's the expected move for AMZN earnings?\"\n\n**Greeks & GEX:**\n- \"What's the gamma exposure for SPY?\"\n- \"Show me the GEX flip point for QQQ\"\n- \"Compare GEX across major indices\"\n\n**Flow Analysis:**\n- \"What's the options flow in AAPL today?\"\n- \"Any unusual options activity in META?\"\n- \"Scan for volatility arbitrage opportunities\"\n\n**Strategy Building:**\n- \"Build an iron condor on SPY\"\n- \"Analyze a 150/155 call spread on AAPL\"\n- \"What are the Greeks for selling a 200 put on NVDA?\"\n\n**Risk Management:**\n- \"Calculate portfolio Greeks for 100 AAPL shares and 1 AAPL 200 call\"\n- \"Run a stress test on my positions\"\n- \"How should I hedge my delta exposure?\"\n\n**Market Overview:**\n- \"What's the market overview today?\"\n- \"Show me stocks with high IV rank\"\n- \"What earnings are coming up this week?\"\n\n## Agent Skill\n\nThe repo ships an [Agent Skill](skills/options-analysis/SKILL.md) that\nteaches an AI assistant how to combine these tools into complete analyses —\nrich/cheap volatility assessment, earnings setups, premium-selling screens,\nGEX regime reads, and strategy stress-testing — with interpretation\nthresholds and error handling.\n\nTo use it with Claude Code, copy the skill into your skills directory:\n\n```bash\nmkdir -p ~/.claude/skills/options-analysis\ncurl -o ~/.claude/skills/options-analysis/SKILL.md \\\n  https://raw.githubusercontent.com/ryansilk/apexvol-mcp/main/skills/options-analysis/SKILL.md\n```\n\nClaude then loads it automatically whenever an options-analysis question\ncomes up (the MCP server itself must also be connected).\n\n## Response Format\n\nAll tools return structured data with a markdown summary:\n\n```json\n{\n  \"success\": true,\n  \"data\": { ... },\n  \"summary\": \"## AAPL IV Analysis\\n\\n| Metric | Value |\\n...\",\n  \"metadata\": {\n    \"timestamp\": \"2025-01-08T10:30:00\",\n    \"ticker\": \"AAPL\"\n  }\n}\n```\n\n## Authentication\n\nLocal mode uses token-based authentication; the remote connector uses OAuth\n(sign in with your ApexVol account, no token handling at all).\n\n### Token Format\n- Prefix: `avmcp_`\n- Length: 38 characters total\n\n### Getting a Token\n\nAPI and MCP access are included with **every paid ApexVol plan** (Basic\n$55/mo, Premium, Pro). Each tool returns the same data tier your web plan\nincludes; Pro unlocks the full toolset.\n\n1. Create and manage tokens at **apexvol.com/account → API Access** —\n   issuance, rotation, and revocation are all self-service.\n2. Questions or issues: **support@apexvol.com**.\n\nThe token is sent with every request, so treat it like a password. If it\nleaks, revoke it on the account page and create a new one.\n\n## Troubleshooting\n\n**Start with the health check** — it diagnoses most issues in one shot:\n\n```bash\nAPEXVOL_API_TOKEN=avmcp_YOUR_TOKEN_HERE apexvol-mcp --check\n```\n\n### \"Invalid or missing API token\"\n- Verify your `APEXVOL_API_TOKEN` environment variable is set correctly\n- Ensure your token hasn't been revoked (check apexvol.com/account → API Access)\n- Check that the token starts with `avmcp_`\n\n### \"Request timed out\"\n- Check your internet connection\n- The ApexVol platform may be temporarily unavailable\n\n### MCP Server Not Loading\n- Restart Claude Code/Desktop after configuration changes\n- Check that `apexvol-mcp` is in your PATH (`which apexvol-mcp`; pipx installs handle this automatically)\n- Verify the configuration JSON syntax is valid\n\n### Remote connector won't authorize\n- Confirm your ApexVol account has an active paid plan, then remove and\n  re-add the connector\n- The connector URL is exactly `https://apexvol.com/mcp-server` (no trailing slash)\n\n## Development\n\n### Running Locally\n\n```bash\n# Install in development mode\npip install -e \".[dev]\"\n\n# Run the server directly\npython -m apexvol_mcp.server\n```\n\n### Running Tests\n\n```bash\npytest tests/\n```\n\n## Support\n\nFor issues or questions:\n- Email: support@apexvol.com\n- Documentation: https://apexvol.com/docs/api\n- Setup guide: https://apexvol.com/learn/claude-options-data-mcp\n\n## License\n\nMIT — see [LICENSE](LICENSE). The client is open source; access to the\nApexVol platform itself remains gated by your subscription.\n\n<!-- mcp-name: io.github.ryansilk/apexvol-mcp -->\n",
  "bytes": 13757,
  "sha": "32b62b03ad9212eb84c934d3c3d4dffcc03efeb296e590c9169b247854cd39e0",
  "repo_slug": "ryansilk/apexvol-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_ryansilk_apexvol_mcp_223a0a9e/readme"
}