Jackpot Calculator

io.github.jiankn由 GitHub 账号 jiankn 发布v0.1.0更新于 Oct 24, 2026

Estimate US lottery taxes, compare cash and annuity, split pool prizes and calculate jackpot odds.

发布方自己的服务:Calculator Tools MCP

已验证Streamable HTTP可网页运行金融数据与分析

概览

AI 生成的概览

一个托管型 MCP 服务器,让助手估算美国彩票奖金税费、比较一次性领取与年金、拆分合买份额并计算中奖概率。

可以做什么
按州和申报身份估算已知现金奖金的联邦与州税、预扣税和到手金额,纽约部分地区可指定 locality,使用内置的 2026 年规则。将公布的现金选项与 30 期递增年金税后金额比较,给出现值与盈亏平衡利率。估算合买中单个等额成员的份额、税费与预扣税,假设所有成员税务情况相同。计算单次开奖中不同组合的奖池覆盖情况,可选计算税前每张彩票期望回报。结果会注明单位、假设和对应计算器。
适用场景
适合需要快速获得明确标注为估算的美国彩票奖金、预扣税、一次性领取与年金取舍、合买分配或中奖概率的场景,免去手工计算。它是计算器,不提供实时奖池数据或建议。
运行要求
远程 Streamable HTTP 端点,无需 API 密钥或账户。公共端点在 Cloudflare 边缘按 IP 限制约每分钟 120 次请求。也可从源码或发布包本地以 stdio 运行,需要 Node.js 22.12 或更高版本。
安装前请注意
仅为估算,不构成税务或财务建议。税务数据为固定的 2026 年快照,不提供实时更新或奖池查询。不建模跨州抵扣、非居民外国人预扣、多数地方所得税、未来税法或投资税,合买结果假设成员税务情况相同。不购买或核对彩票。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Jackpot Calculator,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.jiankn%2Fjackpot-calculator/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "jackpot-calculator": {
      "type": "http",
      "url": "https://jackpot-calculator-mcp.jiankn.workers.dev/mcp"
    }
  }
}

README

Jackpot Calculator MCP

Four read-only MCP tools for US lottery prize taxes, cash vs annuity comparisons, equal pool shares and jackpot probabilities. Calculations use a fixed 2026 data snapshot and the same engine as Jackpot Calculator.

Connect to the hosted server

Add this Streamable HTTP URL in a client that supports remote MCP servers:

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

No API key is required. The public endpoint allows up to 120 requests per minute per IP at the Cloudflare edge; rate limiting is approximate, not a global quota. Connection examples and output units: Jackpot Calculator MCP setup.

Tools

ToolRequired inputsOutput
calculate_lottery_payoutprize, stateCodeEstimated final tax, withholding and cash take-home
compare_lump_sum_annuityjackpot, cashValue, stateCodeCash and 30-payment annuity, discounted present value and break-even rate
calculate_pool_shareprize, members, stateCodeOne equal owner's share with the whole-ticket withholding threshold
calculate_lottery_oddsgameDistinct-combination jackpot probability; optional expected return with jackpotCash

Money inputs are US dollars. Tax/payout results use integer cents. The odds tool reports money in dollars. Rates and probabilities are fractions, so 0.04 is 4%. Each result states its units, assumptions and related calculator.

Example tool call:

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

The bundled 2026 calculation returns an estimated $320,000 final federal tax and $680,000 take-home, separately from $240,000 federal withholding. See the interactive lottery tax calculator to explore other states and filing statuses.

For game-specific cash estimates, select game: "powerball" or game: "megaMillions", provide the known cash prize and compare it with the Powerball payout calculator or Mega Millions tax calculator. For annuities provide both the published cash option and advertised annuity total; the package never guesses the cash option from a fixed percentage.

Run locally from the source or release archive

Node.js 22.12 or newer is required.

sh
git clone https://github.com/jiankn/jackpot-calculator-mcp.gitcd jackpot-calculator-mcpnpm cinpm testnode src/cli.mjs

The last command starts an MCP stdio server and waits for a client; it is not an interactive CLI prompt. Configure a stdio client with command: "node" and args: ["/absolute/path/to/jackpot-calculator-mcp/src/cli.mjs"]. Only protocol messages go to stdout.

Release archives can also be installed with npm install ./jackpot-calculator-mcp-0.1.0.tgz. An npm registry listing is optional and is not needed for the hosted endpoint.

Calculation boundaries

  • US resident taxpayers, same residence and ticket-purchase state; cross-state credits and nonresident alien withholding are not modeled.
  • Federal and state tax data is bundled, with original source URLs and dates. No live jackpot lookup, automatic tax update, ticket purchase or ticket check.
  • Standard deduction and incremental income tax. State head-of-household uses single-filer state brackets. California assumes a California Lottery prize.
  • NYC and Yonkers need an explicit locality with stateCode: "NY". Maryland uses an average county rate; other local income taxes are excluded.
  • Annuities use 30 payments, first immediately and then annual payments growing 5%. Tax rules and other income stay constant. Future tax law and investment taxes are not modeled. Annuity methodology and calculator.
  • Pool outputs assume all members have the same tax profile. Different people need separate scenarios. Individually rounded fractional-cent shares can differ slightly from the whole prize.
  • Odds assume distinct combinations in one drawing. Expected value excludes taxes, Power Play, jackpot sharing and California pari-mutuel payout differences.

Estimates only, not tax or financial advice. Independent of Powerball, Mega Millions, the Multi-State Lottery Association and state lottery operators. Sources and methodology.

Development and releases

npm test checks known payouts, validation, pool withholding, annuity totals, odds and real stdio/HTTP protocol calls. npm run verify:package packs the allowlisted files, installs the archive into a clean directory and invokes the installed server. CI runs both on Windows and Linux.

scripts/sync-engine.mjs is a maintainer-only snapshot step run within the website checkout, before release. It records source hashes in PROVENANCE.md. Standalone users already have the copied files and do not need to run it.

Code: MIT. Compiled data: CC BY 4.0; see LICENSE-DATA.md and the source URLs inside data/. Issues: https://github.com/jiankn/jackpot-calculator-mcp/issues

来源:README.md,提交 7b505db

工具

4

calculate_lottery_payout

Lottery cash prize after taxes

Estimate taxes and withholding on a known lottery cash prize. Input dollars; result integer cents. Bundled 2026 rules.

输入参数gameprize必填statuslocalitystateCode必填otherIncome

compare_lump_sum_annuity

Compare cash and annuity

Compare a published cash option with 30 growing annuity payments after taxes, including present value and break-even rate.

输入参数gamestatusjackpot必填winnerslocalitycashValue必填stateCode必填otherIncomediscountRatesharePercent

calculate_pool_share

Equal lottery pool shares

Estimate one equal member’s cash prize, taxes and withholding. Each member is assumed to have the specified tax profile.

输入参数gameprize必填statusmembers必填localitystateCode必填otherIncome

calculate_lottery_odds

Jackpot probability and expected return

Calculate jackpot coverage for distinct combinations in one drawing and optional before-tax expected ticket return.

输入参数game必填ticketsjackpotCash

版本历史

1
  1. v0.1.0最新Oct 13, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Calculator 集成