Jackpot Calculator

Jackpot Calculator MCP

四种只读 MCP 工具，用于计算美国彩票奖金税、比较一次性领取与年金、计算均分奖金池的份额，以及评估头奖概率。计算使用固定的 2026 年数据快照，并采用与 Jackpot Calculator 相同的引擎。

连接到托管服务

在支持远程 MCP 服务的客户端中添加此 Streamable HTTP URL：

https://jackpot-calculator-mcp.jiankn.workers.dev/mcp

无需 API 密钥。公共端点在 Cloudflare 边缘节点上的每个 IP 每分钟最多允许 120 次请求；速率限制为近似值，并非全局配额。 连接示例和输出单位：Jackpot Calculator MCP setup。

工具

工具	必需输入	输出
calculate_lottery_payout	prize、stateCode	预估最终税额、预扣税额和税后现金
compare_lump_sum_annuity	jackpot、cashValue、stateCode	一次性领取与分 30 次支付的年金、折现现值和盈亏平衡利率
calculate_pool_share	prize、members、stateCode	一位均分奖金池成员应得的份额，并考虑整张彩票的预扣税门槛
calculate_lottery_odds	game	不重复组合的头奖概率；可选提供 jackpotCash 以计算预期回报

金额输入单位为美元。税额和派彩结果以整数美分表示。 概率工具以美元报告金额。利率和概率均为小数，因此 0.04 表示 4%。每项结果都会注明单位、假设条件和相关计算器。

工具调用示例：

{
  "name": "calculate_lottery_payout",
  "arguments": { "prize": 1000000, "stateCode": "TX", "status": "single" }
}

打包的 2026 年计算结果为：预估联邦最终税额为 $320,000，税后收入为 $680,000；联邦预扣税额另计，为 $240,000。请参阅互动式彩票税务计算器，探索其他州和报税身份。

若要估算特定彩票的现金派彩，请选择 game: "powerball" 或 game: "megaMillions"，提供已知现金奖金，并使用 Powerball 派彩计算器或 Mega Millions 税务计算器进行比较。对于年金，请同时提供公布的现金选项和宣传的年金总额；此软件包不会根据固定百分比猜测现金选项。

从源代码或发布压缩包在本地运行

需要 Node.js 22.12 或更高版本。

git clone https://github.com/jiankn/jackpot-calculator-mcp.git
cd jackpot-calculator-mcp
npm ci
npm test
node src/cli.mjs

最后一条命令会启动 MCP stdio 服务并等待客户端连接；它不是交互式命令行提示符。配置 stdio 客户端时，使用 command: "node" 和 args: ["/absolute/path/to/jackpot-calculator-mcp/src/cli.mjs"]。 只有协议消息会写入 stdout。

也可以通过 npm install ./jackpot-calculator-mcp-0.1.0.tgz 安装发布压缩包。npm 注册表列表为可选项，托管端点不依赖它。

计算范围

• 美国居民纳税人，居住州与购票州相同；不模拟跨州抵免和非居民外国人预扣税。
• 联邦和州税务数据随项目打包，并附有原始来源 URL 和日期。不实时查询头奖，不自动更新税务数据，也不购票或检查彩票。
• 采用标准扣除额和增量所得税。州级户主身份使用单身申报人的州税率档位。加利福尼亚州假设奖金来自 California Lottery。
• 纽约市和 Yonkers 需要明确指定 locality，且 stateCode: "NY"。马里兰州使用平均县税率；不计入其他地方所得税。
• 年金分 30 次支付，首次立即支付，此后每年支付一次，金额逐年增长 5%。假设税收规则和其他收入保持不变。不模拟未来税法和投资税。年金方法和计算器。
• 彩池输出假设所有成员的税务情况相同。不同的人需要分别创建情景。按个人舍入到小数点后两位的分摊金额，合计可能与整个奖金略有差异。
• 概率假设同一期开奖中的组合各不相同。预期价值不计税费、Power Play、头奖分摊和 California pari-mutuel 派彩差异。

结果仅供估算，不构成税务或财务建议。本项目独立于 Powerball、Mega Millions、Multi-State Lottery Association 和各州彩票运营机构。 来源和方法。

开发与发布

npm test 会检查已知派彩、验证逻辑、彩池预扣税、年金总额、概率，以及真实的 stdio/HTTP 协议调用。npm run verify:package 会打包允许列表中的文件，将归档安装到干净目录，并调用已安装的服务。CI 会在 Windows 和 Linux 上运行这两项检查。

scripts/sync-engine.mjs 是仅供维护者使用的快照步骤，在发布前于网站检出目录中运行。它会在 PROVENANCE.md 中记录来源哈希值。独立用户已拥有复制好的文件，无需运行此脚本。

代码：MIT。编译后的数据：CC BY 4.0；请参阅 LICENSE-DATA.md 和 data/ 中的来源 URL。问题反馈：https://github.com/jiankn/jackpot-calculator-mcp/issues