530A Model calculator

530A モデル

530amodel.com — 530A 管理型退職口座（「Trump Accounts」）向けの、無料でプライバシーを最優先し、モバイルでの利用を重視したシナリオ計画用計算ツールです。

ログイン不要です。メールアドレスの収集はありません。収益化もありません。すべての計算はブラウザー内で実行されます。

公開 API ／ MCP サーバーを利用する

エンジンは無料で呼び出せます。API キーは不要で、データも保存されません。530amodel.com のクレジット表記をお願いします。

• JSON API — https://api.530amodel.com（POST /v1/project、GET /v1/rules、 GET /v1/returns。リクエスト／レスポンスのスキーマをすべて含む OpenAPI 3.1）
• MCP サーバー — https://mcp.530amodel.com（ストリーミング可能な HTTP。ツールは project_530a、 explain_530a、search、fetch。レジストリ名は com.530amodel/calculator）。Claude と ChatGPT の カスタムコネクターとして、また Anthropic／OpenAI のエージェント API と連携して利用できます。
• ドキュメントとプラットフォーム別クイックスタート — 530amodel.com/api · 機械可読なマップ：llms.txt、 llms-full.txt
• お問い合わせ — [email protected]

構成

packages/
  engine/     # pure TS calculation engine — zero deps, deterministic, integer-cents money
  config/     # legal figures + sources + verifiedAt + feature flags (single source of truth)
  ui/         # design tokens, shared components, charts
apps/
  web/        # Astro static site (widget, advanced model, content pages)
  workers/    # Cloudflare Workers: analytics beacon, rollup cron, newsfeed cron, email
  api/        # public calculator API (wraps the engine; OpenAPI; cache-by-input-hash)
  mcp/        # read-only MCP server (project_530a / explain_530a)
reference/    # Python reference implementation + golden-vector generator
e2e/          # Playwright specs (user journeys UC-1..UC-7)

必ず守ること

1. 金融計算は正確かつ決定論的で、独立したテストを実施します（Python リファレンス実装のゴールデンベクターは、TS エンジンとセント単位まで一致する必要があります）。
2. 静的ファーストです。計算はクライアント側で行われるため、ユーザーが 100 万人でも 1 人でもコストは同じです。
3. 依存関係を最小限にし、個人を特定できる情報（PII）を扱わず、攻撃対象領域を小さく保ち、CI ですべてをスキャンします。
4. ユーザーに提示する主張はすべて誠実であること。範囲には推定値と明記し、法的な数値には出典を引用し、未検証の項目は OFF の機能フラグの背後に置きます（packages/config/src/flags.ts）。

開発

pnpm install
pnpm check     # lint + typecheck + test + build (same as CI)
pnpm --filter @530a/web dev

Node ≥ 22、pnpm ≥ 11。エンジンの数値仕様：金額は整数のセント（bigint）で扱い、残高は毎月のステップごとに最近接偶数丸めで量子化します。表示形式の変換には formatMoney のみを使用します。

免責事項

このツールが提供するのは教育目的の推定値のみであり、金融、税務、法律に関する助言ではありません。市場予測は確率に基づくもので、保証ではありません。