Jackpot Calculator

ジャックポット計算機 MCP

米国の宝くじ賞金にかかる税金、現金受取と年金受取の比較、均等なプール分配、ジャックポットの当選確率を計算する、読み取り専用の MCP ツールを4つ提供します。計算には、固定された2026年のデータスナップショットと、ジャックポット計算機と同じエンジンを使用します。

ホスト型サーバーに接続する

リモート MCP サーバーに対応したクライアントに、次の Streamable HTTP URL を追加してください。

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

API キーは不要です。公開エンドポイントでは、Cloudflare のエッジで IP アドレスごとに毎分最大120リクエストを受け付けます。レート制限は概算であり、グローバルな割り当てではありません。接続例と出力単位については、Jackpot Calculator MCP のセットアップをご覧ください。

ツール

ツール	必須入力	出力
calculate_lottery_payout	prize、stateCode	推定最終税額、源泉徴収額、手取り現金額
compare_lump_sum_annuity	jackpot、cashValue、stateCode	現金受取と30回払いの年金受取、割引現在価値、損益分岐利率
calculate_pool_share	prize、members、stateCode	宝くじ券全体の源泉徴収基準額を考慮した、1人あたりの均等な持分
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 サーバーが起動し、クライアントからの接続を待機します。対話型の CLI プロンプトではありません。stdio クライアントには、command: "node" および args: ["/absolute/path/to/jackpot-calculator-mcp/src/cli.mjs"] を設定してください。標準出力に出力されるのは、プロトコルメッセージのみです。

リリースアーカイブは、npm install ./jackpot-calculator-mcp-0.1.0.tgz を実行してインストールすることもできます。npm レジストリへの掲載は任意であり、ホスト型エンドポイントの利用には必要ありません。

計算の前提

• 米国居住者の納税者で、居住地とチケット購入州が同一であることを前提とします。州をまたぐ税額控除や非居住外国人の源泉徴収はモデル化していません。
• 連邦税と州税のデータは、元のソース URL と日付を含めて同梱されています。ジャックポットのリアルタイム検索、自動的な税データの更新、チケットの購入や確認は行いません。
• 標準控除と増分所得税を使用します。州税の世帯主区分では、単身者の州税税率区分を使用します。カリフォルニア州では、カリフォルニア州の宝くじの賞金を想定しています。
• NYC と Yonkers では、stateCode: "NY" を指定した locality が必要です。メリーランド州では郡税率の平均を使用し、その他の地方所得税は除外しています。
• 年金払いは30回の支払いで、初回は直ちに行われ、その後は毎年5%ずつ増加します。税制とその他の所得は一定とします。将来の税法や投資税はモデル化していません。年金払いの方法と計算ツール。
• プールの出力は、すべてのメンバーの税務プロファイルが同じであることを前提とします。異なる人については、シナリオを個別に作成する必要があります。セント未満の端数を個別に丸めた分配額は、賞金全体の額とわずかに異なる場合があります。
• 当選確率は、1回の抽選で組み合わせが重複しないことを前提としています。期待値には、税金、Power Play、ジャックポットの分配、カリフォルニア州のパリミュチュエル方式による払戻額の差異は含まれません。

あくまで推定値であり、税務または財務に関する助言ではありません。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