Finology Software MCP server
Commit Nov 6, 2026Provides deterministic federal student loan repayment calculations and plan comparisons for AI agents and financial advisors.
Also known as Finology-tech/finology-mcp, verified-engine, @finology/mcp-server
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- 847
- Latest version
- 0.2.6
- Last commit
- Nov 6, 2026
- License
- MIT
What is Finology Software MCP?
Finology Software provides deterministic federal student loan repayment calculations and plan comparisons for AI agents and financial advisors.
Summary generated from the project's README
About Finology Software MCP server
Financial advisors and developers can use this server to perform deterministic federal student loan repayment calculations through AI clients like Claude, GitHub Copilot, or Cursor. Unlike standard language models that may guess at complex regulations, this tool connects to a parity-verified engine to provide accurate monthly payments, lifetime costs, and projected forgiveness amounts. It ensures compliance with current federal rules, specifically handling nuances like Parent PLUS loan exclusions and the specific requirements for the RAP plan.
Users can run the server locally via npx without an account, or connect to a remote instance using OAuth or an API key. The server includes specialized tools such as compare_federal_student_loan_repayment_plans to evaluate eligibility across Standard, IBR, PAYE, and ICR plans, and compare_married_filing_jointly_vs_separately_student_loans to model the impact of filing status on household debt. It also provides estimate_rap_monthly_payment for quick calculations based on adjusted gross income.
What you can do with it
- 1Compare student loan repayment plansAn AI agent can evaluate which federal repayment plan offers the lowest lifetime cost for a specific loan balance and income.
- 2Analyze married filing status impactA developer can ask an AI to determine if filing taxes separately would reduce a married borrower's monthly student loan payment.
- 3Calculate RAP monthly paymentsA user can quickly estimate a monthly payment under the RAP plan using a borrower's adjusted gross income.
- 4Verify loan eligibility rulesAn AI can explain why certain repayment plans are unavailable to specific loan types like Parent PLUS loans.
Written from the project's README. Every use case is checked against a quote from it.
How to install Finology Software MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Finology Software MCP in Claude Code
$ claude mcp add verified-engine -- npx -y @finology/mcp-serverInstall Finology Software MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"verified-engine": {
"command": "npx",
"args": [
"-y",
"@finology/mcp-server"
]
}
}
}Install Finology Software MCP in VS Code
.vscode/mcp.json
{
"servers": {
"verified-engine": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@finology/mcp-server"
]
}
}
}Install Finology Software MCP in VS Code CLI
$ code --add-mcp '{"name":"verified-engine","type":"stdio","command":"npx","args":["-y","@finology/mcp-server"]}'Install Finology Software MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"verified-engine": {
"command": "npx",
"args": [
"-y",
"@finology/mcp-server"
]
}
}
}Install Finology Software MCP in Codex
$ codex mcp add verified-engine -- npx -y @finology/mcp-serverInstall Finology Software MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.verified-engine] command = "npx" args = ["-y", "@finology/mcp-server"]
Install Finology Software MCP in Gemini CLI
$ gemini mcp add -s user verified-engine npx -- -y @finology/mcp-serverInstall Finology Software MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"verified-engine": {
"command": "npx",
"args": [
"-y",
"@finology/mcp-server"
]
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for @finology/mcp-server 0.4.9 in an isolated container with no network and no keys. It answered and listed 4 tools.
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablefinology-tech/finology-mcp is public and reachablegithub.com/finology-tech/finology-mcp ↗Pass
- Package names this repository as its source@finology/mcp-server names finology-tech/finology-mcp as sourcenpmjs.com/package/@finology/mcp-server ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-06github.com/finology-tech/finology-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @finology/mcp-serverPass
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubFinology 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, GitHub Copilot, 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:
- A Parent PLUS loan is not RAP-eligible. Ask a model for the best plan on a Parent PLUS balance and it will usually produce a RAP payment. This server returns the exclusion and the rule behind it.
- RAP is assessed on full AGI with no poverty-line shield, on a sliding 1%–10% scale, less $50 per qualifying dependent — and a spouse is not a dependent. Approximating it from older IDR formulas gives the wrong answer.
- A consolidation that repaid a PLUS loan is restricted to ICR.
- PAYE and ICR are still open, with conditions, until no later than July 1, 2028. Following Federal Student Aid, PAYE is open to a PAYE "new borrower" with no new loan or consolidation on or after July 1, 2026, and ICR is open to eligible loan types. Loans made on or after July 1, 2026 can use only the tiered Standard plan or RAP. SAVE is closed to new enrollment.
Tools
compare_federal_student_loan_repayment_plans
Compares a balance across every plan the borrower is actually eligible for — Standard, tiered Standard, RAP, IBR, PAYE and ICR — 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.
A balance and income are enough. A linked loan account often shows the balance only. Omit
ratePct and the tool uses the 2026-27 federal rate for the loan type (undergraduate Direct
Unsubsidized or Subsidized 6.52%, Grad PLUS and Parent PLUS 9.07%) and says so as the first line
of the answer. Graduate and professional Direct Unsubsidized loans carry 8.07%; the answer names
it, so pass ratePct: 8.07 for those. A consolidation loan has no federal rate (it is the weighted
average of the loans it repaid, rounded up to the next one-eighth of a percent), so it still needs
ratePct, and the tool asks for it.
Set loansMadeOnOrAfterJuly2026: true when the loans were first disbursed (or consolidated) on or
after July 1, 2026. The engine then prices only the plans new loans can elect: RAP and the tiered
Standard plan (a Parent PLUS loan: the tiered Standard plan only). Left false, the loans are run as
made before that date.
compare_married_filing_jointly_vs_separately_student_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.
A balance and both incomes are enough here too: ratePct and loansMadeOnOrAfterJuly2026 work as
in the plan comparison above.
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 favorable half as if it were the whole decision would be the same confident half-truth this server exists to replace.
estimate_rap_monthly_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 finology_service_info returns it structured:
- Advisor: Finology Software, US $99 per advisor per month or $89 per month billed annually, with a self-serve 7-day trial, no card required (add a card to keep the subscription after day 7). Includes client file import, saved scenarios, branded client reports, and the student loan and SAI calculators on up to 2 of the firm's own websites.
- Developer / operator: an instant free sandbox key (
POST https://api.finology.tech/v1/keys/sandbox, 25 calls/month), then the keyed endpoints withX-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 access is self-serve: Developer, US $49 a month for 2,000 calls, or Platform, US $499 a month for 100,000 calls. Docs: https://finology.tech/developers/ - Keyed remote MCP:
https://mcp.finology.tech/mcp. Sign in with a Finology Software login (OAuth), which is how Claude, ChatGPT and Microsoft Copilot connect, or send theX-Api-Keyheader. Every answer is logged and carries a verify link.
Install
Claude (web, desktop and mobile) — one click. Finology Software is listed in the
Claude Connectors Directory. Add the
connector there and sign in with a free Finology Software login (no card): 5 questions in total,
no daily limit. Subscribers are unlimited, and a subscriber's login also lists their own clients in
the same connector (list_my_clients, run_projection_for_client,
get_balance_trajectory_for_client).
ChatGPT. Finology Software is in the ChatGPT plugin directory, with the same free login.
Microsoft Copilot. GitHub Copilot (including its free plan) adds the remote server once:
copilot mcp add --transport http finology https://mcp.finology.tech/free, then signs in with a
Finology Software login the first time it calls a tool; GitHub Copilot in Visual Studio Code uses the
same address and sign-in. In Copilot Studio, add a Model Context Protocol tool with that URL and
OAuth 2.0 Dynamic discovery; running the agent uses your firm's Copilot credits. Setup:
https://finology.tech/finology-software-in-microsoft-copilot/
Everything below is the manual route, for other MCP clients or for a local install.
Claude Desktop — add to claude_desktop_config.json:
{
"mcpServers": {
"finology": {
"command": "npx",
"args": ["-y", "@finology/mcp-server"]
}
}
}
The local package needs no API key and no account: it calls the public calculation endpoints.
What is and is not in this repository
Not here, deliberately: the RAP/OBBB formulas, income-driven payment math, forgiveness and tax-bomb projection, plan-eligibility rules, and NSLDS parsing. Those run on Finology's servers.
That is not only about protecting the engine. Federal repayment rules move every year — poverty guidelines, tax brackets, RAP/OBBB implementation guidance, court challenges. A formula copied into an npm package is wrong within months and cannot be corrected in the installs that already exist. Calling a maintained endpoint is the only shape of this tool that stays true.
Here: the input schemas, the HTTP call, the 2026-27 federal rate per loan type that is sent when no rate is given (an award-year input, not repayment math), and error handling that passes the API's own field-level messages through to the model instead of flattening them into "request failed."
Limits
These tools return figures. They do not produce client-facing deliverables, save borrower records, parse NSLDS files, or track PSLF qualifying payments over time. For those, and for a book of borrowers kept current as the rules change: finology.tech
The local package is rate-limited per IP. Not financial advice.
License
MIT
Finology Software MCP questions
How do I add Finology Software MCP to Claude Code?
Run claude mcp add verified-engine -- npx -y @finology/mcp-server in your terminal. Add --scope user to make it available in every project.
How do I add Finology Software MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Does this server provide actual repayment formulas?
No, the formulas and rules run on Finology's servers to ensure accuracy as federal regulations change.
Can I use this with Claude or GitHub Copilot?
Yes, it connects Claude, GitHub Copilot, Cursor, or any MCP client directly to the repayment engine.
What happens if I don't provide a loan interest rate?
The tool uses the 2026-27 federal rate for the specific loan type and notifies you in the response.
Is there a way to test the API for free?
Yes, developers can use an instant free sandbox key that allows for 25 calls per month.