optionsahoy-mcp

OptionsAhoy MCP Server

_{第三者による独立検証済みです。 Glama： 第三者MCPディレクトリによる品質スコア（ツールのドキュメント、動作、網羅性）。 · npm： ビルドの出所情報と、このパッケージがこのリポジトリからGitHub Actionsによってビルドされたことを示す署名付きSLSA証明書とともに公開されています（npm audit signaturesで検証できます）。 · MCPSafe： 独立した5モデル合意型セキュリティスキャン（AIVSS）で、検出事項ゼロのグレードAです。}

_{信頼できる情報源に照らして検証済みです（当社が管理していない参照資料を用いて当社自身が実施し、再現可能なチェックです）。計算： 2026年の連邦税に関する定数はすべて、IRS Rev. Proc. 2025-32／Internal Revenue Codeの値と一致します。また、14件の連邦税の計算例（通常所得、長期キャピタルゲイン、ならびにインセンティブ・ストック・オプションのバーゲン要素を含む代替ミニマム税）は、独立して保守されているPSL Tax-Calculator（当社が作成していない税務モデル）とセント単位まで一致します。州所得税も同じ方法で相互検証しており、カリフォルニア州、ニューヨーク州、ニュージャージー州、ペンシルベニア州、マサチューセッツ州の16件の計算例が、当社が作成していない独立した州税計算エンジンOpenTaxSolverとセント単位まで一致します。主要な回答は、お使いのブラウザーでリアルタイムに再計算されます。}

_{テスト済みで堅牢です。 入力の安全性： リクエストは公開済みスキーマに照らして検証されます。不正な入力には、該当フィールドを明示した明確な400エラーを返し、クラッシュや誤った数値は発生しません。また、デプロイのたびに堅牢性テストスイートでライブAPIを再チェックします。 · テストスイート： 計算エンジンは、連邦税と全50州の税務ロジック、AMTクレジットの回収、オプション価格設定を対象とする1,000件超の自動テストでカバーされており、テストに失敗するとリリースがブロックされます。}

_{ライブ利用状況： 過去30日間のMCP呼び出し数。サーバー自身のテレメトリーから直接提供されます（/api/v1/stats、集計件数のみで、PIIは含まれません）。}

あらゆるModel Context Protocol（MCP）クライアントから呼び出せる、決定論的な株式報酬税計算です。代替ミニマム税（AMT）を考慮したインセンティブ・ストック・オプション（ISO）の行使スケジュール、非適格ストック・オプション（NSO）および譲渡制限付き株式ユニット（RSU）の判断、適格中小企業株式（QSBS）の要件適合、単一銘柄への集中、プロテクティブ・プットによるヘッジ、株式を活用した資金調達目標に対応します。関連する連邦税法と、全50州およびDCの2026年税率区分に対応しています。OptionsAhoyを運営するAlphaLatitude Inc.が開発しました。 なぜモデルに聞くだけではだめなのでしょうか？ 最先端の大規模言語モデル（LLM）5つを対象に、同じ複数年にわたるISOの演習問題で、それぞれ3回、合計15回の試行をベンチマークしました。すべての試行で、提案したスケジュールの税引後結果が2倍から20倍過大に見積もられました。複数年のスケジュールでは、コンテキスト内で処理するには現実的でないほど大きな探索空間になります。これらのツールは、検証可能な答えを返します。最新モデルに対応したライブベンチマーク：optionsahoy.com/benchmark。生の応答と採点結果：llm-iso-benchmark。詳しい記事：でも、税金の計算はできるのでしょうか？

1行でインストール

ホスト型エンドポイントは https://optionsahoy.com/mcp です（HTTP、認証不要、アカウント不要）。最も手早い方法：

クライアント	インストール
任意の MCP クライアント	リモート HTTP サーバーとして https://optionsahoy.com/mcp を追加するか、npx add-mcp https://optionsahoy.com/mcp を実行します
Claude Desktop	optionsahoy.mcpb をダウンロードしてダブルクリックします
Smithery 経由で19クライアント	npx @smithery/cli install alphalatitude/optionsahoy --client claude
ローカル stdio（npm）	npx -y optionsahoy-mcp

インストール方法の全一覧（Gemini CLI 拡張機能、設定ファイル用 JSON、REST API、Google Cloud Agent Registry）：optionsahoy.com/for-agents。

8つのツール

ツール名	計算内容
amt_iso_optimize	計画期間終了時の税引後最終純資産額を最大化する、複数年にわたるISO行使スケジュール。AMTクレジットの回収、付与の失効、退職後の行使期間をモデル化します
nso_calculate	NSO行使時の税引後受取額（連邦税、州税、FICA）。行使時売却と、長期キャピタルゲインを得るための保有を比較します
rsu_sell_vs_hold	RSUの権利確定時の判断：権利確定時に売却するか、長期キャピタルゲインを得るために保有するかを比較します。22％の追加源泉徴収と限界税率の差も含みます
concentration_analyze	単一銘柄への集中リスク（30／50／70％下落時のエクスポージャー）。税引後の売却縮小、保有、ヘッジ戦略を比較します
protective_put_price	Black-Scholesによるプロテクティブ・プット、ゼロコスト・カラー、プット・スプレッドの価格算出。年率換算ヘッジコスト、最大損失、上値の上限、保護範囲、フロア到達確率、および推奨する仕組みを提示します
qsbs_check	法定の6つのテストに基づくSection 1202 QSBSの適格性判定。OBBBAの2026年段階的控除と州ごとの準拠状況にも対応します
equity_funding_plan	期限までに目標とする税引後金額を達成する、複数年・複数資産クラスにわたる売却スケジュール。名前付きのプラン4種類と、リスク／資産額のフロンティア全体を返します
rsu_lot_optimize	どの権利確定済みRSUロットをいつ売却すれば、計算上の税額を最小にしながら目標割合の株式を売却できるかを算出します。特定ロットの指定、長期課税の繰り延べ、プラン内の損失繰越を伴う複数年の税率区分への分散を、FIFOの売却順序と比較します

ISOオプティマイザーは、離散化された候補空間全体を探索し、1株単位で精緻化します。公開済みの実行可能なケースでは、総当たり計算による最大値とセント単位まで一致します（証明を見る）。プランナーは税率区分を考慮した決定論的な探索を行い、計算ツールは正確な結果を返します。言語モデルによる推測ではなく、決定論的な計算です。関連する連邦税法（通常所得税の税率区分、長期キャピタルゲイン、クレジット回収を伴うAMT、FICA、NIIT）に加え、全50州とDC（州の通常所得税率区分、長期キャピタルゲインの取り扱い、CA、CO、CT、MNの州AMT）を網羅しています。optionsahoy.com/tools のブラウザー内計算ツールと同じエンジンを使用しており、APIレスポンスには、ツールを操作した場合と同じ計算結果が含まれます。

呼び出しの内容（8つすべてのツール）

https://optionsahoy.com/mcp から取得し、docs/examples/ にコミットした、各ツールの実際の呼び出し例です。以下の各数値は、元になった応答と照合できます。入力は意図的に明示しており（ticker は指定せず、すべての日付を固定しています）、scripts/capture-readme-examples.mts を再実行すると同じ数値が再現されます。各ブロックには、質問、シナリオを指定する引数、返された結果が示されています。

amt_iso_optimize

「権利確定済みのISOが50,000株あり、行使価格は$4、株価は$90です。夫婦合算申告で、所得は$300,000、カリフォルニア州在住です。今すぐ全株を行使すべきでしょうか、それとも分散して行使すべきでしょうか？」

{"shares": 50000, "strike": 4, "fmv": 90, "horizon": 4, "filingStatus": "married_joint",
 "ordinaryIncome": 300000, "stateCode": "CA", "grantDate": "2023-03-15",
 "expectedGrowth": 0.1, "volatilityDrag": 0.2, "cashReturnRate": 0.05, …}

最適化されたスケジュールでは、4年間でそれぞれ1,401株、1,339株、1,280株、45,980株を行使し、最終的な純額は$1,623,234となります。今すぐ全株を行使した場合の$1,565,849を上回ります。AMTの損益分岐点は699株で、最初の$60,185のバーゲン要素にはAMTがまったくかかりません。（生データ。明示した成長率とコストを用いて算出した、サイトの公開済み計算例と同じポジションです）

nso_calculate

「行使価格$8、株価$75のNSOが5,000株あります。行使時に売却すべきでしょうか、それとも長期譲渡益を得るために1年間保有すべきでしょうか？単身申告で、所得は$250,000、カリフォルニア州在住です。」

{"shares": 5000, "strike": 8, "currentPrice": 75, "expectedSalePrice": 90, "holdYears": 1,
 "holdFunding": "sell-to-cover", "volatility": 0.3, "ordinaryIncome": 250000,
 "filingStatus": "single", "stateCode": "CA", …}

行使時には$335,000のバーゲン要素に対して$159,618の税金がかかり、すべてをその場で売却すると$175,382が手元に残ります。売却分で税金を賄いながら1年間保有した場合の予測額は$193,943で、今すぐ売却して売却代金を投資した場合の$184,209を$9,734上回ります。 (生データ)

rsu_sell_vs_hold

「株価$200で権利確定するRSUが1,000株あります。権利確定時に売却すべきでしょうか、それともさらに1年半保有すべきでしょうか？夫婦合算申告で、所得は$300,000、ニューヨーク州在住です。」

{"shares": 1000, "currentPrice": 200, "expectedSalePrice": 220, "holdYears": 1.5,
 "volatility": 0.25, "ordinaryIncome": 300000, "filingStatus": "married_joint",
 "stateCode": "NY", "stillEmployed": true, …}

権利確定時の税金は合計$73,896で、そのうち連邦税は$55,716です。定率の追加源泉徴収額はわずか$44,000のため、その差額が、予想外に4月に請求される税金となります。権利確定時に売却して投資した場合、保有期間終了時の予測額は$136,247です。一方、保有した場合は$130,817となるため、このケースでは保有すると$5,430少なくなります。 (生データ)

concentration_analyze

「私の資産$2.25Mのうち$750,000が、2022年に$150,000で購入したテック株1銘柄に集中しています。どの程度リスクにさらされていて、売却するとどれくらいのコストがかかりますか？」

{"positionValue": 750000, "costBasis": 150000, "acquisitionDate": "2022-01-15",
 "sector": "tech_software", "totalAssets": 2250000, "expectedPositionReturn": 0.12,
 "volatility": 0.35, "ordinaryIncome": 350000, "filingStatus": "single", "stateCode": "CA", …}

このポジションは純資産の33%を占めており、ツールでは「集中」と判定されます。その銘柄が50%下落すると、$375,000の損失になります。3年間に分けて売却すると、1年間で一括売却する場合の$208,368に対し、税金は$196,709です。 (生データ)

protective_put_price

「$500,000のテック株ポジションを1年間、下落から保護したいと考えています。下限は現在値より約20%低い水準にしたいです。プット、カラー、プットスプレッドのどれがよいでしょうか？」

{"positionValue": 500000, "sector": "tech_software", "volatility": 0.35,
 "protectionLevel": 0.2, "tenorYears": 1, "spreadRiskLevel": 0.1, "expectedReturn": 0.08}

行使価格$400,000の単独プットは、年間$19,348、ポジションの3.87%のコストがかかります。ゼロコスト・カラーなら、上値を$724,518で抑えることで同じ下限をほぼゼロの純プレミアムで確保できます。その価格に達する確率は15.7%と見積もられており、ツールはこの戦略を推奨しています。 (生データ) この呼び出しでは明示的なシグマを渡しているため、すべてのレッグがその1つの数値を使って価格付けされます。代わりに ticker を渡すと、株式のライブオプションチェーンに基づき、各レッグがそれぞれの行使価格のインプライド・ボラティリティで価格付けされます。この場合、これほどアウト・オブ・ザ・マネーの下限を設定するとコストが高くなります。

qsbs_check

「2020年3月に創業者株を購入し、2026年3月に$5Mの利益で売却します。QSBSの対象になりますか？また、いくらが非課税になりますか？」

{"acquisitionDate": "2020-03-01", "saleDate": "2026-03-15", "entityType": "us-c-corp",
 "acquisitionMethod": "original-issuance", "assetCategory": "under-50m",
 "industry": "tech-software", "adjustedBasis": 50000, "expectedGain": 5000000, …}

判定は qualifies です。保有期間は6.0年で、法定の6つの要件をすべて満たしているため、$5,000,000の利益全額が発行体ごとの上限$10,000,000の範囲内で控除対象となり、連邦税にして$1,190,000の節税になります。カリフォルニア州はこの制度に準拠していないため、同じ利益に州税が全額課されます。 (生データ)

equity_funding_plan

「2029年6月までに、税引き後で400,000ドルが必要です。2つのロットに分けて、1株120ドルの株を3,500株保有しています。何をいつ売ればよいですか？」

{"targetAfterTax": 400000, "targetDate": "2029-06-30", "stacks": [{"currentPrice": 120,
 "expectedAnnualGrowth": 0.08, "lots": [{"shares": 2000, "costBasisPerShare": 50,
 "acquisitionDate": "2022-01-15"}, …]}], "ordinaryIncome": 350000, "stateCode": "CA", …}

今日すべて売却しても目標には届きません。手取りは391,574ドルで、目標の400,000ドルを下回ります。推奨される段階的なプランでは、期限までの数年間に3,500株のうち3,314株を売却し、税引き後の手取りは400,075ドル、納税額は63,740ドルとなります。目標年に一度に売却する場合より12,976ドル多くなります。(raw)

rsu_lot_optimize

「3回の権利確定で取得した権利確定済みRSU株を3,000株保有しています。株価は180ドルで、今後2年間で保有数を半分に減らしたいです。どのロットを売ればよいですか？」

{"lots": [{"vestDate": "2022-08-15", "shares": 1200, "costBasisPerShare": 95},
 {"vestDate": "2024-02-15", "shares": 1000, "costBasisPerShare": 130}, …],
 "currentPrice": 180, "divestFraction": 0.5, "horizonYears": 2, "ordinaryIncome": 200000, …}

3,000株のうち1,500株を売却するため、含み損のある直近のロットを、古いロットの長期キャピタルゲインと組み合わせます。その結果、売却全体の税額は2,935ドルとなり、税引き後に267,065ドルが手元に残ります。これは、同じ割合をFIFO順で売却した場合より29,942ドル多い金額です。(raw)

上記の例ではすべて、ボラティリティと成長率を明示的に指定しています。実際の呼び出しでは、代わりに ticker を渡すこともできます。ボラティリティは直近の市場終値時点で公開されたインプライド・ボラティリティのスナップショットから、成長率はキャッシュされた過去のCAGRスナップショットから取得されます。いずれかを解決できない場合、推測値ではなく、該当するフィールド名を明記したエラーが返されます。また、protective_put_price は volatilitySource（explicit、chain、ticker、sector-default のいずれか）と pricingMode（chain-skew または flat）を返すため、どのシグマで価格を算出したか、また各レッグをそれぞれの権利行使価格で価格設定したかどうかを常に確認できます。

これらの出力例は、2026課税年度に実行したものです。今日の日付から先のスケジュールを計算する3つのツール（amt_iso_optimize、equity_funding_plan、rsu_lot_optimize）では、後の課税年度に数値が変わります。それ以外のツールは、引数に指定された日付に基づいています。

エージェントフレームワークで使う（Python）

MCPエンドポイントを直接呼び出すのではなく、Pythonでエージェントを構築する場合、OptionsAhoyは主要なエージェントフレームワーク向けに、インストール可能なツールパッケージを提供しています。それぞれのパッケージは、同じ計算機能をフレームワーク標準のツールインターフェースで利用できるようにします。すべてPyPIで公開されており、認証キーは不要です。OptionsAhoyアカウントもAPIキーも必要ありません。

フレームワーク	インストール	インポート	例
LangChain	pip install optionsahoy-langchain	from langchain_optionsahoy import get_optionsahoy_tools	equity_agent.py
LlamaIndex	pip install llama-index-tools-optionsahoy	from llama_index.tools.optionsahoy import OptionsAhoyToolSpec	equity_agent.py
CrewAI	pip install crewai-optionsahoy	from crewai_optionsahoy import get_optionsahoy_tools	equity_crew.py
標準のPythonクライアント	pip install optionsahoy	from optionsahoy import OptionsAhoyClient	basic_client.py

3つのフレームワークアダプターは、認証キー不要の optionsahoy クライアントを自動的にインストールします。また、OpenBB Workspace内で使用できるOpenBB Workspaceエージェント（OptionsAhoyクライアントを基盤とするFastAPIアプリケーション）もあります。上記すべてのソースコードと実行可能な例は、integrations/pythonにあります。

さらに広がる構築方法

エージェントをどのように構築しても、そのまま組み込めるコンポーネントがあります。すべて公開されており、キーは不要です。

構成要素	内容
Vercel AI SDK ツール	8つすべての計算ツールを Vercel AI SDK の tool() 定義として公開する TypeScript パッケージ（optionsahoy-ai-sdk）です。generateText / streamText にそのまま展開できます。
インストラクションキット	Cursor、Windsurf、Claude Skills、Claude Code サブエージェント向けのエディタールールとスキルです。コーディングエージェントが株式報酬に関する質問に対して OptionsAhoy ツールを呼び出すようにできます。
コーディングレシピ	質問ごとに自己完結した単一ファイルで、requests のみを使ってキー不要の API を呼び出す、コピーして使える Python レシピです。integrations/recipes にもあります。
ビルダーテンプレート	インポート可能な n8n ワークフローと、Flowise、Langflow、Dify 向けの構築レシピです。
ツール使用評価	ツールの有無を比較し、複数年にわたる ISO の問題でエージェントが証明可能な最適解に到達するかを測定する inspect_ai 評価です。
A2A ディスカバリー	他のエージェントが株式報酬に関する質問をプランナーに発見させ、委任できるようにする Agent2Agent（A2A）Agent Card です。
Zed 拡張機能	エディターのエージェントを OptionsAhoy MCP サーバーに接続する、Zed エディター用のコンテキストサーバー拡張機能です。
ACI.dev アプリ	オープンソースのエージェントツールプラットフォーム ACI.dev 向けの OptionsAhoy アプリ定義です。
OpenRouter ブリッジ	OpenRouter の OpenAI 互換エンドポイント経由でルーティングされる任意のモデルに、キー不要の OptionsAhoy MCP サーバーを接続するレシピです。

インストールせずに試す

optionsahoy.com/for-agents のライブウィジェットは、ブラウザーから同じエンドポイントを呼び出します。クライアントも設定も不要です。

チャットインターフェースを使いたい場合は、poe.com/OptionsAhoy でも、同じ計算ツールに自然言語で質問できます。

実際のセッションを見ることもできます。

編集なしの Claude Code の実際のセッションです。複数の資産クラスにまたがる META の質問（ISO 10K、権利確定済み RSU 6K、新規 RSU 2K、2027年の40万ドルの住宅購入）に対して、OptionsAhoy MCP ツールが4つ並列で実行されます。集中リスク、株式資金計画、AMT/ISO 最適化、プロテクティブ・プットの価格設定です。ユーザーの資産の86％が META に集中しているため、Claude は各ツール単独の選択を覆す1つの計画に出力をまとめます。2:13。ポスターをクリックすると optionsahoy.com で再生されます。

エンドポイントとディスカバリー

ライブ MCP エンドポイント： https://optionsahoy.com/mcp ライブ REST API： https://optionsahoy.com/api/v1 OpenAPI 3.1 仕様： /openapi.json ディスカバリーマニフェスト： /.well-known/mcp.json · /.well-known/openapi.json エージェント連携ドキュメント： optionsahoy.com/for-agents

MCP リソース（トピック別の概要）

resources/list にある8つの Markdown リソースを参照すると、LLM はツールを選ぶ前にトピックについて十分な背景知識を得られます。ほとんどのリソースは、optionsahoy.com/learn にある主要記事と対応する計算ツールに1対1で対応しています。株式による資金調達の概要は対応する計算ツールに対応し、カバード銘柄の概要には、任意の ticker ショートカットで解決されるシンボルが列挙されています。

リソース URI	トピック	対応するツール
https://optionsahoy.com/learn/amt-crossover	ISO／AMT の損益分岐点と、損失につながる4つのよくあるミス	amt_iso_optimize
https://optionsahoy.com/learn/nso-sell-vs-hold	NSO の行使時売却と、長期キャピタルゲイン目的の保有の比較	nso_calculate
https://optionsahoy.com/learn/rsu-withholding-gap	RSU の源泉徴収率22％の不足と、4月に慌てないための5つの注意点	rsu_sell_vs_hold
https://optionsahoy.com/learn/single-stock-concentration-risk	集中リスクと分散のトレードオフ	concentration_analyze
https://optionsahoy.com/learn/zero-cost-collars	プロテクティブ・プット、ゼロコスト・カラー、プット・スプレッド	protective_put_price
https://optionsahoy.com/learn/qsbs	QSBS の適格要件と、控除を失う5つのケース	qsbs_check
https://optionsahoy.com/tools/equity-funding	期限までに現金目標を達成するための株式売却	equity_funding_plan
https://optionsahoy.com/tools/covered-tickers	任意の ticker ショートカットで解決されるシンボル	ticker を受け取る任意のツール

MCP プロンプト（ワークフローのひな型）

prompts/list にある8つのプロンプトは、よくあるユーザーの質問のひな型を提供し、適切なツールへ振り分けます。Claude Desktop では名前付きのスラッシュコマンドとして表示され、任意の MCP クライアントでは、prompts/get { name, arguments } によってテンプレートが適用済みのユーザーメッセージが返されます。

プロンプト名	振り分け先
optimize-iso-exercise	amt_iso_optimize
analyze-nso-decision	nso_calculate
analyze-rsu-vest	rsu_sell_vs_hold
analyze-concentration	concentration_analyze
price-protective-put	protective_put_price
check-qsbs-eligibility	qsbs_check
plan-equity-funding	equity_funding_plan
plan-equity-portfolio	複数のツールを使い、結果を1つの計画にまとめます

引数を文字列として渡す prompts/get の呼び出し例：

{"name": "optimize-iso-exercise",
 "arguments": {"shares": "50000", "strike": "4", "fmv": "90", "expectedGrowth": "0.1",
               "volatility": "0.5", "state": "CA", "ordinaryIncome": "300000"}}

呼び出すと、テンプレートが適用済みのユーザーメッセージが1つ返されます（「権利行使価格が1株あたり4ドルのインセンティブ・ストック・オプション（ISO）を50,000株保有しています……」）。メッセージには、指定値を使って amt_iso_optimize を呼び出すこと、不足している必須項目があれば推測せずに質問すること、一括実行および均等分割の選択肢と比較して最適化されたスケジュールを報告することが、あらかじめ指示されています（raw）。

インストールの詳細

Claude Desktop 拡張機能（ワンクリック）

optionsahoy.mcpb バンドルは、Claude Desktop に組み込まれた Node.js ランタイムを使用するため、ターミナルや設定ファイルの編集は不要です。ダブルクリックするか、Claude Desktop の「設定」→「拡張機能」にドラッグしてインストールできます。

ソースからバンドルをビルドするには：

npm install && npm run build:mcpb

Smithery CLI（19のクライアント、1つのコマンド）

npx @smithery/cli install alphalatitude/optionsahoy --client claude

claude を Smithery がサポートする任意のクライアントに置き換えてください。対応クライアントには、claude-code、cursor、vscode、gemini-cli、codex、windsurf、cline、goose、opencode など、ほかに10種類があります。一覧：smithery.ai/servers/alphalatitude/optionsahoy。

Gemini CLI 拡張機能

gemini extensions install https://github.com/AlvisoOculus/optionsahoy-mcp

このリポジトリは Gemini CLI 拡張機能としても機能します。gemini-extension.json がホスト型 MCP エンドポイントを設定し、GEMINI.md がモデルに使用方法のコンテキストを提供します。

ローカル stdio（npm）

ローカル stdio サーバーのみをサポートするクライアント（mcp-remote を使わない Claude Desktop、一部の IDE 統合）向けです。

npx -y optionsahoy-mcp

または、Claude Desktop／Cline／Goose の設定ファイルに追加します。

{
  "mcpServers": {
    "optionsahoy": {
      "command": "npx",
      "args": ["-y", "optionsahoy-mcp"]
    }
  }
}

ローカルサーバーは、ホストされたエンドポイント https://optionsahoy.com/mcp と同じ計算結果を返します。どちらのソースも functions/_lib/mcp-tools.ts にあり、stdio のエントリーポイントは src/stdio-server.ts です。

REST API を直接使用する

# List endpoints
curl https://optionsahoy.com/api/v1

# Run an optimization (the 50,000-ISO example from "What a call looks like")
curl -X POST https://optionsahoy.com/api/v1/amt-iso \
  -H "content-type: application/json" \
  -d '{"shares":50000,"strike":4,"fmv":90,"horizon":4,"filingStatus":"married_joint",
       "ordinaryIncome":300000,"stateCode":"CA","grantDate":"2023-03-15",
       "hasLeftCompany":false,"expectedGrowth":0.1,"volatilityDrag":0.2,
       "carryforwardCredit":0,"cashReturnRate":0.05}'

これは、上記の MCP 呼び出しと同じ result.schedules.optimized.nfv を返します（raw）。その他の 7 つのエンドポイントのリクエストボディの形式は、public/openapi.json に記載されています。

リポジトリの構成

functions/         Cloudflare Pages Functions (MCP server + REST API endpoints)
  mcp.ts           HTTP MCP server
  api/v1/*.ts      Eight tool endpoints + stats + GET /api/v1 discovery
  _lib/*.ts        Shared helpers, calc-input parsers, MCP tool descriptors
lib/               Optimizer + tax-code logic
  calc/            Per-tool optimizer functions (computeAmtIso, etc.)
  tax/             Federal + 50-state + DC bracket data, AMT, FICA, NIIT
  markets/         Sector statistics
  options/         Black-Scholes, risk-free rates
  data/            Option-chain types, and the readers for the live vol and chain feeds
public/            Static assets: OpenAPI spec, llms.txt, discovery manifests
tests/             Vitest suites (an extensive test suite including byte-identity assertions)

テストを実行する

npm install
npm test         # an extensive test suite, ~3s on a laptop
npm run typecheck

レジストリへの掲載

• 公式 MCP レジストリ — io.github.AlvisoOculus/optionsahoy-mcp、ステータスは active
• ChatGPT プラグインディレクトリ — 開発者モード不要で、すべての ChatGPT ユーザーがワンクリックで追加できます（公開日：2026-07-28）
• Smithery — alphalatitude/optionsahoy（株式報酬プランのスキルも掲載）
• Gemini CLI 拡張機能ギャラリー — @AlvisoOculus/optionsahoy-mcp
• add-mcp の厳選レジストリ
• PulseMCP（公式レジストリから連携）
• Continue.dev ハブ — ブロック YAML は .continue/mcpServers/optionsahoy.yaml にあります

Google Cloud から使用する（Gemini エージェント）

Google Cloud Agent Registry を使うと、各 GCP プロジェクトで Gemini エージェント用の外部 MCP サーバーを登録できます。登録はプロジェクトごとに行われます（中央への申請は不要です）。方法は 2 つあります。

# Path A: let the Agent Registry introspect our MCP endpoint
gcloud alpha agent-registry mcp-servers register \
  --uri=https://optionsahoy.com/mcp \
  --display-name="OptionsAhoy" \
  --location=us-central1 \
  --import-tools

# Path B: pass our published toolspec.json directly (faster, no introspection)
gcloud alpha agent-registry mcp-servers register \
  --uri=https://optionsahoy.com/mcp \
  --display-name="OptionsAhoy" \
  --location=us-central1 \
  --tool-spec=<(curl -sSL https://optionsahoy.com/toolspec.json)

toolspec.json は MCP の tools/list レスポンスを反映し、8 つすべてのツールに readOnlyHint と idempotentHint の注釈を付けています（すべて副作用のない純粋な決定論的計算ツールです）。ツールの形式を変更した後に再生成するには、次を実行します。

curl -sS -X POST https://optionsahoy.com/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}' \
  | jq -c '{tools: [.result.tools[] | . + {annotations: {readOnlyHint:true, idempotentHint:true, destructiveHint:false, openWorldHint:false}}]}' \
  > public/toolspec.json

トラブルシューティング

MCP エンドポイントから接続拒否／404 が返される https://optionsahoy.com/mcp には、content-type: application/json を指定した POST と JSON-RPC ボディが必要です。GET では JSON サーバーの説明が返され、その他のメソッドでは 405 が返されます。次の方法で確認してください。

curl -X POST https://optionsahoy.com/mcp -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","method":"initialize","id":1,"params":{}}'

ツール呼び出しの応答に Error: ... というテキストが含まれる 入力検証に失敗すると、MCP サーバーは人が読めるメッセージとともに isError: true を返します。最もよくある原因は、必須フィールドがないこと、または数値を文字列として渡していることです。入力を、tools/list が返す inputSchema、または /openapi.json と照らし合わせて確認してください。

Claude.ai または Claude Desktop にツールが表示されない

• コネクターの URL が正確に https://optionsahoy.com/mcp であることを確認してください（末尾のスラッシュや /v1 は付けません）。
• Claude Desktop では、claude_desktop_config.json を編集した後にアプリを再起動してください。
• Claude.ai では、コネクターの切り替えはチャットごとに行います。添付ファイルメニューで有効にしてください。
• tools/list の最新の応答を確認してください（8 つのツールが表示されるはずです）：curl -X POST https://optionsahoy.com/mcp -H 'content-type: application/json' -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

ブラウザーベースのクライアントで CORS エラーが発生する サーバーはプリフライトを含むすべての応答で access-control-allow-origin: * を返し、標準の MCP ヘッダー（content-type、mcp-session-id、mcp-protocol-version）を受け付けます。それでもブラウザーにブロックされる場合は、クライアントが許可されていないヘッダーを送信している可能性があります。リクエストヘッダーを access-control-allow-headers の応答と照らし合わせて確認してください。

リソース／プロンプトが見つからない リソース URI とプロンプト名では大文字と小文字が区別されます。手入力せず、resources/list と prompts/list で正規の一覧を取得してください。

税年度の計算が古い 税務エンジンには、2026 年のインフレ調整済み税率区分、OBBBA 2026 年の QSBS ルール、および最新の州法適合表が組み込まれています。複数年の期間で結果が不自然な場合は、入力した grantDate、acquisitionDate、または saleDate が想定する年になっているか確認してください。エンジンは税年度ごとに税率区分を判定します。

計算上の不具合または予期しない出力の報告 [email protected] まで、正確な JSON-RPC リクエストボディ、応答、期待される値、また（分かる場合は）その期待値の根拠となる IRS の刊行物または州法をメールでお知らせください。

プライバシーポリシー

ポリシー全文：optionsahoy.com/privacy。

概要：アカウントは不要で、個人を特定できる情報（氏名、メールアドレス、IP アドレス、ログイン情報）は保存されません。ツールの入力と出力は、デバッグと製品改善のために短期間（約 7 日間）保持されます。また、利用状況の把握と不正利用の検出を目的として、集計された利用メタデータ（ツール、タイムスタンプ、大まかな位置情報、クライアントの種類）も保持されます。ローカルの stdio サーバーと Claude Desktop 拡張機能は、すべての処理をお使いのマシン上で行います。ネットワークリクエストを行うのは 2 種類のみで、いずれも ticker を渡し、その番号が解決に必要な場合に限られます。公開済みのインプライド・ボラティリティ・ファイル（ティッカーを含まない固定 URL が 1 つ）と、protective_put_price の場合に限り対象株式のオプションチェーン（URL にシンボルを含む）です。呼び出しに関するそれ以外の情報がマシンの外部に送信されることはありません。

ライセンス

MIT。LICENSE をご覧ください。https://optionsahoy.com/mcp および https://optionsahoy.com/api/v1 のデプロイ済みサービスは、ベータ期間中、利用規約に基づいて無料で利用できます。

お問い合わせ

提携、API の早期利用、MCP 統合のサポートについては、[email protected] までお問い合わせください。