GammaRips Options Intelligence

GammaRips MCP サーバー

AI エージェント向けのオプションフロー分析のプリミティブです。

毎取引日の夜、GammaRips は流動性に基づいて取引可能な米国銘柄 3,532 件をランク付けし、上位 100 件を選び、その中から強気の銘柄を残して、それぞれにアウト・オブ・ザ・マネーのコールを 1 つ価格設定します。これにより、エージェントが実際に取引できる約 40～50 件の契約プールができます。この MCP サーバーは、独自のエージェントを持ち込むトレーダーに、そのプールと分析の基盤を提供します。具体的には、特定時点の特徴量、実現した機会サーフェス（出口を適用しない最大有利変動／最大不利変動）、ブラケットの結果ラベル、レジームのコンテキスト、手法プレイブックを利用できます。

数値で見る、より質の高い契約。 このプールは契約の流動性に基づいて選定されています。流動性ルールが導入されてから（2026-08-24、1,301 件の契約）、建玉の中央値は 4,664、セッション出来高の中央値は 1,039 です。導入前の 60 日間のスキャンでは、それぞれ 906 と 232 でした。流動性の最も低い 10％でも、建玉は 1,635 で、導入前の 29 を上回ります。60 日間の調査では、10:00 ET のエントリー時に約定しない割合が 40.5％から 6.1％に低下しました。流動性の高い契約なら、提示価格に近い価格でエントリーし、決済できます。

設計原則：推奨ではなく、プリミティブを提供します。 「何を買うべきか」を返すエンドポイントはありません。すべてのエージェントが同じデータに基づいて、それぞれ独自の契約と独自の決済方法を判断します。データはペーパートレードの調査用です。教育目的のみであり、投資助言ではありません。

ホステッド MCP エンドポイント

• Streamable HTTP（推奨）： https://mcp.gammarips.com/mcp
• SSE（レガシー、廃止予定期間中）： https://mcp.gammarips.com/sse
• ステートレス JSON-RPC： https://mcp.gammarips.com/jsonrpc
• サーバーカード： https://mcp.gammarips.com/.well-known/mcp/server-card.json
• OAuth エンドポイント（チャットクライアント向け）： https://mcp.gammarips.com/pro。同じ サーバーで、同じ 9 種類のツールを提供しますが、認証情報が必要です。そのため、ChatGPT、Claude （claude.ai／Desktop）、Cursor、および OAuth 2.1 に対応するすべての MCP クライアントは、 追加時に GammaRips へのサインインを提示します。サブスクリプションのティアは トークンに含まれます。検出先：/.well-known/oauth-protected-resource/pro； 認可サーバー：https://gammarips.com。
• 認証： 2 種類の認証情報で、ティアは共通です。（1）API キー：gr_live_... を Authorization: Bearer <key>（または X-API-Key）として指定します。ヘッダーを送信できる クライアント向けです。（2）OAuth 2.1 アクセストークン。サインイン後に gammarips.com が発行する トークン（チャットクライアント向け）、または client_credentials を使ってマシンクライアントが取得する トークン（ヘッドレスエージェント向け。下記参照）です。無料ティアのツールは、認証情報なしで /mcp から 利用できます。4 種類のプロ向けツールには、どちらの認証情報を使う場合も有効なサブスクリプションが必要です。強制適用 は有効です。gammarips.com/pricing でアクセス権を取得してください。

利用可能なツール（9）

V4（2026-07-17）では、V3 の29個のツールからなる構成が9個に統合されました。統合されたツールの機能は、これら9個のツールの view= / granularity= モードとして引き続き利用できます。web_search は削除されました。

無料プラン（キー不要）：get_pool、get_regime_context、 get_market_calendar_status、get_playbook、get_daily_report。 Pro プラン（Agent Access、月額29ドルのキー）：get_signal、get_liquidity、 query_outcomes、replay_contract。

• get_pool （無料） — 候補プール：view="enriched"（厳選されたナラティブ／テクニカル／コントラクト／mom_60 を含む、デフォルトのリーク対策済みビュー）、 "raw"（厳選前のスキャン）、"features"（許可リストビューからの時点別特徴量ベクトル）、"preview"（公開ティーザー）。
• get_signal （Pro） — 1つのティッカー：view="detail"（詳細なエンリッチメント、 デフォルト）または view="earnings"（ドクトリンに基づく決算ウィンドウチェック）。
• get_liquidity （Pro） — エントリー日の最新流動性：単一の contract （キャッシュ優先。上流データを強制取得するには live=true）またはプール全体／ contracts のショートリストを1回の呼び出しで取得します。このデータプランには気配値フィールドはありません。
• query_outcomes （Pro） — view= で取得する、アウトカムと証跡の基盤： labels（行単位のブラケットラベルと特徴量。デフォルト）、summary（グループ化された集計）、 surface（コントラクトごとの MFE/MAE 変動。決済なし — aggregate_only=True ではウィンドウ全体の MFE/MAE 分位点を取得できます。行モードは200行に制限され、 truncated / matched_rows / partial_scan_date で制限状況を示すため、決済設計にはこのモードを使用してください）、 harvest（タッチ確率曲線）、exit_rule（独自のブラケット／トレーリングルールを評価）、 signal_performance / win_rate（原資産の方向に基づくものであり、オプションの損益ではありません）、 positions / performance（エンジンが記録した実現済みのペーパートレード証跡。コホートでフィルタリングされます）。ライブコホートは V7_1_TILTED_GIGO と エントリー日が cohort_start（2026-08-10）以降であることの両方で定義され、レスポンスにも含まれるようになりました。同じラベルのまま台帳に残されている、エンジンが無効としたコホートもあるため、ポリシーラベルだけではコホートを定義できません。リセット直後は、ライブコホートが正当に空の場合があります。total_trades: 0 で集計値が null の場合は、「決済済み取引がまだ蓄積されていない」という意味であり、「勝率0％」を意味するものではありません。policy_version="all" ではすべての時代のデータにアクセスできますが、エンジンが無効としたコホートも含まれるため、実績としては扱えません。
• replay_contract （Pro） — 独自の決済ルールに使う生の価格テープ： granularity="minute"（日中の価格推移と正確な初回到達点。デフォルト）または "day"（日次 OHLCV の評価系列）。このサーバーは決済をシミュレートしません。
• get_regime_context （無料） — スキャン日時点の VIX/VIX3M/SPY トレンドと、フェイルクローズ方式のレジームレール。
• get_market_calendar_status （無料） — view="status"（NYSE の取引開始／終了時刻。デフォルト）、 view="scan_dates"（データのあるスキャン日）、または view="freshness"（プールが適切かどうか。想定されるスキャン日、各パイプライン段階のステータス、get_pool が返すスキャン日、機械判定可能な reasons を含むフェイルクローズ方式の fresh フラグを返します）。
• get_playbook （無料） — 方法論とリファレンス：引数なしではカタログを一覧表示します。name= ではプレイブック（start-here、daily-workflow、 run-your-own-tournament、exit-lab、leakage-and-data-contract、 changelog）を取得し、name="schema" では機械可読なデータコントラクト（列ごとのリーク分類）を取得します。field= では任意のシグナルフィールドの説明を取得します（LLM を使用しない決定論的な処理）。プレイブックは MCP リソース（gammarips://playbooks/{name}）としても利用できます。
• get_daily_report （無料） — view="report"（日次レポート全体。デフォルト）または view="list"（最近のレポート）。

削除済み

web_search（V4）。エンジン独自の日次選定結果は当日には公開されません（get_todays_pick / list_todays_picks / get_open_position は V3 で削除済みです）。実現済みの取引証跡は query_outcomes(view="positions") から引き続き取得できます。

プロンプト

morning_brief、analyze_candidate(ticker)、run_your_own_tournament — 上記のツールを組み合わせたシンプルなオーケストレーションです。いずれも銘柄の選定結果は返しません。

クイック接続

Claude Code

# Free tier (no key):
claude mcp add --transport http gammarips https://mcp.gammarips.com/mcp

# Pro (with your key):
claude mcp add --transport http gammarips https://mcp.gammarips.com/mcp \
  --header "Authorization: Bearer gr_live_your_key"

# Pro with OAuth instead of a key (sign in once in the browser, tokens refresh):
claude mcp add --transport http gammarips https://mcp.gammarips.com/pro
# then run /mcp inside Claude Code and choose "Authenticate"

ChatGPT、Claude（claude.ai / Desktop）、その他の OAuth チャットクライアント

カスタムコネクター／リモート MCP サーバーを、次の URL で追加します。 https://mcp.gammarips.com/pro。クライアントは認可サーバー （gammarips.com）を検出し、自身を登録して（Client ID Metadata Document または動的登録）、GammaRips のサインイン＋同意ページを開きます。貼り付けるキーはありません。 まだサブスクリプションに登録していない場合でも、接続は機能し、プロツールには登録手順が表示されます。プロへのアクセスは、登録後の次回のトークン更新時（1 時間以内）、または再接続時に適用されます。

ヘッドレスエージェント（VM、cron、サーバー）：マシンクライアント

ブラウザーも人間も介さずに動作するエージェントの場合は、 gammarips.com/account でマシンクライアントを作成します（Agent Access が必要です）。 client_id と client_secret を取得できます（表示は一度限りです）。client_credentials グラントを使って 1 時間有効なアクセストークンを発行し、ベアラートークンとして送信します。

TOKEN=$(curl -s -u "$GR_CLIENT_ID:$GR_CLIENT_SECRET" \
  -d grant_type=client_credentials \
  -d resource=https://mcp.gammarips.com/pro \
  https://gammarips.com/oauth/token | jq -r .access_token)

# Claude Code headless (claude -p), with the token in .mcp.json:
#   { "mcpServers": { "gammarips": { "type": "http",
#       "url": "https://mcp.gammarips.com/pro",
#       "headers": { "Authorization": "Bearer ${GAMMARIPS_MCP_TOKEN}" } } } }
GAMMARIPS_MCP_TOKEN="$TOKEN" claude -p "..." 

実行のたびに発行してください。マシンクライアントにはリフレッシュトークンがなく、発行のたびにサブスクリプションからプランが再読み込みされます。同じ用途には API キーも引き続き使えます。マシンクライアントは有効期間の短い認証情報を使う方法です。

Cursor

最も簡単な方法 — プラグインをインストールします。 このリポジトリは Open Plugins 標準のプラグイン（.cursor-plugin/plugin.json）で、ホスト型 MCP サーバーと、データに基づき助言を行わないワークフローをエージェントに教える gammarips-options-flow スキルがバンドルされています。プラグインマーケットプレイスで「GammaRips」を検索してインストールするか、このリポジトリを Cursor に指定してください。無料プランではそのまま接続できます。プロツールを使うには gr_live_... キーを追加してください。

手動で設定する場合：Settings → MCP → Add new MCP server を選ぶか、.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "gammarips": {
      "url": "https://mcp.gammarips.com/mcp",
      "headers": { "Authorization": "Bearer gr_live_your_key" }
    }
  }
}

無料プランでは headers を省略してください。

Cline

MCP Servers → Remote Servers → Add を選ぶか、cline_mcp_settings.json に追加します。

{
  "mcpServers": {
    "gammarips": {
      "url": "https://mcp.gammarips.com/mcp",
      "type": "streamableHttp",
      "headers": { "Authorization": "Bearer gr_live_your_key" }
    }
  }
}

無料プランでは headers を省略してください（匿名で使えるツールは 5 つです）。

汎用 MCP 設定

{
  "mcpServers": {
    "gammarips": {
      "url": "https://mcp.gammarips.com/mcp"
    }
  }
}

SSE のみをサポートするクライアントは、廃止期間中、従来の /sse エンドポイントを使用できます。

無料プランはアカウントなしで利用できます：get_pool、get_regime_context、get_market_calendar_status、get_playbook、get_daily_report。プロツール（get_signal、get_liquidity、query_outcomes、replay_contract）の利用には Agent Access（月額 $29、30 日間無料トライアル）が必要です。gammarips.com でキーを生成するか、/pro 経由で接続してサインインしてください。

ローカル開発

前提条件

• Python 3.10+
• 任意：Docker

セットアップ

git clone https://github.com/DevDizzle/gammarips-mcp.git
cd gammarips-mcp
python -m venv .venv
source .venv/bin/activate
pip install -e .
cp .env.example .env

ローカルで実行

PYTHONPATH=src python src/server.py

サーバーは 0.0.0.0:${PORT:-8080} にバインドし、/mcp で Streamable HTTP（SSE フォールバック）を提供します。

Docker

docker build -t gammarips-mcp .
docker run --rm -p 8080:8080 --env-file .env gammarips-mcp

環境変数

現在の環境変数については .env.example を参照してください。一般的な値は次のとおりです。

• GCP_PROJECT_ID
• FIRESTORE_DATABASE
• GCS_BUCKET_NAME
• LOG_LEVEL
• PORT
• REQUIRE_API_KEY / AUTH_SHADOW（API キーによるゲートモード）
• OAUTH_ENABLED / OAUTH_ISSUER / OAUTH_JWKS_URL / OAUTH_MCP_RESOURCE_ORIGINS （OAuth 2.1 リソースサーバー。デフォルトは本番環境です。src/utils/oauth.py を参照）

検証

Python のコンパイルチェック

python -m compileall src

Docker のビルドチェック

docker build -t gammarips-mcp:test .

デプロイ

デプロイは手動です（CD ワークフローは削除されました。.github/workflows/ci.yml は main へのプッシュ／PR 時に ruff format --check と ruff check のみを実行します）。

デプロイスクリプトで新しいリビジョンをリリースします。このスクリプトは Cloud Run のソースデプロイを使用し、本番環境の設定を正確に再現します（Secret Manager 経由のシークレット、 REQUIRE_API_KEY=false）。

bash scripts/deploy.sh

同等のワンライナー：

gcloud run deploy gammarips-mcp --source=. \
  --project=profitscout-fida8 --region=us-central1 \
  --set-env-vars="REQUIRE_API_KEY=false" \
  --set-secrets="POLYGON_API_KEY=POLYGON_API_KEY:latest,GOOGLE_API_KEY=GOOGLE_API_KEY:latest,GOOGLE_CSE_ID=GOOGLE_CSE_ID:latest"

API キーは Secret Manager からマウントします。通常の環境変数として渡さないでください（シークレットのマウントが上書きされます）。

データの公開範囲を変更するデプロイを行う前に、必ず gammarips-review による情報漏えい監査を実行してください（docs/MCP-V3-SPEC.md §2.4 を参照）。

セキュリティ

信頼モデルについては SECURITY.md をご覧ください。読み取り専用の保証、パラメーター化クエリによる SQL インジェクション対策、レスポンスサイズの上限、IP ごとのレート制限、サニタイズされたエラー、情報漏えいを防ぐビュー、列分類のデータコントラクト、および OAuth 2.1 リソースサーバーモデル（このサービスはトークンの検証のみを行い、gammarips.com が認可サーバーです）について説明しています。

ライセンス

MIT