Finology Student Loan Calculator

Finology MCP サーバー — AI エージェント向けの決定論的な連邦学生ローン計算

言語モデルは連邦学生ローンの規則を推測します。このサーバーは違います。

@finology/mcp-server は、Claude、GitHub Copilot、Cursor、その他あらゆる MCP クライアントを Finology Software の同等性検証済み連邦返済エンジンに直接接続します。すべての 数値は最新の連邦規則に基づいてサーバー側で計算され、parityVerified フラグとともに返されます。 数式を近似したり、このパッケージにハードコードしたりすることはありません。

このサーバーが必要な理由

連邦返済プランの適用資格は単なる計算ではなく、規制に基づいています。モデルが最も自信たっぷりに間違えるのは、まさにこの部分です。

• Parent PLUS ローンは RAP の対象ではありません。 Parent PLUS の残高に最適なプランをモデルに尋ねると、通常は RAP の支払額を提示します。このサーバーは対象外であることと、その根拠となる規則を返します。
• RAP は貧困ラインによる控除なしに AGI 全額を基準とし、1%～10%の段階制で算定した額から、適格な扶養家族 1 人につき50ドルを差し引きます。 配偶者は扶養家族ではありません。旧来の IDR 算式から近似すると、誤った結果になります。
• PLUS ローンを返済した統合ローンは ICR に限定されます。
• 条件付きで、PAYE と ICR は遅くとも2028年7月1日まで利用できます。 Federal Student Aid の案内によると、PAYE は2026年7月1日以降に新たなローンまたは統合ローンを利用していない PAYE の「新規借り手」が利用でき、ICR は対象となるローンの種類で利用できます。2026年7月1日以降に組まれたローンで利用できるのは、段階制 Standard プランまたは RAP のみです。SAVE の新規登録は終了しています。

ツール

compare_federal_student_loan_repayment_plans

借り手が実際に利用資格を持つすべてのプラン（Standard、段階制 Standard、RAP、IBR、PAYE、ICR）について残高を比較し、各プランの月々の支払額、生涯総費用、予測免除額、免除額に対する税額を返します。さらに、対象外となるプランと、その対象外の根拠となる適格性規則も返します。

compare_married_filing_jointly_vs_separately_student_loans

既婚の借り手向けに、申告区分の選択による費用を比較します。別々に申告すると、所得連動型の支払額計算から配偶者の収入が除外されるため、生涯ローン費用が数万ドル変わることも珍しくありません。

両方の配偶者が連邦ローンを抱えている場合は、配偶者自身の連邦ローン残高も渡してください。共同申告では、世帯の支払額がそれぞれの配偶者の合計残高に占める割合に応じて分割されます（34 CFR 685.209(g)(1)(i)）。この情報を省くと、借り手の支払額が過大に見積もられます。

このツールは意図的に質問の半分だけに答え、そのことを明示します。 エンジンはローン側を正確にモデル化しますが、別々に申告することで生じる税負担（失われる控除、悪化する税率区分、共有財産の分割など）はモデル化しません。こうした税負担は、答えを覆すほど大きいこともよくあります。有利な側面だけを全体の判断材料であるかのように返すのは、このサーバーがなくそうとしている、自信たっぷりの半分だけの真実と同じです。

estimate_rap_monthly_payment

よくあるケース向けに、RAP の月々の支払額だけを見積もります。借り手の AGI が必要で、AGI がなければ処理を続行しません。AGI をゼロと仮定すると RAP の最低額である月10ドルが返され、実際の回答そのものに見えてしまうためです。

さらに詳しく（営業電話やマーケティングはありません）

回答には必ず次のステップが含まれ、finology_service_info はそれを構造化して返します。

• アドバイザー： Finology Software。アドバイザー1人あたり月額99米ドル、または年払いで月額89米ドルです。セルフサービスの7日間トライアルがあり、カードは不要です（7日目以降もサブスクリプションを継続するには、カードを登録してください）。顧客ファイルのインポート、シナリオの保存、ブランド入りの顧客レポートに加え、事務所独自のウェブサイト2つまでで学生ローン計算ツールとSAI計算ツールを利用できます。
• 開発者／運用担当者： 即時発行される無料のサンドボックスキー（POST https://api.finology.tech/v1/keys/sandbox、月25回の呼び出し）を利用し、その後はX-Api-Keyを使ってキー認証エンドポイントを利用できます。キー認証の段階では、回答を提供する前に、ルールのバージョンと入力ハッシュを付けてすべての回答を保存します。製品版へのアクセスはセルフサービスで、Developerは月額49米ドルで2,000回、Platformは月額499米ドルで100,000回の呼び出しが可能です。ドキュメント：https://finology.tech/developers/
• キー認証リモートMCP： https://mcp.finology.tech/mcp。Finology Softwareのログイン（OAuth）でサインインする方法（Claude、ChatGPT、Microsoft Copilotの接続に使用します）か、X-Api-Keyヘッダーを送信する方法があります。すべての回答がログに記録され、検証リンクが付与されます。

インストール

Claude（ウェブ、デスクトップ、モバイル）— ワンクリック。 Finology SoftwareはClaude Connectors Directoryに掲載されています。そこでコネクターを追加し、無料のFinology Softwareログインでサインインしてください（カード不要）。質問は合計5回で、1日あたりの上限はありません。サブスクライバーは無制限に利用でき、サブスクライバーのログインでは同じコネクターに自身の顧客も表示されます（list_my_clients、run_projection_for_client、get_balance_trajectory_for_client）。

ChatGPT。 Finology SoftwareはChatGPTプラグインディレクトリに掲載されており、同じ無料ログインで利用できます。

Microsoft Copilot。 GitHub Copilot（無料プランを含む）では、リモートサーバーを一度追加します：copilot mcp add --transport http finology https://mcp.finology.tech/free。その後、ツールを初めて呼び出すときにFinology Softwareのログインでサインインします。Visual Studio CodeのGitHub Copilotでも、同じアドレスとサインイン方法を使用します。Copilot Studioでは、そのURLとOAuth 2.0 Dynamic discoveryを使ってModel Context Protocolツールを追加します。エージェントの実行には、所属する事務所のCopilotクレジットを使用します。セットアップ：https://finology.tech/finology-software-in-microsoft-copilot/

以下はすべて、その他のMCPクライアントまたはローカルインストール向けの手動の手順です。

Claude Desktop — claude_desktop_config.jsonに追加します：

{
  "mcpServers": {
    "finology": {
      "command": "npx",
      "args": ["-y", "@finology/mcp-server"]
    }
  }
}

ローカルパッケージにAPIキーやアカウントは不要です。公開計算エンドポイントを呼び出します。

このリポジトリに含まれるもの／含まれないもの

意図的に含めていないもの： RAP／OBBBの計算式、所得連動型返済の計算、返済免除と税負担の予測、返済プランの適格性ルール、NSLDSの解析です。これらはFinologyのサーバー上で実行されます。

これは単にエンジンを保護するためだけではありません。連邦政府の返済ルールは毎年変わります — 貧困ガイドライン、税率区分、RAP／OBBBの実施指針、裁判による異議申し立てなどです。npmパッケージにコピーした計算式は数か月で誤ったものになり、すでにインストールされているパッケージでは修正できません。メンテナンスされているエンドポイントを呼び出すことだけが、このツールを正確に保つ方法です。

含まれるもの： 入力スキーマ、HTTP呼び出し、そしてエラー処理です。API固有のフィールド単位のメッセージを「リクエストに失敗しました」と一括りにせず、そのままモデルに渡します。

制限事項

これらのツールは数値を返します。顧客向けの成果物の作成、借り手の記録の保存、NSLDSファイルの解析、PSLFの適格な支払いの経時的な追跡は行いません。これらが必要な場合や、ルール変更に応じて最新の状態に保つ借り手の顧客台帳が必要な場合は、**finology.tech**をご覧ください。

ローカルパッケージはIPごとにレート制限されています。金融に関する助言ではありません。

ライセンス

MIT