Finology Student Loan Calculator

Finology MCP 服务 — 面向 AI Agent 的确定性联邦学生贷款计算

大语言模型会猜测联邦学生贷款规则，但这个工具不会。

@finology/mcp-server 可将 Claude、GitHub Copilot、Cursor 或任何 MCP 客户端直接连接到 Finology Software 经一致性验证的联邦还款引擎。每个 数值都在服务端依据当前联邦规则计算，并附带 parityVerified 标记返回。公式不会被近似处理，也不会硬编码在此软件包中。

存在的原因

联邦还款资格不是算术问题，而是法规问题；这也是模型最容易出错、却最自信的部分：

• Parent PLUS 贷款不符合 RAP 资格。 询问模型 Parent PLUS 余额适用的最佳计划，它通常会给出 RAP 还款额。此服务会说明该贷款不符合资格，并指出相关规则。
• RAP 按全部 AGI 计算，不设贫困线豁免额度，采用 1%–10% 的浮动比例，每名符合条件的受抚养人减免 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 为零，就会得到 RAP 每月 10 美元的最低还款额，看起来就像真实答案一样。

更进一步（无需销售通话，不做营销）

每个回答最后都会给出下一步方案，finology_service_info 会以结构化形式返回：

• 顾问： Finology Software，US $99/位顾问/月，或按年计费时每月 $89；提供自助式 7 天试用，无需银行卡（第 7 天后如需继续订阅，请添加银行卡）。包含客户档案导入、已保存的方案、带品牌标识的客户报告，以及可用于公司自有网站（最多 2 个）的学生贷款和 SAI 计算器。
• 开发者 / 运营者： 即时获取免费的沙盒密钥（POST https://api.finology.tech/v1/keys/sandbox， 每月 25 次调用），之后可通过 X-Api-Key 使用带密钥的端点。带密钥的层级提供正式答案：每个答案都会在返回前保存，并附带规则版本和输入哈希。 生产环境访问权限可自助开通：Developer，每月 US $49，可调用 2,000 次；或 Platform，每月 US $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 次， 没有每日限制。订阅用户可无限使用，订阅用户的登录账号还会在同一个连接器中列出自己的客户（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 工具；运行 Agent 会使用贵公司的 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