Student Loan IDR MCP

収入が不定期・季節変動・時給・フリーランス・請負契約など、単一の年間の数字として表すのが難しい人々のための、小規模なCloudflare Workers MCPサーバーです。

このサービスは、次の3つのMCPツールを公開しています:

1. calculate_alt_income_student_loan — 変動する課税所得を年間推定値に正規化し、RAP、IBR、PAYE、ICRの返済プラン見積もりを計算します。

2. get_repayment_documentation_template — 現在の収入と収入の変更に関する、クリーンなMarkdown形式の裏付け声明テンプレートを生成します。

3. policy_status — 不変のポリシースナップショット、サポート対象プラン、既知の廃止予定日、組み込みICR係数テーブルの有効期間、公式ソースへのリンクを報告します。

存在理由

Federal Student Aidは、納税申告情報が借り手の現在の収入を反映していない状況において、現在の収入に関する書類を認めています。現在のIDR申請フォームでは、書類には通常、給与明細または雇用主からの書簡が含まれるとされています。書類が入手できない場合や、借り手が収入について説明したい場合は、各収入源とその住所を明記した署名済みの声明を添付できます。

このプロジェクトは、税務書類、控除、または資格を偽造しません。見積もり、決定論的な資格スクリーニングオブジェクト、およびユーザーが編集可能な裏付け書類テンプレートを生成します。

Related MCP server: gsa-calc

ポリシースナップショット

決定論的定数は、2026-08-27 に明示的にバージョン付けされています。

• 2026年のHHS貧困ガイドラインが、米国本土/コロンビア特別区、アラスカ、ハワイについて組み込まれています。

• RAPは、2026年7月1日に利用可能となったため含まれています。

• IBR、PAYE、ICRは、loan.eligibilityLoans が指定された場合に、明示的なローン種別/貸付実行時期の資格オブジェクトを使用して、対象となるレガシーローンについてモデル化されます。

• 公式の2026年ICR所得パーセンテージ係数テーブルが、2026年7月1日から2027年6月30日まで(公開されているAGI行間の線形補間を含む)組み込まれています。

• PAYEとICRは、現在のところ遅くとも2028年7月1日までに終了する予定です。

• SAVEは、このスナップショットでは意図的にモデル化されていません。

公式リファレンス:

• https://studentaid.gov/articles/faqs-idr-plan/

• https://studentaid.gov/sites/default/files/IncomeDrivenRepayment-en-us.pdf

• https://aspe.hhs.gov/topics/poverty-economic-mobility/poverty-guidelines

• https://www.govinfo.gov/content/pkg/FR-2026-06-09/pdf/2026-11540.pdf

収入の正規化

対応する収入周期:

• 時給制 (hourlyRate × hoursPerWeek × weeksPerYear)

• 毎週 (amount × 52)

• 隔週 (amount × 26)

• 月2回 (amount × 24)

• 毎月 (amount × 12)

• 年額

• 季節ごとの一括支払い(提供された支払い額の合計)

このサービスは、総収入に偽の「標準控除」を適用しません。IDRの計算は、AGIまたは現在の収入に関する書類に基づいています。呼び出し側は、adjustedGrossIncomeOverride を指定するか、推定のabove-the-line調整(AGI算出前の調整項目)を指定できます。それ以外の場合は、年間換算した課税総収入が、控えめなAGI推定値として使用されます。

V0.2 資格入力

loan.eligibilityLoans は、loanType と大まかな貸付実行時期(before_2026_07_01 または on_or_after_2026_07_01)を持つ明示的なローン記録を受け付けます。計算機は、ローンごとの評価と、eligible、ineligible、conditional、mixed、unknown のいずれかを含むプランレベルの eligibility オブジェクトを返します。

資格オブジェクトは、決定論的なスクリーニング支援ツールであり、公式の判定ではありません。提供されていない借り手固有の事実は、創作されることなく、conditionalまたはunknownのままになります。

PAYEについては、オプションの借り手/日付フラグが、公表されている2007年10月1日および2011年10月1日の条件をモデル化します。ICRについては、呼び出し側は taxFilingStatus または loan.icrIncomeFactorCategory を提供でき、計算機は公式の2026年係数を自動的に選択して補間します。loan.icrIncomePercentageFactor は、明示的な上書きとしてのみ利用可能です。

MCP

エンドポイント: POST /mcp

サポートされているJSON-RPCメソッド:

• initialize

• ping

• tools/list

• tools/call

ツール呼び出しの例

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "calculate_alt_income_student_loan",
    "arguments": {
      "income": [
        { "cadence": "hourly", "hourlyRate": 28, "hoursPerWeek": 25, "weeksPerYear": 48 },
        { "cadence": "seasonal_lump_sum", "seasonalPayments": [3500, 4200] }
      ],
      "region": "contiguous_us",
      "familySize": 2,
      "taxFilingStatus": "single",
      "dependentsClaimedOnFederalTaxReturn": 1,
      "loan": {
        "principal": 42000,
        "annualInterestRatePercent": 5.5,
        "newBorrowerOnOrAfterJuly1_2014": true,
        "eligibilityLoans": [
          { "loanType": "direct_unsubsidized", "disbursementPeriod": "before_2026_07_01" }
        ]
      }
    }
  }
}

ポリシー更新ワークフロー

リポジトリのCIワークフローは、スケジュール実行または手動実行の policy-refresh ジョブもサポートしています。現在の公式ポリシーソースのフィンガープリントを取得し、変更されたソーススナップショットについてはプルリクエストを使用します。返済定数や資格ルールを自動的に書き換えることはありません。ポリシー変更がマージされる前に、人間によるレビューが必要です。

開発

npm install
npm run typecheck
npm test
npm run dev

Wranglerでデプロイ:

npm run deploy

安全性 / 適用範囲

これは、見積もりツールおよび文書テンプレート生成ツールであり、法的、税務、財務、または申請に関するアドバイスではありません。IDR申請を提出することはなく、公式の資格を判定することもありません。借り手は、StudentAid.govと自身のローンサービス事業者で結果を確認する必要があります。