ApexVol Options Analytics

ApexVol MCP Server

AI アシスタントに ApexVol のオプション分析プラットフォームへのリアルタイムアクセスを提供する Model Context Protocol（MCP）サーバーです。オプションチェーン、IV ランク、ボラティリティリスクプレミアム、グリークス、ガンマエクスポージャー（GEX）、予想変動幅、戦略構築、市場スクリーニングに対応しています。44 個のツールを、1 つのコネクターで利用できます。

Claude Code、Claude Desktop、claude.ai（リモートコネクター — インストール不要）、および MCP 対応クライアントで利用できます。

• セットアップガイド（手順ごと）： https://apexvol.com/learn/claude-options-data-mcp
• REST API ドキュメント： https://apexvol.com/docs/api
• LLM のコンテキストウィンドウ向けにまとめた単一ファイルの API リファレンス： https://apexvol.com/docs/api/apexvol-api.md

クイックスタート

オプション A — リモートコネクター（インストール不要）

ApexVol は Claude のコネクターディレクトリに掲載されています。https://claude.ai/directory/apexvol を開くか、claude.ai または Claude Desktop で Customize → Connectors → Discover を選択して ApexVol を検索し、Connect to Claude を選択してください。

プロンプトが表示されたら ApexVol アカウントでサインインします（OAuth）。これで完了です。Python も設定ファイルも必要ありません。

手動で追加する場合（または別の MCP クライアントで使う場合）は、この URL をカスタムコネクターとして使用してください。

https://apexvol.com/mcp-server

Claude Code でもリモートサーバーを使用できます。

claude mcp add --transport http apexvol https://apexvol.com/mcp-server

続いて、プロンプトが表示されたら認証してください（/mcp コマンドでログイン状態を確認できます）。

オプション B — ローカルインストール（stdio）

pipx install apexvol-mcp
claude mcp add apexvol -e APEXVOL_API_TOKEN=avmcp_YOUR_TOKEN_HERE -- apexvol-mcp

利用には、月額 $55 からの有料 ApexVol プランが必要です。 各ツールは、ウェブプランに含まれるものと同じデータティアを返します。Pro ではすべてのツールセットを利用できます。トークンは apexvol.com/account → API Access でセルフサービスで取得できます。

セッション例

実際の出力、2026-08-15：

あなた： SPY の IV ランクは？

Claude は get_iv_rank("SPY") を呼び出します：

指標	値
現在の IV	12.3%
IV ランク	7.8
IV パーセンタイル	8.3%
52 週間の最低値	11.2%
52 週間の最高値	25.0%

評価：低水準 — プレミアムを売るより買うことを検討してください。

「では、ここではアイアンコンドルよりカレンダースプレッドのほうがよいですか？」といった追加の質問にも対応できます。同じ会話の中で Claude が期間構造を取得し、両方の戦略を構築してグリークスを比較できるためです。

アーキテクチャ

Remote (no install)
┌─────────────────────────┐            ┌──────────────────────────────┐
│ claude.ai / Desktop /   │── OAuth ──▶│ https://apexvol.com/mcp-server│
│ Claude Code (HTTP)      │            │ (streamable HTTP)             │
└─────────────────────────┘            └──────────────────────────────┘

Local (stdio)
┌─────────────────────┐               ┌─────────────────────┐
│ Claude Code/Desktop │               │ apexvol.com         │
│         │           │               │                     │
│         ▼           │               │                     │
│   ApexVol MCP       │──── HTTPS ───▶│  /api/mcp/data/...  │
│   (runs locally)    │               │                     │
└─────────────────────┘               └─────────────────────┘

ローカルサーバーはお使いのマシン上で動作し、ApexVol プラットフォーム API を呼び出します。リモートサーバーは同じツールセットを ApexVol がホストするもので、トークンの代わりに OAuth で認証します。

機能

• 43 個の分析ツール — すべての /api/mcp/data エンドポイントを Claude から利用できます
• 組み込みリファレンス — help ツールは、API ドキュメントの同梱コピーから「X を取得できるツールはどれですか？」という質問に回答します。また、クライアントのプロンプトピッカーには 41 個のプロンプトが表示されます。内訳は、スターターが 33 個（各データファミリーにつき 3 個）と、ジョブ全体のレシピが 8 個です
• 自然言語インターフェース - 「SPY の IV ランクは？」のような質問ができます
• リモートまたはローカル - OAuth 対応のホスト型コネクター、または pipx でインストールする stdio サーバー
• トークン認証 - API トークンを安全に検証します（ローカルモード）
• 組み込みヘルスチェック - apexvol-mcp --check でインストールとトークンを確認できます

利用可能なツール

オプションチェーン（6 個のツール）

• get_options_chain - 任意のティッカーの完全なオプションチェーン
• get_expirations - 利用可能な満期日
• get_options_by_delta - 指定したデルタのオプションを検索
• get_stock_price - 現在の価格と企業情報
• calculate_expected_move - ストラドル価格に基づく予想変動幅。tickers="SPY,AAPL,NVDA" を指定すると、1 回の呼び出しで最大 25 銘柄の価格を取得します（0.1.4）
• get_historical_chain - 過去の任意の取引日のチェーンスナップショット

ボラティリティ分析（7 ツール）

• get_iv_rank - IV ランクとパーセンタイル。tickers="SPY,QQQ,IWM" を指定すると、1 回の呼び出しで最大 25 銘柄を順位付けします（0.1.4）
• get_volatility_cone - IV と過去の実現ボラティリティの比較
• get_volatility_risk_premium - VRP（IV から RV を差し引いた値）
• get_term_structure - 満期ごとの IV
• find_iv_opportunities - 平均回帰の機会
• get_vix_snapshot - VIX の水準と期間構造の状態
• get_monies_surface - 平滑化されたボラティリティサーフェス。インプライド、予測、またはモデルと市場の比較

グリークスと GEX（5 ツール）

• get_gex - 権利行使価格別のガンマエクスポージャー。tickers= で最大 25 銘柄をまとめて取得でき、strikes_around と detail でペイロードのサイズを調整します（0.1.4）
• get_charm_exposure - デルタ減衰エクスポージャー
• get_third_order_greeks - スピード、ゾンマ、カラー、ヴォンマ、ウルティマ
• get_greeks_heatmap - 権利行使価格と満期ごとのグリークス
• get_cross_index_gex - 指数間の GEX を比較

オプションフロー（3 ツール）

• get_options_flow - フローと異常な取引（市場休場中は引け時点の数値を返します。出来高フィードが途絶えた場合も、ゼロではなく説明を添えて回答します）。limit と detail で行リストのサイズを調整します（0.1.4）
• get_smart_money_flow - 機関投資家のフローパターン ⚠️ 上記と同じ制限があります
• scan_volatility_arb - 指数間のボラティリティ・アービトラージ

戦略の構築（5 ツール）

• build_strategy - オプション戦略を構築します（アイアンコンドル、スプレッドなど）
• analyze_strategy - 損益とグリークスの詳細分析
• optimize_strategy - 最適な権利行使価格を検索
• simulate_option_chain - Black-Scholes による仮想再価格設定（価格／DTE／IV の変動）
• calculate_probability_of_profit - 任意のレッグ構成に対する PoP

リスク管理（4 ツール）

• calculate_portfolio_greeks - ポートフォリオのグリークスを集計
• run_scenario_analysis - 仮想シナリオ分析
• generate_stress_tests - ストレステストの結果
• get_hedge_recommendations - デルタヘッジの提案（株式＋オプションのレッグ）

ポジションは JSON 配列（ticker、position_type、quantity、strike、 expiration、Greeks）で渡します。まず get_options_chain からオプションのグリークスを取得してください。株式のみのポートフォリオであれば、プレーンテキスト（「AAPL 100 shares」）も使用できます。

イベントとスクリーニング（5 ツール）

• get_earnings_calendar - 今後の決算
• analyze_earnings_history - 過去の決算時の値動き
• screen_market - 市場のスクリーニング（高 IV、異常な出来高など）
• get_market_overview - 市場全体のボラティリティ概要
• get_economic_calendar - マクロ経済イベント（CPI、FOMC、雇用統計など）

ティッカー分析（8 ツール）

• get_ticker_analytics - 1 つのツールで 8 種類の分析に対応：skew、dividends、 borrow_rate、correlation、hv_regimes、price_context、 relative_value、greeks_exposure
• get_earnings_move_analysis - 7 種類の分析に対応：mispricing、historical_moves、 expected_vs_actual、verdict、seasonality、post_drift、iv_crush
• get_max_pain - マックスペインの権利行使価格と損失プロファイル
• get_volume_profile - 権利行使価格別の出来高／OI と、OI に基づくサポート／レジスタンス
• get_zero_dte - 0DTE のガンマ、反転水準、マックスペイン、セータ減衰（SPY／QQQ／SPX など）。strikes_around と detail でチェーンのサイズを調整します（0.1.4）
• get_orats_cores - フィールド選択に対応したベンダーの生データ行（340 以上のフィールド）
• search_tickers - 銘柄名からシンボルを特定／対応状況を確認
• scan_relative_value - 市場全体を対象とした IV／SPY の平均回帰分析とペアスキャン

ヘルプと検索（1 ツール）

• help - サーバー内の API リファレンスです。help() ではカテゴリーの一覧と 質問方法を表示します。help("get_iv_rank")、help("gex")、または help("/iv-rank/{ticker}") では、ツール、カテゴリー、またはエンドポイントのレコード （質問、パラメーター、単位、基準、フィールド、プラン、プロンプト、ドキュメント URL）を返します。 それ以外の語句は検索として処理されます。同梱データを使用するためリクエスト料金はかからず、トークン設定前でも利用できます。

プロンプトの候補

このサーバーには41個のプロンプトも登録されており、各データファミリーにつき3個、各レシピにつき1個あります。これらはClaude Desktop、Cursor、VS Codeのプロンプトピッカーに表示されます。各プロンプトには実際のデフォルト値が設定されたティッカー引数があり、回答に使用するツールが記載され、ファミリーのページへのリンクが含まれています。文言はプロンプトライブラリと一致しています。

インストール（ローカルモードの詳細）

前提条件

• Python 3.10+
• ApexVolの有料プランとAPIトークン（下記の「トークンの取得」を参照）

パッケージのインストール

apexvol-mcpコマンドを分離し、常にPATH上で使えるようにするため、pipxをおすすめします。

pipx install apexvol-mcp

通常のpip install apexvol-mcpも使用できます。

または、ソースからインストールします。

git clone https://github.com/ryansilk/apexvol-mcp.git
cd apexvol-mcp
pip install -e .

インストールの確認

Claudeの設定を変更する前に、コマンドが動作し、トークンで認証できることを確認してください。

APEXVOL_API_TOKEN=avmcp_YOUR_TOKEN_HERE apexvol-mcp --check

--checkはクライアントのバージョン、認証結果、残りのレート制限／月間利用枠を表示します。OKと表示されれば、あとはClaudeに接続するだけです。

設定

Claude Code（CLI）

次の1つのコマンドを実行します。

claude mcp add apexvol -e APEXVOL_API_TOKEN=avmcp_YOUR_TOKEN_HERE -- apexvol-mcp

または、プロジェクトの.mcp.jsonかグローバルの~/.claude.jsonに手動で追加します。

{
  "mcpServers": {
    "apexvol": {
      "command": "apexvol-mcp",
      "env": {
        "APEXVOL_API_TOKEN": "avmcp_YOUR_TOKEN_HERE"
      }
    }
  }
}

Claude Desktop App

macOS：~/Library/Application Support/Claude/claude_desktop_config.jsonを編集します

Windows：%APPDATA%\Claude\claude_desktop_config.jsonを編集します

{
  "mcpServers": {
    "apexvol": {
      "command": "apexvol-mcp",
      "env": {
        "APEXVOL_API_TOKEN": "avmcp_YOUR_TOKEN_HERE"
      }
    }
  }
}

（Claude Desktopは、Claudeのコネクターディレクトリからリモートコネクターを使うこともできます。クイックスタートのオプションAを参照してください。）

環境変数

変数	必須	説明
APEXVOL_API_TOKEN	はい	ApexVol APIトークン
APEXVOL_API_URL	いいえ	API URL（デフォルト：https://apexvol.com）

レート制限

アカウントあたり毎分60リクエスト、毎時1,000リクエスト、毎月10,000リクエストです。ローカルモードとリモートモードで共有されます。apexvol-mcp --checkで残りの利用枠を確認できます。

使い方

設定後、Claude CodeまたはClaude Desktopを再起動してMCP サーバーを読み込みます。

質問例

ボラティリティ分析：

• 「AAPLのIVランクは？」
• 「SPYのボラティリティコーンを表示して」
• 「TSLAにはボラティリティ・リスクプレミアムがありますか？」

オプションチェーン：

• 「来週が満期のQQQのオプションチェーンを取得して」
• 「NVDAのデルタ30のプットを探して」
• 「AMZNの決算で予想される値動きは？」

グリークスとGEX：

• 「SPYのガンマエクスポージャーは？」
• 「QQQのGEXフリップポイントを表示して」
• 「主要指数のGEXを比較して」

フロー分析：

• 「今日のAAPLのオプションフローは？」
• 「METAで異常なオプション取引はありますか？」
• 「ボラティリティ・アービトラージの機会をスキャンして」

戦略の構築：

• 「SPYのアイアンコンドルを構築して」
• 「AAPLの150/155コールスプレッドを分析して」
• 「NVDAの200プットを売る場合のグリークスは？」

リスク管理：

• 「AAPL株100株とAAPL 200コール1枚のポートフォリオ・グリークスを計算して」
• 「保有ポジションのストレステストを実行して」
• 「デルタエクスポージャーをどのようにヘッジすればよいですか？」

マーケット概要：

• 「今日のマーケット概要は？」
• 「IVランクの高い銘柄を表示して」
• 「今週予定されている決算は？」

エージェントスキル

リポジトリにはエージェントスキルが含まれており、AI アシスタントがこれらのツールを組み合わせて包括的な分析を行う方法を学べます。分析には、ボラティリティの割高／割安評価、決算に向けた戦略、プレミアム売却銘柄のスクリーニング、GEXのレジーム分析、戦略のストレステストが含まれ、判断基準とエラー処理も扱います。

Claude Codeで使用するには、スキルをスキルディレクトリにコピーします。

mkdir -p ~/.claude/skills/options-analysis
curl -o ~/.claude/skills/options-analysis/SKILL.md \
  https://raw.githubusercontent.com/ryansilk/apexvol-mcp/main/skills/options-analysis/SKILL.md

その後、オプション分析に関する質問があると、Claudeは自動的にこのスキルを読み込みます（MCP サーバーも接続しておく必要があります）。

応答形式

すべてのツールは、Markdown形式の要約を含む構造化データを返します。

{
  "success": true,
  "data": { ... },
  "summary": "## AAPL IV Analysis\n\n| Metric | Value |\n...",
  "metadata": {
    "timestamp": "2025-01-08T10:30:00",
    "ticker": "AAPL"
  }
}

認証

ローカルモードではトークンベースの認証を使用し、リモートコネクターではOAuthを使用します（ApexVolアカウントでサインインするため、トークンを扱う必要はありません）。

トークン形式

• プレフィックス：avmcp_
• 長さ：合計38文字

トークンの取得

API と MCP へのアクセスは、すべての有料 ApexVol プラン（Basic $55/mo、Premium、Pro）に含まれています。各ツールが返すデータの範囲は、ウェブプランに含まれるものと同じです。Pro では、すべてのツールセットを利用できます。

1. トークンは apexvol.com/account → API Access で作成・管理できます。発行、ローテーション、失効はすべてセルフサービスで行えます。
2. ご質問や問題については、[email protected] までお問い合わせください。

トークンはすべてのリクエストとともに送信されるため、パスワードと同様に扱ってください。漏えいした場合は、アカウントページで失効させ、新しいトークンを作成してください。

トラブルシューティング

まずヘルスチェックを実行してください — ほとんどの問題を一度に診断できます。

APEXVOL_API_TOKEN=avmcp_YOUR_TOKEN_HERE apexvol-mcp --check

「API トークンが無効または設定されていません」

• APEXVOL_API_TOKEN 環境変数が正しく設定されていることを確認してください
• トークンが失効していないことを確認してください（apexvol.com/account → API Access を確認）
• トークンが avmcp_ で始まっていることを確認してください

「リクエストがタイムアウトしました」

• インターネット接続を確認してください
• ApexVol プラットフォームが一時的に利用できない可能性があります

MCP サーバーが読み込まれない

• 設定を変更した後、Claude Code/Desktop を再起動してください
• apexvol-mcp が PATH に含まれていることを確認してください（which apexvol-mcp。pipx でインストールした場合は自動的に処理されます）
• 設定 JSON の構文が有効であることを確認してください

リモートコネクターが認証されない

• ApexVol アカウントに有効な有料プランがあることを確認してから、コネクターを削除し、再度追加してください
• コネクターの URL が正確に https://apexvol.com/mcp-server であることを確認してください（末尾のスラッシュは不要です）

開発

ローカルでの実行

# Install in development mode
pip install -e ".[dev]"

# Run the server directly
python -m apexvol_mcp.server

テストの実行

pytest tests/

サポート

問題やご質問については、以下をご利用ください。

• メール：[email protected]
• ドキュメント：https://apexvol.com/docs/api
• セットアップガイド：https://apexvol.com/learn/claude-options-data-mcp

ライセンス

MIT — LICENSE を参照してください。クライアントはオープンソースですが、ApexVol プラットフォーム自体へのアクセスには、引き続きサブスクリプションが必要です。