Finology Software for Borrowers MCP server

Finology MCP Server — deterministic federal student loan math for AI agents

Language models guess at federal student loan rules. This doesn't.

@finology/mcp-server connects Claude, Cursor, or any MCP client directly to Finology Software's parity-verified federal repayment engine. Every number is computed server-side against current federal rules and returned with a parityVerified flag. No formulas are approximated, and none are hardcoded into this package.

Why this exists

Federal repayment eligibility is not arithmetic, it is regulation, and it is the part models get wrong most confidently:

balance and it will usually produce a RAP payment. This server returns the exclusion and the rule behind it.

• A Parent PLUS loan is not RAP-eligible. Ask a model for the best plan on a Parent PLUS

$50 per qualifying dependent — and a spouse is not a dependent. Approximating it from older IDR formulas gives the wrong answer.

• RAP is assessed on full AGI with no poverty-line shield, on a sliding 1%–10% scale, less

• A consolidation that repaid a PLUS loan is restricted to ICR.
• PAYE and SAVE are closed to new enrollment.

Tools

comparefederalstudentloanrepayment_plans

Compares a balance across every plan the borrower is actually eligible for — RAP, IBR, ICR, PAYE, SAVE, Graduated, Extended, tiered Standard — returning monthly payment, lifetime cost, projected forgiveness and tax on forgiveness for each, plus the plans that are excluded and the eligibility rule that excludes them.

comparemarriedfilingjointlyvsseparatelystudent_loans

For a married borrower, prices the filing-status decision. Filing separately removes the spouse's income from the income-driven payment calculation, which routinely moves the lifetime loan cost by tens of thousands of dollars.

When both spouses carry federal loans, pass the spouse's own federal balance as well: under joint filing the household payment is split by each spouse's share of the combined balance (34 CFR 685.209(g)(1)(i)), and leaving it out overstates the borrower's payment.

It answers half the question on purpose, and says so. The engine models the loan side exactly and does not model the tax cost of filing separately — lost credits, worse brackets, community-property splits — which is often large enough to reverse the answer. Returning only the favourable half as if it were the whole decision would be the same confident half-truth this server exists to replace.

estimaterapmonthly_payment

The RAP monthly payment alone, for the common case. Requires the borrower's AGI and refuses to proceed without it — an assumed zero returns the $10/month RAP floor, which reads exactly like a real answer.

Going further (no sales call, no marketing)

Every answer ends with the next rung, and finologyserviceinfo returns it structured:

25 calls/month), then the keyed endpoints with X-Api-Key. The keyed rung is the answer-of-record surface: every answer is persisted with its rule version and an inputs hash before it is served. Production limits by email until self-serve checkout ships. Docs: https://finology.tech/developers/

• Advisor: self-serve trial of Finology Software, no credit card.
• Developer / operator: an instant free sandbox key (POST https://api.finology.tech/v1/keys/sandbox,

Install

Claude Desktop — add to claudedesktopconfig.json:

Shortened. The full README is on GitHub.