@finology/mcp-server 0.4.7 → 0.4.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +24 -8
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -7,7 +7,7 @@
7
7
 
8
8
  **Language models guess at federal student loan rules. This doesn't.**
9
9
 
10
- `@finology/mcp-server` connects Claude, Cursor, or any MCP client directly to
10
+ `@finology/mcp-server` connects Claude, GitHub Copilot, Cursor, or any MCP client directly to
11
11
  [Finology Software](https://finology.tech)'s parity-verified federal repayment engine. Every
12
12
  number is computed server-side against current federal rules and returned with a
13
13
  `parityVerified` flag. No formulas are approximated, and none are hardcoded into this package.
@@ -24,14 +24,17 @@ wrong most confidently:
24
24
  $50 per *qualifying dependent* — and a spouse is not a dependent. Approximating it from older
25
25
  IDR formulas gives the wrong answer.
26
26
  - **A consolidation that repaid a PLUS loan is restricted to ICR.**
27
- - **PAYE and SAVE are closed to new enrollment.**
27
+ - **PAYE and ICR are still open, with conditions, until no later than July 1, 2028.** Following
28
+ Federal Student Aid, PAYE is open to a PAYE "new borrower" with no new loan or consolidation on
29
+ or after July 1, 2026, and ICR is open to eligible loan types. Loans made on or after July 1, 2026
30
+ can use only the tiered Standard plan or RAP. SAVE is closed to new enrollment.
28
31
 
29
32
  ## Tools
30
33
 
31
34
  ### `compare_federal_student_loan_repayment_plans`
32
35
 
33
- Compares a balance across every plan the borrower is actually eligible for — RAP, IBR, ICR, PAYE,
34
- SAVE, Graduated, Extended, tiered Standard — returning monthly payment, lifetime cost, projected
36
+ Compares a balance across every plan the borrower is actually eligible for — Standard, tiered
37
+ Standard, RAP, IBR, PAYE and ICR — returning monthly payment, lifetime cost, projected
35
38
  forgiveness and tax on forgiveness for each, **plus the plans that are excluded and the
36
39
  eligibility rule that excludes them.**
37
40
 
@@ -47,7 +50,7 @@ filing the household payment is split by each spouse's share of the combined bal
47
50
 
48
51
  **It answers half the question on purpose, and says so.** The engine models the loan side exactly and
49
52
  does not model the tax cost of filing separately — lost credits, worse brackets, community-property
50
- splits — which is often large enough to reverse the answer. Returning only the favourable half as if
53
+ splits — which is often large enough to reverse the answer. Returning only the favorable half as if
51
54
  it were the whole decision would be the same confident half-truth this server exists to replace.
52
55
 
53
56
  ### `estimate_rap_monthly_payment`
@@ -60,14 +63,14 @@ real answer.
60
63
 
61
64
  Every answer ends with the next rung, and `finology_service_info` returns it structured:
62
65
 
63
- - **Advisor:** Finology Software, US $99 per advisor per month or $89 per month billed annually, with a self-serve 7-day trial (card on file, nothing charged until it ends). 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.
66
+ - **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.
64
67
  - **Developer / operator:** an instant free sandbox key (`POST https://api.finology.tech/v1/keys/sandbox`,
65
68
  25 calls/month), then the keyed endpoints with `X-Api-Key`. The keyed rung is the answer-of-record
66
69
  surface: every answer is persisted with its rule version and an inputs hash before it is served.
67
70
  Production access is self-serve: Developer, US $49 a month for 2,000 calls, or Platform, US $499 a month
68
71
  for 100,000 calls. Docs: https://finology.tech/developers/
69
72
  - **Keyed remote MCP:** `https://mcp.finology.tech/mcp`. Sign in with a Finology Software login (OAuth),
70
- which is how Claude connects, or send the `X-Api-Key` header. Every answer is logged and carries a
73
+ which is how Claude, ChatGPT and Microsoft Copilot connect, or send the `X-Api-Key` header. Every answer is logged and carries a
71
74
  verify link.
72
75
 
73
76
  ## Install
@@ -75,7 +78,20 @@ Every answer ends with the next rung, and `finology_service_info` returns it str
75
78
  **Claude (web, desktop and mobile) — one click.** Finology Software is listed in the
76
79
  [Claude Connectors Directory](https://claude.ai/directory/finology-student-loans). Add the
77
80
  connector there and sign in with a free Finology Software login (no card): 5 questions in total,
78
- no daily limit. Subscribers are unlimited.
81
+ no daily limit. Subscribers are unlimited, and a subscriber's login also lists their own clients in
82
+ the same connector (`list_my_clients`, `run_projection_for_client`,
83
+ `get_balance_trajectory_for_client`).
84
+
85
+ **ChatGPT.** Finology Software is in the
86
+ [ChatGPT plugin directory](https://chatgpt.com/plugins/plugin_asdk_app_6abbf32753248191a0dbf90da0f2a5b6),
87
+ with the same free login.
88
+
89
+ **Microsoft Copilot.** GitHub Copilot (including its free plan) adds the remote server once:
90
+ `copilot mcp add --transport http finology https://mcp.finology.tech/free`, then signs in with a
91
+ Finology Software login the first time it calls a tool; GitHub Copilot in Visual Studio Code uses the
92
+ same address and sign-in. In Copilot Studio, add a Model Context Protocol tool with that URL and
93
+ OAuth 2.0 Dynamic discovery; running the agent uses your firm's Copilot credits. Setup:
94
+ https://finology.tech/finology-software-in-microsoft-copilot/
79
95
 
80
96
  Everything below is the manual route, for other MCP clients or for a local install.
81
97
 
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@finology/mcp-server",
3
3
  "mcpName": "tech.finology/student-loan",
4
- "version": "0.4.7",
4
+ "version": "0.4.8",
5
5
  "description": "Deterministic 2026 federal student loan math for AI agents. RAP, IBR, ICR, PSLF payments, plan eligibility, and the married-filing-jointly vs separately trade-off, from Finology Software's parity-verified engine, so assistants stop guessing at federal repayment rules.",
6
6
  "license": "MIT",
7
7
  "type": "module",