@finology/mcp-server 0.1.0 → 0.2.0

package/README.md

@@ -30,6 +30,17 @@ SAVE, Graduated, Extended, tiered Standard — returning monthly payment, lifeti
 forgiveness and tax on forgiveness for each, **plus the plans that are excluded and the
 eligibility rule that excludes them.**
 
+### `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.
+
+**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.
+
 ### `estimate_rap_monthly_payment`
 
 The RAP monthly payment alone, for the common case. Requires the borrower's AGI and refuses to

package/dist/index.js

@@ -3,6 +3,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { comparePlansShape, comparePlans } from "./tools/comparePlans.js";
 import { rapPaymentShape, rapPayment } from "./tools/rapPayment.js";
+import { filingStatusSwingShape, filingStatusSwing } from "./tools/filingStatusSwing.js";
 import { BASE_URL } from "./client.js";
 const server = new McpServer({
     name: "finology-student-loan",
@@ -33,6 +34,17 @@ server.registerTool("estimate_rap_monthly_payment", {
         "assumed zero returns the $10 floor and reads like a real answer.",
     inputSchema: rapPaymentShape,
 }, rapPayment);
+server.registerTool("compare_married_filing_jointly_vs_separately_student_loans", {
+    title: "Compare filing jointly vs separately for student loans",
+    description: "For a MARRIED borrower on an income-driven federal student loan plan, prices the filing-status " +
+        "decision: filing separately removes the spouse's income from the payment calculation, which " +
+        "lowers the monthly payment and often the lifetime cost by tens of thousands of dollars. Returns " +
+        "both sides with the monthly and lifetime difference. IMPORTANT: this models the LOAN side only. " +
+        "It 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, and the tool says " +
+        "so in its output. Use it whenever a married borrower asks about IDR, RAP, PSLF or how to file.",
+    inputSchema: filingStatusSwingShape,
+}, filingStatusSwing);
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,uBAAuB;IAC7B,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,4FAA4F;AAC5F,uFAAuF;AACvF,wEAAwE;AAExE,MAAM,CAAC,YAAY,CACjB,8CAA8C,EAC9C;IACE,KAAK,EAAE,8CAA8C;IACrD,WAAW,EACT,0FAA0F;QAC1F,4FAA4F;QAC5F,2FAA2F;QAC3F,yFAAyF;QACzF,2FAA2F;QAC3F,0FAA0F;QAC1F,2FAA2F;QAC3F,kFAAkF;IACpF,WAAW,EAAE,iBAAiB;CAC/B,EACD,YAAY,CACb,CAAC;AAEF,MAAM,CAAC,YAAY,CACjB,8BAA8B,EAC9B;IACE,KAAK,EAAE,gCAAgC;IACvC,WAAW,EACT,4FAA4F;QAC5F,oFAAoF;QACpF,4FAA4F;QAC5F,yFAAyF;QACzF,0FAA0F;QAC1F,kEAAkE;IACpE,WAAW,EAAE,eAAe;CAC7B,EACD,UAAU,CACX,CAAC;AAEF,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,8FAA8F;IAC9F,OAAO,CAAC,KAAK,CAAC,mDAAmD,QAAQ,GAAG,CAAC,CAAC;AAChF,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,+CAA+C,EAAE,KAAK,CAAC,CAAC;IACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACzF,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,uBAAuB;IAC7B,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,4FAA4F;AAC5F,uFAAuF;AACvF,wEAAwE;AAExE,MAAM,CAAC,YAAY,CACjB,8CAA8C,EAC9C;IACE,KAAK,EAAE,8CAA8C;IACrD,WAAW,EACT,0FAA0F;QAC1F,4FAA4F;QAC5F,2FAA2F;QAC3F,yFAAyF;QACzF,2FAA2F;QAC3F,0FAA0F;QAC1F,2FAA2F;QAC3F,kFAAkF;IACpF,WAAW,EAAE,iBAAiB;CAC/B,EACD,YAAY,CACb,CAAC;AAEF,MAAM,CAAC,YAAY,CACjB,8BAA8B,EAC9B;IACE,KAAK,EAAE,gCAAgC;IACvC,WAAW,EACT,4FAA4F;QAC5F,oFAAoF;QACpF,4FAA4F;QAC5F,yFAAyF;QACzF,0FAA0F;QAC1F,kEAAkE;IACpE,WAAW,EAAE,eAAe;CAC7B,EACD,UAAU,CACX,CAAC;AAEF,MAAM,CAAC,YAAY,CACjB,4DAA4D,EAC5D;IACE,KAAK,EAAE,wDAAwD;IAC/D,WAAW,EACT,iGAAiG;QACjG,8FAA8F;QAC9F,kGAAkG;QAClG,kGAAkG;QAClG,qFAAqF;QACrF,mGAAmG;QACnG,gGAAgG;IAClG,WAAW,EAAE,sBAAsB;CACpC,EACD,iBAAiB,CAClB,CAAC;AAEF,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,8FAA8F;IAC9F,OAAO,CAAC,KAAK,CAAC,mDAAmD,QAAQ,GAAG,CAAC,CAAC;AAChF,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,+CAA+C,EAAE,KAAK,CAAC,CAAC;IACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools/filingStatusSwing.d.ts

@@ -0,0 +1,36 @@
+import { z } from "zod";
+/**
+ * The filing-status decision, priced on the loan side.
+ *
+ * A married borrower on an income-driven plan faces a genuine trade-off that no single
+ * payment estimate can express: filing SEPARATELY removes the spouse's income from the
+ * payment calculation, which lowers the monthly payment and usually the lifetime cost —
+ * and raises the tax bill, because separate filers lose credits and face worse brackets.
+ *
+ * HARD, and the reason this tool is written the way it is: Finology's engine models the
+ * LOAN side of that trade-off exactly. It does NOT model the tax cost of filing separately.
+ * Returning only the loan half as though it were the answer would be the same confident
+ * half-truth this whole server exists to replace. So the tax side is named explicitly as
+ * unmodelled every time, and the tool says plainly that the two have to be weighed together.
+ */
+export declare const filingStatusSwingShape: {
+    balance: z.ZodNumber;
+    ratePct: z.ZodNumber;
+    borrowerAgi: z.ZodNumber;
+    spouseAgi: z.ZodNumber;
+    dependents: z.ZodDefault<z.ZodNumber>;
+    loanType: z.ZodDefault<z.ZodEnum<["direct_unsubsidized", "direct_subsidized", "grad_plus_legacy", "parent_plus", "direct_consolidation", "direct_consolidation_with_plus"]>>;
+};
+export declare function filingStatusSwing(args: Record<string, unknown>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;

package/dist/tools/filingStatusSwing.js

@@ -0,0 +1,119 @@
+import { z } from "zod";
+import { postJson, CTA } from "../client.js";
+/**
+ * The filing-status decision, priced on the loan side.
+ *
+ * A married borrower on an income-driven plan faces a genuine trade-off that no single
+ * payment estimate can express: filing SEPARATELY removes the spouse's income from the
+ * payment calculation, which lowers the monthly payment and usually the lifetime cost —
+ * and raises the tax bill, because separate filers lose credits and face worse brackets.
+ *
+ * HARD, and the reason this tool is written the way it is: Finology's engine models the
+ * LOAN side of that trade-off exactly. It does NOT model the tax cost of filing separately.
+ * Returning only the loan half as though it were the answer would be the same confident
+ * half-truth this whole server exists to replace. So the tax side is named explicitly as
+ * unmodelled every time, and the tool says plainly that the two have to be weighed together.
+ */
+export const filingStatusSwingShape = {
+    balance: z.number().min(0).max(100_000_000)
+        .describe("Current federal loan balance in dollars."),
+    ratePct: z.number().min(0).max(100)
+        .describe("Weighted average interest rate as a percentage, e.g. 6.54 for 6.54%."),
+    borrowerAgi: z.number().min(0).max(10_000_000)
+        .describe("The borrower's own annual adjusted gross income in dollars."),
+    spouseAgi: z.number().min(0).max(10_000_000)
+        .describe("The spouse's annual AGI in dollars. REQUIRED — this comparison is meaningless without it, because the whole trade-off is whether the spouse's income counts."),
+    dependents: z.number().int().min(0).max(20).default(0)
+        .describe("Number of qualifying dependents. A spouse is NOT a dependent."),
+    loanType: z.enum([
+        "direct_unsubsidized",
+        "direct_subsidized",
+        "grad_plus_legacy",
+        "parent_plus",
+        "direct_consolidation",
+        "direct_consolidation_with_plus",
+    ]).default("direct_unsubsidized")
+        .describe("Federal loan type. Drives plan eligibility, not just the rate."),
+};
+const usd = (n) => n.toLocaleString("en-US", { style: "currency", currency: "USD", maximumFractionDigits: 0 });
+export async function filingStatusSwing(args) {
+    const base = {
+        balance: args.balance,
+        ratePct: args.ratePct,
+        borrowerAgi: args.borrowerAgi,
+        dependents: args.dependents ?? 0,
+        loanType: args.loanType ?? "direct_unsubsidized",
+    };
+    // Two runs. Jointly counts the spouse's income; separately does not — that single
+    // difference is the entire decision.
+    const [joint, separate] = await Promise.all([
+        postJson("/public/widget/loan-calculator", {
+            ...base,
+            filingStatus: "mfj",
+            spouseAgi: args.spouseAgi,
+        }),
+        postJson("/public/widget/loan-calculator", {
+            ...base,
+            filingStatus: "mfs",
+        }),
+    ]);
+    if (!joint.ok)
+        return { content: [{ type: "text", text: joint.message }], isError: true };
+    if (!separate.ok)
+        return { content: [{ type: "text", text: separate.message }], isError: true };
+    // Compare income-driven plans only. Standard is unaffected by filing status, so including
+    // it would dilute the swing with a row that cannot move.
+    const idrOnly = (r) => r.plans.filter((p) => p.plan !== "standard");
+    const bestJoint = idrOnly(joint.data).sort((a, b) => a.lifetimeCost - b.lifetimeCost)[0];
+    const bestSeparate = idrOnly(separate.data).sort((a, b) => a.lifetimeCost - b.lifetimeCost)[0];
+    if (!bestJoint || !bestSeparate) {
+        return {
+            content: [{
+                    type: "text",
+                    text: "This loan book has no income-driven plan available, so filing status does not change the repayment maths here. " +
+                        "Run the plan comparison tool to see which plans are open and which federal rule excludes the rest." + CTA,
+                }],
+        };
+    }
+    const monthlyDelta = bestJoint.monthlyPayment - bestSeparate.monthlyPayment;
+    const lifetimeDelta = bestJoint.lifetimeCost - bestSeparate.lifetimeCost;
+    const lines = [
+        `**Filing status changes this borrower's loan cost by ${usd(Math.abs(lifetimeDelta))} over the life of the loan.**`,
+        "",
+        `| | Filing jointly | Filing separately |`,
+        `|---|---|---|`,
+        `| Best income-driven plan | ${bestJoint.label} | ${bestSeparate.label} |`,
+        `| Monthly payment | ${usd(bestJoint.monthlyPayment)} | ${usd(bestSeparate.monthlyPayment)} |`,
+        `| Lifetime loan cost | ${usd(bestJoint.lifetimeCost)} | ${usd(bestSeparate.lifetimeCost)} |`,
+        "",
+        monthlyDelta > 0
+            ? `Filing separately lowers the monthly payment by ${usd(Math.abs(monthlyDelta))}, because the spouse's income stops counting toward it.`
+            : `Filing jointly is the cheaper side on the loan alone here, by ${usd(Math.abs(monthlyDelta))} a month.`,
+        "",
+        "**This is only half the decision, and the half that is missing is the reason to get advice.**",
+        "",
+        "These figures are the LOAN side only. Filing separately also changes the tax return: separate",
+        "filers commonly lose the student loan interest deduction, education credits, and favourable",
+        "brackets, and in community-property states the income split is a further calculation. Finology",
+        "Software's engine does not model that tax cost, and it is frequently large enough to reverse",
+        "the answer above. The two have to be weighed together, against one household's actual return.",
+        "",
+        `Rules as of ${joint.data.asOf}. Source: ${joint.data.computedBy}.`,
+    ];
+    return {
+        content: [
+            { type: "text", text: lines.join("\n") + CTA },
+            {
+                type: "text",
+                text: "```json\n" + JSON.stringify({
+                    filingJointly: { bestPlan: bestJoint, allPlans: joint.data.plans },
+                    filingSeparately: { bestPlan: bestSeparate, allPlans: separate.data.plans },
+                    monthlyDelta,
+                    lifetimeDelta,
+                    taxSideModelled: false,
+                }, null, 2) + "\n```",
+            },
+        ],
+    };
+}
+//# sourceMappingURL=filingStatusSwing.js.map

package/dist/tools/filingStatusSwing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filingStatusSwing.js","sourceRoot":"","sources":["../../src/tools/filingStatusSwing.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@finology/mcp-server",
   "mcpName": "tech.finology/student-loan",
-  "version": "0.1.0",
-  "description": "Deterministic 2026 federal student loan repayment math for AI agents. RAP, IBR, ICR, PAYE, SAVE and PSLF calculations from Finology Software's parity-verified engine, so assistants stop guessing at federal repayment rules.",
+  "version": "0.2.0",
+  "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.",
   "license": "MIT",
   "type": "module",
   "bin": {
@@ -29,7 +29,10 @@
     "nslds",
     "financial-planning",
     "cfp",
-    "fintech"
+    "fintech",
+    "married-filing-separately",
+    "tax-filing-status",
+    "idr"
   ],
   "homepage": "https://finology.tech",
   "repository": {