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可網頁執行金融資料與分析

服務詳細資訊

識別碼: io.github.jiankn/jackpot-calculator
傳輸: Streamable HTTP
執行環境: Web executable
信任: Verified
發布於: Oct 13, 2026

安全提示

MCP 服務會接收對話中的工具呼叫請求，並可能執行外部操作。啟用前請先了解該服務能做什麼，並只授予它所需的權限。

註冊中心已驗證此條目所屬的 GitHub 帳號 jiankn。這並不表明該帳號就是產品方。

SourceWeft 的檢查只涵蓋條目是否完整、端點是否回應；不審查伺服器的程式碼，也不審查其工具的行為。

在 README 中新增徽章

向讀者展示該 MCP 服務已收錄於 SourceWeft，徽章連結到本頁。

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.jiankn%2Fjackpot-calculator.svg)](https://sourceweft.com/mcp/io.github.jiankn%2Fjackpot-calculator?utm_source=readme&utm_medium=badge)

概覽

AI 產生的概覽

一個託管型 MCP 伺服器，讓助理估算美國彩券獎金稅費、比較一次領取與年金、拆分合購份额並計算中獎機率。

可以做什麼: 依州別與申報身分估算已知現金獎金的聯邦與州稅、預扣稅和實拿金額，紐約部分地區可指定 locality，使用內建的 2026 年規則。將公布的現金選項與 30 期遞增年金稅後金額比較，給出現值與損益兩平利率。估算合購中單一等額成員的份额、稅費與預扣稅，假設所有成員稅務情況相同。計算單次開獎中不同組合的獎池涵蓋情況，可選計算稅前每張彩券期望報酬。結果會註明單位、假設和對應計算器。
適用情境: 適合需要快速取得明確標示為估算的美國彩券獎金、預扣稅、一次領取與年金取捨、合購分配或中獎機率的場合，省去手算。它是計算器，不提供即時獎池資料或建議。
執行需求: 遠端 Streamable HTTP 端點，無需 API 金鑰或帳號。公開端點在 Cloudflare 邊緣依 IP 限制約每分鐘 120 次請求。也可從原始碼或發行封裝在本機以 stdio 執行，需要 Node.js 22.12 或更新版本。

安裝前請注意

僅為估算，不構成稅務或財務建議。稅務資料為固定的 2026 年快照，不提供即時更新或獎池查詢。未模擬跨州抵扣、非居民外國人預扣、多數地方所得稅、未來稅法或投資稅，合購結果假設成員稅務情況相同。不購買或核對彩券。

安裝

在 SourceWeft 中

開啟儀表板中的 Jackpot Calculator，將其新增到工作區。
為需要使用其工具的對話啟用該服務。

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:

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

Tool	Required inputs	Output
`calculate_lottery_payout`	`prize`, `stateCode`	Estimated final tax, withholding and cash take-home
`compare_lump_sum_annuity`	`jackpot`, `cashValue`, `stateCode`	Cash and 30-payment annuity, discounted present value and break-even rate
`calculate_pool_share`	`prize`, `members`, `stateCode`	One equal owner's share with the whole-ticket withholding threshold
`calculate_lottery_odds`	`game`	Distinct-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" }}

{  "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.

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

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