@markcolabs/mcp 0.1.0 → 0.3.0

package/dist/tools/ira.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ira.d.ts","sourceRoot":"","sources":["../../src/tools/ira.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAGL,KAAK,0BAA0B,EAChC,MAAM,mBAAmB,CAAC;AAO3B,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,SAAS,EACf,MAAM,gBAAgB,CAAC;AAExB,yCAAyC;AACzC,eAAO,MAAM,SAAS,wCAAwC,CAAC;AAQ/D;;;;GAIG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;EA0B1C,CAAC;AAEH,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CACjD,OAAO,+BAA+B,CACvC,CAAC;AAEF,+CAA+C;AAC/C,eAAO,MAAM,gBAAgB,QAQU,CAAC;AAExC;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CACrB,QAAQ,EAAE,OAAO,GAEf;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC,0BAA0B,CAAC,CAAA;CAAE,GAC3D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAyDlC"}

package/dist/tools/ira.js

@@ -0,0 +1,117 @@
+/**
+ * MCP tool wrapper for `dc.calculator.ira.contributionLimit`.
+ *
+ * Per ADR-0039 § 1: tool name locked.
+ * Per ADR-0039 § 2: Zod input with bounds from shared/bounds.ts; enums for
+ *                   filing-status + IRA type; MAGI as USD.
+ * Per ADR-0039 § 3: returns ToolResult<IraContributionLimitResult>.
+ * Per ADR-0039 § 4: errors funnel through ToolError.
+ */
+import { z } from "zod";
+import { contributionLimit, ENGINE_VERSION, } from "../engines/ira.js";
+import { IRA_BOUNDS, IRA_FILING_STATUS, IRA_TYPES, } from "../shared/bounds.js";
+import { YMYL_DISCLAIMER } from "../disclaimers/ymyl.js";
+import { makeResult, makeError, } from "../envelope.js";
+/** Locked tool name per ADR-0039 § 1. */
+export const TOOL_NAME = "dc.calculator.ira.contributionLimit";
+/** Methodology pointer — ADR-0039 § 3. */
+const METHODOLOGY = {
+    url: "https://www.digitalcalculator.info/ira-calculator/",
+    version: "2026-05-27",
+};
+/**
+ * Zod input schema. Bounds come from shared/bounds.ts so engine and schema
+ * cannot drift. Filing status + IRA type are enums (z.enum is more strict
+ * than a free string).
+ */
+export const IraContributionLimitInputSchema = z.object({
+    age: z
+        .number()
+        .int()
+        .min(IRA_BOUNDS.MIN_AGE)
+        .max(IRA_BOUNDS.MAX_AGE)
+        .describe("Current age. Age >= 50 enables the IRA catch-up contribution ($1,100 for 2026)."),
+    filingStatus: z
+        .enum(IRA_FILING_STATUS)
+        .describe("Federal filing status: single | marriedFilingJointly | marriedFilingSeparately | headOfHousehold."),
+    magi: z
+        .number()
+        .min(IRA_BOUNDS.MIN_MAGI)
+        .max(IRA_BOUNDS.MAX_MAGI)
+        .describe("Modified Adjusted Gross Income (MAGI), USD. Drives Roth contribution phase-out and the Traditional IRA deduction-phase-out signal."),
+    type: z
+        .enum(IRA_TYPES)
+        .describe("IRA type: 'traditional' (contribution limit is not MAGI-gated; deduction phase-out reported separately) or 'roth' (contribution itself is MAGI-phased)."),
+});
+/** Tool description used in mcp.tools/list. */
+export const TOOL_DESCRIPTION = "Compute the user's eligible IRA contribution for 2026 given age, filing " +
+    "status, MAGI, and IRA type. Applies the IRS catch-up amount for age >= 50 " +
+    "and the Roth IRA MAGI phase-out per IRC §408A(c)(3). For Traditional, " +
+    "always returns the full contribution limit (Traditional contributions are " +
+    "not MAGI-gated — only the deductibility is, surfaced as " +
+    "`traditionalDeductionStatus`). Returns { eligibleContribution, " +
+    "traditionalCap, rothCap, catchUp, phaseOutReduction, catchUpEligible, " +
+    "traditionalDeductionStatus, meta }.";
+/**
+ * Execute the tool. Validation + engine call wrapped in the standard envelope.
+ *
+ * Tagged-union return:
+ *   { ok: true, value: ToolResult<...> }
+ *   { ok: false, error: ToolError }
+ *
+ * The MCP SDK adapter at src/index.ts maps `ok=false` to `isError: true`.
+ */
+export function execute(rawInput) {
+    const parsed = IraContributionLimitInputSchema.safeParse(rawInput);
+    if (!parsed.success) {
+        const first = parsed.error.issues[0];
+        return {
+            ok: false,
+            error: makeError({
+                code: "INPUT_VALIDATION",
+                message: first?.message ?? "Invalid input.",
+                field: first?.path.join(".") || undefined,
+                retriable: false,
+            }),
+        };
+    }
+    const input = parsed.data;
+    let payload;
+    try {
+        payload = contributionLimit(input);
+    }
+    catch (err) {
+        return {
+            ok: false,
+            error: makeError({
+                code: "INTERNAL",
+                message: "Engine error computing IRA contribution limit.",
+                retriable: false,
+            }),
+        };
+    }
+    if (!Number.isFinite(payload.eligibleContribution) ||
+        !Number.isFinite(payload.traditionalCap) ||
+        !Number.isFinite(payload.rothCap) ||
+        !Number.isFinite(payload.catchUp) ||
+        !Number.isFinite(payload.phaseOutReduction)) {
+        return {
+            ok: false,
+            error: makeError({
+                code: "INTERNAL",
+                message: "IRA contribution-limit engine produced a non-finite result.",
+                retriable: false,
+            }),
+        };
+    }
+    return {
+        ok: true,
+        value: makeResult({
+            result: payload,
+            methodology: METHODOLOGY,
+            engineVersion: ENGINE_VERSION,
+            disclaimer: YMYL_DISCLAIMER,
+        }),
+    };
+}
+//# sourceMappingURL=ira.js.map

package/dist/tools/ira.js.map

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

package/dist/tools/paycheck.d.ts

@@ -6,11 +6,18 @@
  * Per ADR-0039 § 3: returns ToolResult<PaycheckNetPayResult>.
  * Per ADR-0039 § 4: failures funnel through ToolError; tools never throw.
  *
- * YMYL note: state withholding varies by state (some have no income tax, some
- * have flat rates, some have brackets, some have local taxes). The v0.2.0
- * engine returns $0 for the 9 no-income-tax states and a flat 5% estimate
- * for all other states. Callers needing precise per-state withholding should
- * be directed to the full site calculator at the methodology link.
+ * v0.3.0 (S141 Item #5):
+ *   - MCP-AUDIT-011 fix: state-aware tax via Tax Foundation 2026 effective
+ *     rates (was flat 5%).
+ *   - MCP-AUDIT-012 fix: Additional Medicare 0.9% uses FICA wages base
+ *     (gross − pre-tax cafeteria-plan deductions), not raw gross.
+ *
+ * YMYL note: state withholding varies by state. v0.3.0 returns $0 for the 9
+ * no-income-tax states and an effective-rate lookup (4 income tiers, Tax
+ * Foundation source) for all other states + DC. Per-state full-bracket
+ * simulation, SDI, and local-tax piggybacks (NYC, PA municipal EIT, etc.)
+ * are NOT modeled; callers needing precision should use the full site
+ * calculator at the methodology link.
  */
 import { z } from "zod";
 import { type PaycheckNetPayResult } from "../engines/paycheck.js";
@@ -22,7 +29,7 @@ export declare const PaycheckNetPayInputSchema: z.ZodObject<{
     payFrequency: z.ZodEnum<["quarterly" | "monthly" | "weekly" | "biweekly" | "semimonthly" | "annual", ...("quarterly" | "monthly" | "weekly" | "biweekly" | "semimonthly" | "annual")[]]>;
     federalFilingStatus: z.ZodEnum<["single" | "married" | "marriedSeparate" | "headOfHousehold", ...("single" | "married" | "marriedSeparate" | "headOfHousehold")[]]>;
     state: z.ZodString;
-    dependents: z.ZodNumber;
+    dependents: z.ZodDefault<z.ZodNumber>;
     preTaxDeductionsAnnual: z.ZodNumber;
     postTaxDeductionsAnnual: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
@@ -40,7 +47,7 @@ export declare const PaycheckNetPayInputSchema: z.ZodObject<{
     state: string;
     preTaxDeductionsAnnual: number;
     postTaxDeductionsAnnual: number;
-    dependents: number;
+    dependents?: number | undefined;
 }>;
 export type PaycheckNetPayToolInput = z.infer<typeof PaycheckNetPayInputSchema>;
 export declare const TOOL_DESCRIPTION: string;

package/dist/tools/paycheck.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paycheck.d.ts","sourceRoot":"","sources":["../../src/tools/paycheck.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,wBAAwB,CAAC;AAOhC,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,SAAS,EACf,MAAM,gBAAgB,CAAC;AAExB,yCAAyC;AACzC,eAAO,MAAM,SAAS,kCAAkC,CAAC;AAoBzD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;EA4CpC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAEhF,eAAO,MAAM,gBAAgB,QAOqB,CAAC;AAEnD,wBAAgB,OAAO,CACrB,QAAQ,EAAE,OAAO,GAEf;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC,oBAAoB,CAAC,CAAA;CAAE,GACrD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAuDlC"}
+{"version":3,"file":"paycheck.d.ts","sourceRoot":"","sources":["../../src/tools/paycheck.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,wBAAwB,CAAC;AAOhC,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,SAAS,EACf,MAAM,gBAAgB,CAAC;AAExB,yCAAyC;AACzC,eAAO,MAAM,SAAS,kCAAkC,CAAC;AAoBzD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;EAgDpC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAEhF,eAAO,MAAM,gBAAgB,QAS2C,CAAC;AAEzE,wBAAgB,OAAO,CACrB,QAAQ,EAAE,OAAO,GAEf;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC,oBAAoB,CAAC,CAAA;CAAE,GACrD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAuDlC"}

package/dist/tools/paycheck.js

@@ -6,11 +6,18 @@
  * Per ADR-0039 § 3: returns ToolResult<PaycheckNetPayResult>.
  * Per ADR-0039 § 4: failures funnel through ToolError; tools never throw.
  *
- * YMYL note: state withholding varies by state (some have no income tax, some
- * have flat rates, some have brackets, some have local taxes). The v0.2.0
- * engine returns $0 for the 9 no-income-tax states and a flat 5% estimate
- * for all other states. Callers needing precise per-state withholding should
- * be directed to the full site calculator at the methodology link.
+ * v0.3.0 (S141 Item #5):
+ *   - MCP-AUDIT-011 fix: state-aware tax via Tax Foundation 2026 effective
+ *     rates (was flat 5%).
+ *   - MCP-AUDIT-012 fix: Additional Medicare 0.9% uses FICA wages base
+ *     (gross − pre-tax cafeteria-plan deductions), not raw gross.
+ *
+ * YMYL note: state withholding varies by state. v0.3.0 returns $0 for the 9
+ * no-income-tax states and an effective-rate lookup (4 income tiers, Tax
+ * Foundation source) for all other states + DC. Per-state full-bracket
+ * simulation, SDI, and local-tax piggybacks (NYC, PA municipal EIT, etc.)
+ * are NOT modeled; callers needing precision should use the full site
+ * calculator at the methodology link.
  */
 import { z } from "zod";
 import { netPay, ENGINE_VERSION, } from "../engines/paycheck.js";
@@ -49,7 +56,11 @@ export const PaycheckNetPayInputSchema = z.object({
         .int()
         .min(PAYCHECK_BOUNDS.MIN_DEPENDENTS)
         .max(PAYCHECK_BOUNDS.MAX_DEPENDENTS)
-        .describe("Number of dependents (Form W-4 line 3). Reserved for future engine versions; currently no effect."),
+        .default(0)
+        .describe("Number of dependents (Form W-4 line 3). Optional with default 0 as of v0.2.1. " +
+        "Currently has NO effect on the calculation — reserved for a future engine " +
+        "version that will wire Form W-4 line 3 dependent credits into the federal " +
+        "withholding math. See MCP-AUDIT-014 for the full-removal vs. wire-it-up decision."),
     preTaxDeductionsAnnual: z
         .number()
         .min(PAYCHECK_BOUNDS.MIN_PRETAX_DEDUCTIONS)
@@ -63,11 +74,13 @@ export const PaycheckNetPayInputSchema = z.object({
 });
 export const TOOL_DESCRIPTION = "Estimate net (take-home) pay per paycheck using the IRS 2026 federal " +
     "Percentage Method, FICA (Social Security 6.2% + Medicare 1.45% + Additional " +
-    "Medicare 0.9% above thresholds), and a simplified state-tax estimate ($0 " +
-    "for no-income-tax states; flat 5% otherwise). Returns gross/federal/FICA/" +
-    "state per-paycheck amounts plus the annualized totals. State-specific " +
-    "withholding tables, SDI, and local taxes are NOT modeled — see the " +
-    "methodology link for the full site calculator.";
+    "Medicare 0.9% above thresholds on FICA wages), and a state-aware tax " +
+    "estimate ($0 for the 9 no-income-tax states; Tax Foundation 2026 effective " +
+    "rates by income tier for all other states + DC). Returns gross/federal/FICA/" +
+    "state per-paycheck amounts plus annualized totals, plus the state-tax source " +
+    "citation, effective rate applied, and any state-specific caveats. Full " +
+    "per-state brackets, SDI, and local-tax piggybacks (NYC, PA EIT, etc.) are " +
+    "NOT modeled — see the methodology link for the full site calculator.";
 export function execute(rawInput) {
     const parsed = PaycheckNetPayInputSchema.safeParse(rawInput);
     if (!parsed.success) {

package/dist/tools/paycheck.js.map

@@ -1 +1 @@
-{"version":3,"file":"paycheck.js","sourceRoot":"","sources":["../../src/tools/paycheck.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"paycheck.js","sourceRoot":"","sources":["../../src/tools/paycheck.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,MAAM,EACN,cAAc,GAEf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EACL,UAAU,EACV,SAAS,GAGV,MAAM,gBAAgB,CAAC;AAExB,yCAAyC;AACzC,MAAM,CAAC,MAAM,SAAS,GAAG,+BAA+B,CAAC;AAEzD,MAAM,WAAW,GAAG;IAClB,GAAG,EAAE,qEAAqE;IAC1E,OAAO,EAAE,YAAY;CACtB,CAAC;AAEF,MAAM,oBAAoB,GAAG,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAG9D,CAAC;AAEF,MAAM,oBAAoB,GAGtB;IACF,qBAAqB,CAAC,CAAC,CAAC;IACxB,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC;CAClC,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,iBAAiB,EAAE,CAAC;SACjB,MAAM,EAAE;SACR,GAAG,CAAC,eAAe,CAAC,uBAAuB,CAAC;SAC5C,GAAG,CAAC,eAAe,CAAC,uBAAuB,CAAC;SAC5C,QAAQ,CAAC,6BAA6B,CAAC;IAC1C,YAAY,EAAE,CAAC;SACZ,IAAI,CAAC,oBAAoB,CAAC;SAC1B,QAAQ,CACP,gFAAgF,CACjF;IACH,mBAAmB,EAAE,CAAC;SACnB,IAAI,CAAC,oBAAoB,CAAC;SAC1B,QAAQ,CACP,8EAA8E,CAC/E;IACH,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,MAAM,CAAC,CAAC,CAAC;SACT,QAAQ,CACP,6EAA6E,CAC9E;IACH,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,eAAe,CAAC,cAAc,CAAC;SACnC,GAAG,CAAC,eAAe,CAAC,cAAc,CAAC;SACnC,OAAO,CAAC,CAAC,CAAC;SACV,QAAQ,CACP,gFAAgF;QAC9E,4EAA4E;QAC5E,4EAA4E;QAC5E,mFAAmF,CACtF;IACH,sBAAsB,EAAE,CAAC;SACtB,MAAM,EAAE;SACR,GAAG,CAAC,eAAe,CAAC,qBAAqB,CAAC;SAC1C,GAAG,CAAC,eAAe,CAAC,qBAAqB,CAAC;SAC1C,QAAQ,CACP,kEAAkE,CACnE;IACH,uBAAuB,EAAE,CAAC;SACvB,MAAM,EAAE;SACR,GAAG,CAAC,eAAe,CAAC,sBAAsB,CAAC;SAC3C,GAAG,CAAC,eAAe,CAAC,sBAAsB,CAAC;SAC3C,QAAQ,CACP,qFAAqF,CACtF;CACJ,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,gBAAgB,GAC3B,uEAAuE;IACvE,8EAA8E;IAC9E,uEAAuE;IACvE,6EAA6E;IAC7E,8EAA8E;IAC9E,+EAA+E;IAC/E,yEAAyE;IACzE,4EAA4E;IAC5E,sEAAsE,CAAC;AAEzE,MAAM,UAAU,OAAO,CACrB,QAAiB;IAIjB,MAAM,MAAM,GAAG,yBAAyB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC7D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACrC,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,SAAS,CAAC;gBACf,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EAAE,KAAK,EAAE,OAAO,IAAI,gBAAgB;gBAC3C,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,SAAS;gBACzC,SAAS,EAAE,KAAK;aACjB,CAAC;SACH,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC;IAE1B,IAAI,OAA6B,CAAC;IAClC,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,SAAS,CAAC;gBACf,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,0CAA0C;gBACnD,SAAS,EAAE,KAAK;aACjB,CAAC;SACH,CAAC;IACJ,CAAC;IAED,IACE,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC;QAChC,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC;QACpC,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EACjC,CAAC;QACD,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,SAAS,CAAC;gBACf,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,+CAA+C;gBACxD,SAAS,EAAE,KAAK;aACjB,CAAC;SACH,CAAC;IACJ,CAAC;IAED,OAAO;QACL,EAAE,EAAE,IAAI;QACR,KAAK,EAAE,UAAU,CAAC;YAChB,MAAM,EAAE,OAAO;YACf,WAAW,EAAE,WAAW;YACxB,aAAa,EAAE,cAAc;YAC7B,UAAU,EAAE,eAAe;SAC5B,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/tools/retirement401k.d.ts

@@ -1,5 +1,5 @@
 /**
- * MCP tool wrapper for `dc.calculator.401k.projection`.
+ * MCP tool wrapper for `dc.calculator.retirement401k.projection`.
  *
  * Per ADR-0039 § 1: tool name is locked.
  * Per ADR-0039 § 2: Zod input schema with bounds from shared/bounds.ts.
@@ -9,8 +9,8 @@
 import { z } from "zod";
 import { type Retirement401kProjectionResult } from "../engines/retirement401k.js";
 import { type ToolResult, type ToolError } from "../envelope.js";
-/** Locked tool name per ADR-0039 § 1. */
-export declare const TOOL_NAME = "dc.calculator.401k.projection";
+/** Locked tool name per ADR-0039 § 1 (corrected v0.2.0 per ADR-0041 D2). */
+export declare const TOOL_NAME = "dc.calculator.retirement401k.projection";
 /**
  * Zod input schema. Bounds come from shared/bounds.ts so engine + schema cannot drift.
  */

package/dist/tools/retirement401k.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retirement401k.d.ts","sourceRoot":"","sources":["../../src/tools/retirement401k.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAGL,KAAK,8BAA8B,EACpC,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,SAAS,EACf,MAAM,gBAAgB,CAAC;AAExB,yCAAyC;AACzC,eAAO,MAAM,SAAS,kCAAkC,CAAC;AAOzD;;GAEG;AACH,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmE5C,CAAC;AAEL,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CACrD,OAAO,mCAAmC,CAC3C,CAAC;AAEF,eAAO,MAAM,gBAAgB,QAKI,CAAC;AAElC;;GAEG;AACH,wBAAgB,OAAO,CACrB,QAAQ,EAAE,OAAO,GAEf;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC,8BAA8B,CAAC,CAAA;CAAE,GAC/D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAwDlC"}
+{"version":3,"file":"retirement401k.d.ts","sourceRoot":"","sources":["../../src/tools/retirement401k.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAGL,KAAK,8BAA8B,EACpC,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,SAAS,EACf,MAAM,gBAAgB,CAAC;AAExB,4EAA4E;AAC5E,eAAO,MAAM,SAAS,4CAA4C,CAAC;AAOnE;;GAEG;AACH,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmE5C,CAAC;AAEL,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CACrD,OAAO,mCAAmC,CAC3C,CAAC;AAEF,eAAO,MAAM,gBAAgB,QAKI,CAAC;AAElC;;GAEG;AACH,wBAAgB,OAAO,CACrB,QAAQ,EAAE,OAAO,GAEf;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC,8BAA8B,CAAC,CAAA;CAAE,GAC/D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAwDlC"}

package/dist/tools/retirement401k.js

@@ -1,5 +1,5 @@
 /**
- * MCP tool wrapper for `dc.calculator.401k.projection`.
+ * MCP tool wrapper for `dc.calculator.retirement401k.projection`.
  *
  * Per ADR-0039 § 1: tool name is locked.
  * Per ADR-0039 § 2: Zod input schema with bounds from shared/bounds.ts.
@@ -11,8 +11,8 @@ import { projection, ENGINE_VERSION, } from "../engines/retirement401k.js";
 import { RETIREMENT_401K_BOUNDS } from "../shared/bounds.js";
 import { YMYL_DISCLAIMER } from "../disclaimers/ymyl.js";
 import { makeResult, makeError, } from "../envelope.js";
-/** Locked tool name per ADR-0039 § 1. */
-export const TOOL_NAME = "dc.calculator.401k.projection";
+/** Locked tool name per ADR-0039 § 1 (corrected v0.2.0 per ADR-0041 D2). */
+export const TOOL_NAME = "dc.calculator.retirement401k.projection";
 const METHODOLOGY = {
     url: "https://www.digitalcalculator.info/401k-retirement-calculator/methodology/",
     version: "2026-05-09",

package/dist/tools/retirement401k.js.map

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

package/dist/tools/rmd.d.ts

@@ -0,0 +1,60 @@
+/**
+ * MCP tool wrapper for `dc.calculator.rmd.distributionAmount`.
+ *
+ * Per ADR-0039 § 1: tool name locked.
+ * Per ADR-0039 § 2: Zod input with bounds from shared/bounds.ts; balance as USD.
+ * Per ADR-0039 § 3: returns ToolResult<RmdDistributionAmountResult>.
+ * Per ADR-0039 § 4: errors funnel through ToolError.
+ *
+ * Scope per S141 Wave 1B: single-year RMD distribution-amount only. Uniform
+ * Lifetime Table (IRS Pub. 590-B Table III) is the only table applied for v1
+ * to maintain parity with the site source. Joint Life Expectancy Table
+ * (Table II) is reserved for a future minor when the site engine adds it.
+ */
+import { z } from "zod";
+import { type RmdDistributionAmountResult } from "../engines/rmd.js";
+import { type ToolResult, type ToolError } from "../envelope.js";
+/** Locked tool name per ADR-0039 § 1. */
+export declare const TOOL_NAME = "dc.calculator.rmd.distributionAmount";
+/**
+ * Zod input schema. Bounds come from shared/bounds.ts so engine and schema
+ * cannot drift. `spouseAge` and `isSpouseSoleBeneficiary` are accepted but
+ * ignored in v1 (reserved for future Joint Life Expectancy Table support
+ * once the site engine adds Table II).
+ */
+export declare const RmdDistributionAmountInputSchema: z.ZodObject<{
+    accountBalance: z.ZodNumber;
+    ownerAge: z.ZodNumber;
+    spouseAge: z.ZodOptional<z.ZodNumber>;
+    isSpouseSoleBeneficiary: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    accountBalance: number;
+    ownerAge: number;
+    spouseAge?: number | undefined;
+    isSpouseSoleBeneficiary?: boolean | undefined;
+}, {
+    accountBalance: number;
+    ownerAge: number;
+    spouseAge?: number | undefined;
+    isSpouseSoleBeneficiary?: boolean | undefined;
+}>;
+export type RmdDistributionAmountToolInput = z.infer<typeof RmdDistributionAmountInputSchema>;
+/** Tool description used in mcp.tools/list. */
+export declare const TOOL_DESCRIPTION: string;
+/**
+ * Execute the tool. Validation + engine call wrapped in the standard envelope.
+ *
+ * Tagged-union return:
+ *   { ok: true, value: ToolResult<...> }
+ *   { ok: false, error: ToolError }
+ *
+ * The MCP SDK adapter at src/index.ts maps `ok=false` to `isError: true`.
+ */
+export declare function execute(rawInput: unknown): {
+    ok: true;
+    value: ToolResult<RmdDistributionAmountResult>;
+} | {
+    ok: false;
+    error: ToolError;
+};
+//# sourceMappingURL=rmd.d.ts.map

package/dist/tools/rmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rmd.d.ts","sourceRoot":"","sources":["../../src/tools/rmd.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAGL,KAAK,2BAA2B,EACjC,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,SAAS,EACf,MAAM,gBAAgB,CAAC;AAExB,yCAAyC;AACzC,eAAO,MAAM,SAAS,yCAAyC,CAAC;AAQhE;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;EA+B3C,CAAC;AAEH,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAClD,OAAO,gCAAgC,CACxC,CAAC;AAEF,+CAA+C;AAC/C,eAAO,MAAM,gBAAgB,QAYD,CAAC;AAE7B;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CACrB,QAAQ,EAAE,OAAO,GAEf;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC,2BAA2B,CAAC,CAAA;CAAE,GAC5D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAwDlC"}

package/dist/tools/rmd.js

@@ -0,0 +1,130 @@
+/**
+ * MCP tool wrapper for `dc.calculator.rmd.distributionAmount`.
+ *
+ * Per ADR-0039 § 1: tool name locked.
+ * Per ADR-0039 § 2: Zod input with bounds from shared/bounds.ts; balance as USD.
+ * Per ADR-0039 § 3: returns ToolResult<RmdDistributionAmountResult>.
+ * Per ADR-0039 § 4: errors funnel through ToolError.
+ *
+ * Scope per S141 Wave 1B: single-year RMD distribution-amount only. Uniform
+ * Lifetime Table (IRS Pub. 590-B Table III) is the only table applied for v1
+ * to maintain parity with the site source. Joint Life Expectancy Table
+ * (Table II) is reserved for a future minor when the site engine adds it.
+ */
+import { z } from "zod";
+import { distributionAmount, ENGINE_VERSION, } from "../engines/rmd.js";
+import { RMD_BOUNDS } from "../shared/bounds.js";
+import { YMYL_DISCLAIMER } from "../disclaimers/ymyl.js";
+import { makeResult, makeError, } from "../envelope.js";
+/** Locked tool name per ADR-0039 § 1. */
+export const TOOL_NAME = "dc.calculator.rmd.distributionAmount";
+/** Methodology pointer — ADR-0039 § 3. */
+const METHODOLOGY = {
+    url: "https://www.digitalcalculator.info/rmd-calculator/",
+    version: "2026-05-27",
+};
+/**
+ * Zod input schema. Bounds come from shared/bounds.ts so engine and schema
+ * cannot drift. `spouseAge` and `isSpouseSoleBeneficiary` are accepted but
+ * ignored in v1 (reserved for future Joint Life Expectancy Table support
+ * once the site engine adds Table II).
+ */
+export const RmdDistributionAmountInputSchema = z.object({
+    accountBalance: z
+        .number()
+        .min(RMD_BOUNDS.MIN_BALANCE)
+        .max(RMD_BOUNDS.MAX_BALANCE)
+        .describe("Prior year-end IRA / 401(k) / 403(b) / 457(b) balance, USD."),
+    ownerAge: z
+        .number()
+        .int()
+        .min(RMD_BOUNDS.MIN_OWNER_AGE)
+        .max(RMD_BOUNDS.MAX_OWNER_AGE)
+        .describe("Owner's age this calendar year. Must be >= 73 (SECURE 2.0 RMD age for the 1951-1959 birth-year cohort). Lower ages are pre-RMD; callers seeking projections for younger owners should use the calculator directly."),
+    spouseAge: z
+        .number()
+        .int()
+        .min(0)
+        .max(120)
+        .optional()
+        .describe("Optional spouse age. RESERVED for future Joint Life Expectancy Table support — v1 IGNORES this input and always applies the Uniform Lifetime Table (matches site parity)."),
+    isSpouseSoleBeneficiary: z
+        .boolean()
+        .optional()
+        .describe("Optional flag indicating spouse is the sole IRA beneficiary. RESERVED for future Joint Life Expectancy Table support — v1 IGNORES this input."),
+});
+/** Tool description used in mcp.tools/list. */
+export const TOOL_DESCRIPTION = "Compute the required minimum distribution (RMD) for 2026 from a Traditional " +
+    "IRA / 401(k) / 403(b) / 457(b) account given the prior year-end balance and " +
+    "the owner's age. Applies the IRS Uniform Lifetime Table (Pub. 590-B Table III, " +
+    "post-2022 version) and reports the SECURE 2.0 §302 missed-RMD excise tax (25% " +
+    "default; reduced to 10% if corrected within the IRS correction window). " +
+    "SCOPE: single-year calculation only — multi-year projections are out of " +
+    "scope (use the calculator at /rmd-calculator/). The Joint Life Expectancy " +
+    "Table (Pub. 590-B Table II, applied when spouse is sole beneficiary and " +
+    "10+ years younger) is NOT implemented in v1; `spouseAge` and " +
+    "`isSpouseSoleBeneficiary` are accepted but ignored. Returns " +
+    "{ rmdAmount, distributionPeriod, lifeExpectancyFactor, tableUsed, " +
+    "penaltyIfMissed, meta }.";
+/**
+ * Execute the tool. Validation + engine call wrapped in the standard envelope.
+ *
+ * Tagged-union return:
+ *   { ok: true, value: ToolResult<...> }
+ *   { ok: false, error: ToolError }
+ *
+ * The MCP SDK adapter at src/index.ts maps `ok=false` to `isError: true`.
+ */
+export function execute(rawInput) {
+    const parsed = RmdDistributionAmountInputSchema.safeParse(rawInput);
+    if (!parsed.success) {
+        const first = parsed.error.issues[0];
+        return {
+            ok: false,
+            error: makeError({
+                code: "INPUT_VALIDATION",
+                message: first?.message ?? "Invalid input.",
+                field: first?.path.join(".") || undefined,
+                retriable: false,
+            }),
+        };
+    }
+    const input = parsed.data;
+    let payload;
+    try {
+        payload = distributionAmount(input);
+    }
+    catch (err) {
+        return {
+            ok: false,
+            error: makeError({
+                code: "INTERNAL",
+                message: "Engine error computing RMD distribution amount.",
+                retriable: false,
+            }),
+        };
+    }
+    if (!Number.isFinite(payload.rmdAmount) ||
+        !Number.isFinite(payload.distributionPeriod) ||
+        !Number.isFinite(payload.lifeExpectancyFactor) ||
+        !Number.isFinite(payload.penaltyIfMissed)) {
+        return {
+            ok: false,
+            error: makeError({
+                code: "INTERNAL",
+                message: "RMD engine produced a non-finite result.",
+                retriable: false,
+            }),
+        };
+    }
+    return {
+        ok: true,
+        value: makeResult({
+            result: payload,
+            methodology: METHODOLOGY,
+            engineVersion: ENGINE_VERSION,
+            disclaimer: YMYL_DISCLAIMER,
+        }),
+    };
+}
+//# sourceMappingURL=rmd.js.map

package/dist/tools/rmd.js.map

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

package/dist/tools/rothConversion.d.ts

@@ -0,0 +1,66 @@
+/**
+ * MCP tool wrapper for `dc.calculator.rothConversion.taxImpact`.
+ *
+ * Per ADR-0039 § 1: tool name locked.
+ * Per ADR-0039 § 2: Zod input with bounds from shared/bounds.ts; rate as
+ *                   whole-number Percent; enum for filing status.
+ * Per ADR-0039 § 3: returns ToolResult<RothConversionTaxImpactResult>.
+ * Per ADR-0039 § 4: errors funnel through ToolError.
+ *
+ * Scope per S141 Risk #2: SINGLE-CONVERSION tax impact only. Multi-year
+ * conversion-ladder optimization is a future tool. State tax and IRMAA tier
+ * impact are out of scope (documented in the tool description).
+ */
+import { z } from "zod";
+import { type RothConversionTaxImpactResult } from "../engines/rothConversion.js";
+import { type ToolResult, type ToolError } from "../envelope.js";
+/** Locked tool name per ADR-0039 § 1. */
+export declare const TOOL_NAME = "dc.calculator.rothConversion.taxImpact";
+/**
+ * Zod input schema. Bounds come from shared/bounds.ts. Filing status uses
+ * the paycheck-engine FEDERAL_FILING_STATUS enum (single | married |
+ * marriedSeparate | headOfHousehold) for consistency with other federal-tax
+ * tools.
+ */
+export declare const RothConversionTaxImpactInputSchema: z.ZodObject<{
+    conversionAmount: z.ZodNumber;
+    age: z.ZodNumber;
+    filingStatus: z.ZodEnum<["single", "married", "marriedSeparate", "headOfHousehold"]>;
+    currentTaxableIncome: z.ZodNumber;
+    retirementMarginalRatePercent: z.ZodOptional<z.ZodNumber>;
+    expectedReturnPercent: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    age: number;
+    filingStatus: "single" | "married" | "marriedSeparate" | "headOfHousehold";
+    conversionAmount: number;
+    currentTaxableIncome: number;
+    retirementMarginalRatePercent?: number | undefined;
+    expectedReturnPercent?: number | undefined;
+}, {
+    age: number;
+    filingStatus: "single" | "married" | "marriedSeparate" | "headOfHousehold";
+    conversionAmount: number;
+    currentTaxableIncome: number;
+    retirementMarginalRatePercent?: number | undefined;
+    expectedReturnPercent?: number | undefined;
+}>;
+export type RothConversionTaxImpactToolInput = z.infer<typeof RothConversionTaxImpactInputSchema>;
+/** Tool description used in mcp.tools/list. */
+export declare const TOOL_DESCRIPTION: string;
+/**
+ * Execute the tool. Validation + engine call wrapped in the standard envelope.
+ *
+ * Tagged-union return:
+ *   { ok: true, value: ToolResult<...> }
+ *   { ok: false, error: ToolError }
+ *
+ * The MCP SDK adapter at src/index.ts maps `ok=false` to `isError: true`.
+ */
+export declare function execute(rawInput: unknown): {
+    ok: true;
+    value: ToolResult<RothConversionTaxImpactResult>;
+} | {
+    ok: false;
+    error: ToolError;
+};
+//# sourceMappingURL=rothConversion.d.ts.map

package/dist/tools/rothConversion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rothConversion.d.ts","sourceRoot":"","sources":["../../src/tools/rothConversion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAGL,KAAK,6BAA6B,EACnC,MAAM,8BAA8B,CAAC;AAItC,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,SAAS,EACf,MAAM,gBAAgB,CAAC;AAExB,yCAAyC;AACzC,eAAO,MAAM,SAAS,2CAA2C,CAAC;AAQlE;;;;;GAKG;AACH,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;EA0C7C,CAAC;AAEH,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CACpD,OAAO,kCAAkC,CAC1C,CAAC;AAEF,+CAA+C;AAC/C,eAAO,MAAM,gBAAgB,QAOiB,CAAC;AAE/C;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CACrB,QAAQ,EAAE,OAAO,GAEf;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC,6BAA6B,CAAC,CAAA;CAAE,GAC9D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CA+DlC"}