optionsahoy-mcp

OptionsAhoy MCP 服务

_{经第三方独立验证。 **Glama：**第三方 MCP 目录质量评分（工具文档、行为、完整性）。· **npm：**发布时附带构建来源证明，以及经过签名的 SLSA 证明，确认此软件包由 GitHub Actions 从此仓库构建（使用 npm audit signatures 验证）。· **MCPSafe：**基于 5 个模型共识的独立安全扫描（AIVSS），评级为 A，零项发现。}

_{经可信来源验证（我们自行运行的检查，对照我们无法控制且你可以复现的参考数据）。**计算：**所有 2026 年联邦税务常数均与 IRS Rev. Proc. 2025-32 /《国内税收法典》中的数值一致；14 个联邦税务案例（普通收入、长期资本利得和替代性最低税，包括激励性股票期权的价差）与独立维护的 PSL Tax-Calculator 精确到美分，该税务模型并非由我们编写。州所得税也以相同方式交叉核验：涵盖加利福尼亚州、纽约州、新泽西州、宾夕法尼亚州和马萨诸塞州的 16 个案例，均与独立的州税引擎 OpenTaxSolver 精确到美分，该引擎也并非由我们编写。核心结果会在你的浏览器中实时重新计算。}

_{经过测试并强化。 **输入安全：**请求会根据已发布的架构进行验证；错误输入会返回明确的 400 错误并指出有问题的字段，绝不会导致崩溃或产生错误数字；每次部署后都会通过稳健性测试套件重新检查线上 API。· **测试套件：**计算引擎通过了上千项自动化测试，涵盖联邦和 50 个州的税务逻辑、AMT 抵免恢复和期权定价；任何测试失败都会阻止发布。}

_{**实时使用情况：**过去 30 天的 MCP 调用次数，直接来自服务自身的遥测数据（/api/v1/stats，仅汇总计数，不含个人身份信息）。}

确定性的股权薪酬税务计算，任何 Model Context Protocol（MCP）客户端均可调用：激励性股票期权（ISO）行权计划（含替代性最低税（AMT））、非合格股票期权（NSO）和限制性股票单位（RSU）决策、合格小企业股票（QSBS）资格认定、单只股票集中度、保护性看跌期权对冲以及股权融资目标。涵盖相关联邦税法以及全部 50 个州和华盛顿特区的 2026 年税率档次。由 AlphaLatitude Inc. 构建，该公司是 OptionsAhoy 背后的公司。 为什么不直接询问模型？ 我们在同一道多年期 ISO 练习题上，对五个前沿大语言模型（LLM）各运行 3 次，共进行了 15 次试验。每次试验都高估了其所提方案的税后结果，幅度达到 2 到 20 倍。多年期规划的搜索空间过大，无法在上下文中实际遍历；这些工具则会返回可验证的答案。实时基准测试，已更新至最新模型：optionsahoy.com/benchmark。原始回复和评分：llm-iso-benchmark。完整分析：但它会算税吗？

一行安装

托管端点为 https://optionsahoy.com/mcp（HTTP，无需身份验证或账户）。最快的安装方式：

客户端	安装
任意 MCP 客户端	将 https://optionsahoy.com/mcp 添加为远程 HTTP 服务，或运行 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。

八个工具

工具名称	计算内容
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	根据六项法定测试判断是否符合 Section 1202 QSBS 资格，并纳入 OBBBA 2026 分级免税规则和各州的遵从情况
equity_funding_plan	多年期、多资产组合卖出计划，在截止日期前达到目标税后金额；返回四种命名方案以及完整的风险／财富前沿
rsu_lot_optimize	确定要卖出哪些已归属 RSU 批次，以及卖出日期，以最低计算税额出售目标比例的股份：指定批次识别、长期递延，以及多年期税档分散（含计划内亏损结转），并与 FIFO 卖出顺序比较

ISO 优化器会搜索完整的离散候选空间，并逐股细化；在已发布的可处理案例中，其结果与暴力穷举的最大值精确到分（查看证明）。规划器运行确定性的税档感知搜索，计算器则返回精确结果。采用确定性计算，而非语言模型猜测。覆盖相关联邦税法（普通收入税档、长期资本利得税、可回收抵免的 AMT、FICA、NIIT），以及全部 50 个州和 DC（州普通收入税档、LTCG 处理方式、CA、CO、CT、MN 的州 AMT）。使用与浏览器内计算器相同的引擎：optionsahoy.com/tools；API 响应包含的计算数据，与点击工具所得结果相同。

一次调用是什么样的（全部八个工具）

每个工具各有一次真实调用，来自 https://optionsahoy.com/mcp，并提交在 docs/examples/ 下，因此下面的每个示例都可以对照其来源响应进行核验。输入刻意写得明确（不使用 ticker，每个日期都固定），因此重新运行 scripts/capture-readme-examples.mts 会得到相同的数字。每个代码块都展示了问题、承载场景的参数，以及返回结果。

amt_iso_optimize

“我有 50,000 份已归属 ISO，行权价为 $4，当前股价为 $90。夫妻联合申报，收入为 $300,000，居住在 California。现在应该一次性全部行权，还是分批行权？”

{"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, …}

优化后的计划在四年内分别行权 1,401 / 1,339 / 1,280 / 45,980 股，最终净值为 $1,623,234，而今天一次性全部行权的净值为 $1,565,849。AMT 临界点为 699 股：前 $60,185 的价差收益完全不产生 AMT。（原始数据；与网站的已发布示例为同一持仓，采用上文明确指定的增长率和拖累）

nso_calculate

“5,000 份 NSO，行权价为 $8，当前股价为 $75。行权时卖出，还是持有一年以享受长期资本利得税率？单身申报，收入为 $250,000，居住在 California。”

{"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。采用 sell-to-cover 方式持有一年，预计净值为 $193,943；现在卖出并投资所得款项则为 $184,209，持有多出 $9,734。（原始数据）

rsu_sell_vs_hold

“1,000 份 RSU 将以 $200 的价格归属。归属时卖出，还是再持有一年半？夫妻联合申报，收入为 $300,000，居住在 New York。”

{"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 买入的。我的风险敞口有多大？减持的成本又是多少？”

{"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。分三年减持需缴税 $196,709，而在一年内卖出则需缴税 $208,368。（原始数据）

protective_put_price

“我想为一笔 $500,000 的科技股持仓提供一年的下行保护，底线约为现价的 80%。应该选择看跌期权、领口策略，还是看跌期权价差？”

{"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%，因此工具推荐这种结构。（原始数据）此调用传入了明确的 sigma，因此每个期权腿都按同一个数值定价；如果改为传入 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 年，六项法定测试全部通过，因此 $5,000,000 收益的 100% 可根据每个发行人 $10,000,000 的上限予以豁免，可节省 $1,190,000 的联邦税。California 不遵循这一规定，因此同一笔收益需全额缴纳州税。（原始数据）

equity_funding_plan

“我需要在 2029 年 6 月前获得税后 $400,000，用于买房。我持有 3,500 股，股价为 $120，分属两个批次。应该卖出多少，什么时候卖？”

{"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,000 股已归属的 RSU，分属三个归属批次，股价为 $180，并希望在未来两年内将持仓减半。应该卖出哪些批次？”

{"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），让你始终清楚使用了哪个 sigma 进行定价，以及各腿是否按各自的行权价定价。

这些结果是在 2026 纳税年度运行的。对于从今天起向未来推算的三个工具（amt_iso_optimize、equity_funding_plan、rsu_lot_optimize），后续纳税年度的数字会有所变化；其他工具的结果则由参数中的日期固定。

在你的 Agent 框架中使用（Python）

如果你使用 Python 构建 Agent，而不是直接调用 MCP 端点，OptionsAhoy 提供了可安装的工具包，适用于主流 Agent 框架。每个工具包都通过框架原生的工具接口封装相同的计算器。所有工具包均发布在 PyPI 上，且无需密钥：不需要 OptionsAhoy 账户或 API key。

框架	安装	导入	示例
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

这三个框架适配器会自动安装无需密钥的 optionsahoy 客户端。此外，还有一个 OpenBB Workspace Agent（基于 OptionsAhoy 客户端构建的 FastAPI 应用），可在 OpenBB Workspace 中使用。以上所有内容的源码和可运行示例均位于 integrations/python。

更多构建方式

无论你的 Agent 如何构建，都有可直接接入的组件。它们都是公开且无需密钥的。

构建组件	说明
Vercel AI SDK 工具	一个 TypeScript 包（optionsahoy-ai-sdk），将全部八个计算器封装为 Vercel AI SDK tool() 定义，可直接展开传入 generateText / streamText。
指令套件	为 Cursor、Windsurf、Claude Skills 和 Claude Code 子 Agent 提供编辑器规则和技能，让你的编码 Agent 在处理股权薪酬问题时调用 OptionsAhoy 工具。
编码示例	可直接复制粘贴的 Python 示例，每个问题对应一个独立文件，仅使用 requests 调用无需密钥的 API。也可在 integrations/recipes 中查看。
构建器模板	可导入的 n8n 工作流，以及适用于 Flowise、Langflow 和 Dify 的构建示例。
工具使用评估	一项 inspect_ai 评估，用于衡量 Agent 在多年期 ISO 问题上是否能得出可证明的最优解，并比较使用和不使用工具的情况。
A2A 发现	一个 Agent2Agent (A2A) Agent Card，让其他 Agent 能发现该规划器，并将股权薪酬问题委派给它。
Zed 扩展	一个 Zed 编辑器上下文服务扩展，可将编辑器中的 Agent 连接到 OptionsAhoy MCP 服务。
ACI.dev 应用	适用于 ACI.dev 开源 Agent 工具平台的 OptionsAhoy 应用定义。
OpenRouter 桥接	一份指南，介绍如何将无需密钥的 OptionsAhoy MCP 服务接入通过 OpenRouter 的 OpenAI 兼容端点路由的任意模型。

无需安装，立即试用

optionsahoy.com/for-agents 上的在线小组件会从浏览器调用同一个端点。无需客户端，也无需配置。

更喜欢聊天界面？同样的计算器也能在 poe.com/OptionsAhoy 用日常语言回答问题。

也可以观看实际操作：

未经剪辑的 Claude Code 实际会话。针对 META 的多项资产组合问题（10K 份 ISO + 6K 份已归属 RSU + 2K 份新授予 RSU + 2027 年购置价值 $400K 的房屋），并行调用 4 个 OptionsAhoy MCP 工具：集中度风险、股权资金计划、AMT/ISO 优化和保护性看跌期权定价。Claude 综合各项输出，制定出一个推翻每个工具单独推荐方案的计划，因为用户的资产有 86% 集中在 META。时长 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 Agent 集成文档： optionsahoy.com/for-agents

MCP 资源（主题简报）

resources/list 下的八份 Markdown 资源可为大模型提供充分背景，使其在选择工具前能够讨论相关主题。大多数资源与 optionsahoy.com/learn 上的一篇核心文章及相应计算器一一对应；股权融资简报对应其计算器，而已覆盖股票代码简报则列出了可由可选的 ticker 快捷方式解析的代码。

资源 URI	主题	配套工具
https://optionsahoy.com/learn/amt-crossover	ISO/AMT 临界点及四个代价高昂的错误	amt_iso_optimize
https://optionsahoy.com/learn/nso-sell-vs-hold	NSO 行权时卖出还是持有以获得长期资本利得税待遇	nso_calculate
https://optionsahoy.com/learn/rsu-withholding-gap	RSU 22% 预扣税缺口及 4 月的五个意外	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 资格及失去免税待遇的五种方式	qsbs_check
https://optionsahoy.com/tools/equity-funding	在截止日期前通过出售股权满足现金目标	equity_funding_plan
https://optionsahoy.com/tools/covered-tickers	可选的 ticker 快捷方式可解析哪些代码	任何接受 ticker 的工具

MCP 提示词（工作流脚手架）

prompts/list 下的八个提示词为常见用户问题提供脚手架，并将其路由到相应工具。在 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	多个工具，汇总为一个计划

prompts/get 的一次调用，参数均为字符串：

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

它会返回一条已填充模板的用户消息（“我有 50000 份激励性股票期权（ISO），行权价为每股 $4……”），其中已指示模型使用这些值调用 amt_iso_optimize，要求模型询问任何缺失的必填字段，而不是自行假设，并报告优化后的计划与一次性行权和均分行权方案的对比（原始文件）。

安装详情

Claude Desktop 扩展（一键安装）

optionsahoy.mcpb 安装包可通过双击安装（或将其拖到 Claude Desktop → Settings → Extensions），无需使用终端或编辑配置文件，并使用 Claude Desktop 内置的 Node.js 运行时。

从源代码构建安装包：

npm install && npm run build:mcpb

Smithery CLI（19 个客户端，一条命令）

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 服务的客户端（Claude Desktop 不使用 mcp-remote 时，以及某些 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（原始数据）。其他七个端点的请求体格式见 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 Registry — io.github.AlvisoOculus/optionsahoy-mcp，状态：活跃
• ChatGPT 插件目录 — 所有 ChatGPT 用户均可一键添加，无需开发者模式（发布于 2026-07-28）
• Smithery — alphalatitude/optionsahoy（以及 equity-plan 技能）
• Gemini CLI 扩展库 — @AlvisoOculus/optionsahoy-mcp
• add-mcp 精选目录
• PulseMCP（从官方 Registry 汇集）
• Continue.dev 中心 — YAML 配置位于 .continue/mcpServers/optionsahoy.yaml

在 Google Cloud 中使用（Gemini Agent）

Google Cloud Agent Registry 允许每个 GCP 项目注册外部 MCP 服务，供 Gemini Agent 使用。注册按项目进行（无需向中央提交）。有两种方式：

# 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 响应相对应，八个工具均带有 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 需要使用 POST，并设置 content-type: application/json，同时提供 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 响应（预期有八个工具）：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 地址或登录信息。工具输入和输出会短暂保留（约七天），用于调试和改进产品；同时还会保留汇总使用元数据（工具、时间戳、粗略位置、客户端类型），用于了解使用情况和检测滥用。本地 stdio 服务和 Claude Desktop 扩展会在您的设备上完成所有计算。只有当您传入 ticker 而未传入该代码对应的数字时，它们才会发出以下两种网络请求：获取已发布的隐含波动率文件，该文件使用一个固定 URL，完全不包含 ticker；以及针对 protective_put_price，获取该股票的期权链，其 URL 中包含股票代码。调用的其他任何信息都不会离开设备。

许可证

MIT。请参阅 LICENSE。已部署的服务 https://optionsahoy.com/mcp 和 https://optionsahoy.com/api/v1 在测试阶段可根据条款免费使用。

联系方式

有关合作伙伴关系、提前获取 API 权限和 MCP 集成支持，请联系：[email protected]