Finology MCP Server 是 Finology Software 推出的 MCP（Model Context Protocol）服务器，旨在为 AI 智能体提供确定性的 2026 年美国联邦学生贷款还款数学计算。语言模型常常对联邦学生贷款规则进行猜测，而该服务器将 Claude、Cursor 或任何 MCP 客户端直接连接到 Finology Software 的 parity-verified 联邦还款引擎。每个数字都在服务端依据现行联邦规则计算，并返回 parityVerified 标志。公式不在本包中近似，也不硬编码在包内。
用途
联邦还款资格不是算术，而是法规，也是模型最容易自信地弄错的部分。例如：Parent PLUS 贷款不符合 RAP 资格，但模型在被问及 Parent PLUS 余额的最佳计划时，通常会生成一个 RAP 还款额；该服务器会返回排除项及其背后的规则。RAP 基于全额 AGI 评估，没有贫困线保护，采用 1%–10% 的滑动比例，减去每个合格受抚养人 50 美元，且配偶不是受抚养人。用旧的 IDR 公式近似会得到错误答案。偿还了 PLUS 贷款的合并贷款仅限于 ICR。PAYE 和 ICR 在特定条件下仍开放，直至不晚于 2028 年 7 月 1 日。根据 Federal Student Aid，PAYE 对 PAYE “新借款人”开放，条件是在 2026 年 7 月 1 日或之后没有新贷款或合并；ICR 对合格贷款类型开放。2026 年 7 月 1 日或之后发放的贷款只能使用 tiered Standard 计划或 RAP。SAVE 已停止新注册。
主要能力
该服务器提供以下工具：
- compare_federal_student_loan_repayment_plans：比较借款人在其实际有资格的所有计划（Standard、tiered 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，没有它则拒绝继续——假设为零会返回 10 美元/月的 RAP 下限，这读起来就像一个真实答案。
使用方式
每个答案都以下一步结束，finology_service_info 以结构化方式返回：
- 顾问：Finology Software，每位顾问每月 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 连接的方式，或发送 X-Api-Key 请求头。每个答案都被记录并带有验证链接。
- Claude（网页、桌面和移动端）：一键连接。Finology Software 列在 Claude Connectors Directory 中。在那里添加连接器并使用免费的 Finology Software 登录名（无需信用卡）登录：总共 5 个问题，无每日限制。订阅者无限制，订阅者的登录名还会在同一连接器中列出他们自己的客户（list_my_clients、run_projection_for_client、get_balance_trajectory_for_client）。
以下为手动方式，适用于其他 MCP 客户端或本地安装。
Claude Desktop——添加到 claude_desktop_config.json：
本地包不需要 API 密钥和账户：它调用公共计算端点。
适用场景
适用于需要准确联邦学生贷款还款计算的 AI 智能体场景，例如财务规划、贷款咨询、借款人自助工具等。特别适合需要区分不同还款计划资格、比较报税身份影响、估算 RAP 月供的场景。
限制
本仓库故意不包含：RAP/OBBB 公式、收入驱动还款数学、豁免和税务炸弹预测、计划资格规则以及 NSLDS 解析。这些运行在 Finology 的服务器上。这不仅是为了保护引擎。联邦还款规则每年都在变化——贫困指南、税率、RAP/OBBB 实施指南、法院挑战。复制到 npm 包中的公式在几个月内就会过时，并且无法在已有的安装中更正。调用维护的端点是该工具保持真实的唯一形态。
本仓库包含：输入模式、HTTP 调用以及错误处理，将 API 自己的字段级消息传递给模型，而不是将其扁平化为“请求失败”。
这些工具返回数字。它们不产生面向客户的交付物、保存借款人记录、解析 NSLDS 文件或跟踪 PSLF 合格付款随时间的变化。对于这些，以及随着规则变化保持最新的借款人账簿：finology.tech
本地包按 IP 限速。不构成财务建议。
