optionality-mcp

optionality-mcp

AI が評価するオプション取引練習ゲーム向けの MCP サーバーと React ドリル UI です。FastMCP を基盤に構築されています。

Optionality は、Tollbooth-DPYC™ サービスの一例です。エンゲージメントは、便利な Don't Pester Your Customer™（DPYC™）Bitcoin 決済で収益化されます。利用者は Lightning 経由で残高を事前にチャージし、リクエストごとの決済手続きを行わずにプレイできます。料金はすべて動的で、運営者が設定します。Welcome ページにはリアルタイムの料金が表示されます。利用者は Tollbooth-DPYC クーポンを入力して、提供されている割引を利用することもできます。

ラウンドの流れ

1. ディーラーが配ります。 ディーラー役の LLM が、ティッカー、スポット価格、IV レジームとスキュー、マクロ環境、カタリスト、重要な価格水準、制約条件を含む、完全なオプション取引シナリオを作成します。任意で、ストラクチャーが満たすべき最大損失予算も指定できます。
2. あなたが提案します。 上級 PM に提案するように、自由記述で回答します。複数レッグのストラクチャー、単一レッグ、あるいは意図的に見送る選択肢があり、取引を見送ることも正当な採点対象の回答です。
3. ジャッジが評価します。 ジャッジ役の LLM があなたの提案を解析してレッグを構造化し、6 つの評価軸で採点します。また、リスクチャートに重ねて表示できる代替ストラクチャーを提示します。

6 つの評価軸： 戦略選択、権利行使価格と期間、リスクとリターン、マクロ環境の考慮、テールリスク、コミュニケーション。それぞれ 0～20 点で、合計 0～100 点のスコアとなり、A+ から F までのレターグレードに換算されます。

中心となる教育手法 — ミスリーディングな情報

各シナリオには、事実としては正しいものの重要ではない情報が 1～2 件含まれており、物語の中に自然に織り込まれていて、明示されることはありません。それを取引の判断材料として挙げると受講者は減点され、ノイズと見抜いて無視すると加点されます。読むものすべてが事実である相場の中から、シグナルを見分ける訓練です。

各評価には 事実台帳 が付属します。シナリオのどの事実を取り入れたか、見落としたか、ミスリーディングな情報を見抜いたか、あるいは判断材料にしたかが記録されます。

シナリオモードと難易度

史実性の 3 つのモード：

• 歴史フィクション — SVB 危機の週や英国債危機など、実際に特定できる市場の局面を題材にし、当日の実際のマクロ環境と IV レジームに基づきます
• フィクション — 反実仮想のショック、ペッグ解除の連鎖、ガンマスクイーズなど、架空の市場環境を扱います
• ライブイベント — 今週の実際の相場に基づき、Web 検索で裏付けられたシナリオを、出典付きで提示します

4 つの難易度ペルソナ： 見習い、熟練者、達人、至高者。リーダーボードのポイントには難易度が反映されるため、簡単なモードで順位を上げることはできません。マリガンモードでは、すでに評価されたシナリオを新たにプレイできます。

オプションの数理 — 唯一の信頼できる情報源

サーバーはディーラーが用意した骨組みから、3 つの満期、スポット価格を中心とした権利行使価格の段階、プット買いのスキューを反映する 3 点アンカーの IV スマイルを含む完全なオプションチェーンを構築し、Black–Scholes で価格を算出します。同じ計算処理がクライアント側でも実行されるため、受講者、チャート、ジャッジはすべて同一の数値を確認できます。

• ブローカーの慣習に沿ったオプションチェーンのモーダル：左にコール、中央に権利行使価格と IV スマイル、右にプットを配置。ミッド価格をタップして売買し、ネットプレミアムを随時表示します
• 満期時の損益、損益分岐点マーカー、保有期間中のセータ減少を再生する DTE スライダーを備えたリスクプロファイルチャート
• あなたのペイオフ曲線と、ジャッジが選ぶストラクチャーを比較するジャッジの代替案オーバーレイ

ソクラテス式ヒントデスク

シナリオの途中でも、何でも質問できます。教育的な質問には、数式に基づいた直接的な回答を返します。戦術的な質問には、より深く考える価値のある評価軸へと誘導します。判断の責任は受講者にあります。ヒントデスクがシナリオに隠された事実やミスリーディングな情報を明かすことはありません。ヒントを使うと採点で減点されます。

ジャーナル、リーダーボード、ピアラーニング

• ジャーナル — すべてのラウンドを保存します。未公開の下書き、提出済みのピッチ、レッグ別の表とチャートを含む完全な評価を確認できます
• リーダーボード — 6 種類の並べ替え（加重平均、加重ベスト、単純平均、単純ベスト、連勝、プレイ数）に対応し、モードと難易度で絞り込めます
• 連勝 — 70 点以上の連続スコアを、現在と過去の全期間にわたって表示します
• エントリーの共有 — 評価済みのラウンドを共有するようオプトインすると、ほかの人がピッチ、評価、台帳を参照できます
• プロフィール — 表示名、アバター、自己紹介
• 利用状況 — モデルごとのトークン消費量、ツールごとの支出、利用者のアカウント明細を表示する透明性タブ

オプションの Nsec エスクロー

NIP-07 署名機能のないデバイス（たとえば iPad）を使う利用者は、Optionality にゲーム専用の nsec を預け、代わりに Nostr DM に署名してもらうようオプトインできます。escrow_nsec は新たに生成した nsec を預け入れます（利用者の npub に対応している必要があります）。nsec は保存時に暗号化され、その npub にひも付けられます。send_patron_dm はその nsec を使って利用者として DM に署名し、公開します。get_escrow_status は nsec が預けられているかどうかを返します。withdraw_nsec は nsec を一度だけ返して削除します。その後、利用者は自身の Nostr クライアントで鍵を管理します。NIP-07 署名機能を使った自己管理には、これらは必要ありません。

リポジトリ構成

optionality-mcp/
├── server.py    # FastMCP server (Python) → Horizon
├── tools/       # dealer, judge, journal, leaderboard, profile, options chain, nsec escrow
├── db/          # Neon persistence (journal, leaderboard, patrons, usage, migrations)
├── llm.py       # server-side LLM client (operator's vaulted llm_api_key)
├── prompts.py   # dealer / judge / clue-desk personas
├── modal_app.py # detached runner for the LLM drills (Modal)
└── frontend/    # React 19 + Vite + TS UI → Cloudflare Pages

負荷の高い LLM ツール（deal、judge、clue desk）は、クレームチェック方式の非同期パターンを使用します。呼び出しはクレームをすぐに返し、クライアントは無料の取得ツールをポーリングするため、処理に時間のかかる生成もクライアントのタイムアウトを超えて継続できます。運用者が Modal の認証情報を設定している場合、これらのジョブは MCP ホスト上ではなく、Modal 上で分離して実行されます（modal_app.py）。

DPYC エコシステム

optionality-mcp は DPYC フェデレーションに属する 1 つの Operator です。これは、Nostr の ID モデル、Bitcoin Lightning 決済、tollbooth-dpyc SDK を共有する独立した MCP サーバー群です。関連リポジトリは次のとおりです。

リポジトリ	役割
tollbooth-dpyc	Python SDK — ボールト、認証、料金設定、Lightning、Nostr ID
dpyc-community	ガバナンスレジストリ：メンバーシップ、勧告、脅威モデル
dpyc-oracle	コミュニティコンシェルジュ（無料のオンボーディングとメンバー検索）
tollbooth-authority	認定基盤（Schnorr 署名付き証明書）
tollbooth-sample	サンプル Operator（標準テンプレート）
tollbooth-pricing-studio	iOS 料金モデルエディター／オペレーターコンソール
cypher-mcp	収益化されたグラフ回答：Neo4j/AuraDB 上の名前付き Cypher テンプレート
schwab-mcp	Charles Schwab の証券取引データ
thebrain-mcp	TheBrain の個人用ナレッジグラフ
excalibur-mcp	X/Twitter への投稿
taxsort-mcp	税務分類と Cloudflare Pages UI
optionality-mcp	オプション取引の練習ゲーム（このリポジトリ）
goodearth-mcp	小規模農場向けの地域別気候分析
beesknees-mcp	The Bee's Knees：女王を目指すマルチプレイヤーレース
roastify-mcp	Roastify のコーヒーカタログとパッケージアートワーク
ChartRemotely-mcp	デスクトップのチャートに証券をリモートで表示
tollbooth-web	Operator のフロントエンド向け共有ブラウザー SDK
tollbooth-oauth2-collector	OAuth2 コールバックハンドラー（アドボケイトサービス）
tollbooth-shortlinks	URL 短縮ユーティリティ

License

Apache 2.0 — see LICENSE and NOTICE.