@markcolabs/mcp 0.2.0 → 0.3.0

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":"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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":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,kBAAkB,EAClB,cAAc,GAEf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,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,sCAAsC,CAAC;AAEhE,0CAA0C;AAC1C,MAAM,WAAW,GAAG;IAClB,GAAG,EAAE,oDAAoD;IACzD,OAAO,EAAE,YAAY;CACtB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,MAAM,CAAC;IACvD,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC;SAC3B,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC;SAC3B,QAAQ,CACP,6DAA6D,CAC9D;IACH,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC;SAC7B,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC;SAC7B,QAAQ,CACP,oNAAoN,CACrN;IACH,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,2KAA2K,CAC5K;IACH,uBAAuB,EAAE,CAAC;SACvB,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,+IAA+I,CAChJ;CACJ,CAAC,CAAC;AAMH,+CAA+C;AAC/C,MAAM,CAAC,MAAM,gBAAgB,GAC3B,8EAA8E;IAC9E,8EAA8E;IAC9E,iFAAiF;IACjF,gFAAgF;IAChF,0EAA0E;IAC1E,0EAA0E;IAC1E,4EAA4E;IAC5E,0EAA0E;IAC1E,+DAA+D;IAC/D,8DAA8D;IAC9D,oEAAoE;IACpE,0BAA0B,CAAC;AAE7B;;;;;;;;GAQG;AACH,MAAM,UAAU,OAAO,CACrB,QAAiB;IAIjB,MAAM,MAAM,GAAG,gCAAgC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACpE,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,OAAoC,CAAC;IACzC,IAAI,CAAC;QACH,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,SAAS,CAAC;gBACf,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,iDAAiD;gBAC1D,SAAS,EAAE,KAAK;aACjB,CAAC;SACH,CAAC;IACJ,CAAC;IAED,IACE,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC;QACnC,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,kBAAkB,CAAC;QAC5C,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,oBAAoB,CAAC;QAC9C,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,eAAe,CAAC,EACzC,CAAC;QACD,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,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/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"}

package/dist/tools/rothConversion.js

@@ -0,0 +1,141 @@
+/**
+ * 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 { taxImpact, ENGINE_VERSION, } from "../engines/rothConversion.js";
+import { ROTH_CONVERSION_BOUNDS } from "../shared/bounds.js";
+import { FEDERAL_FILING_STATUS } 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.rothConversion.taxImpact";
+/** Methodology pointer — ADR-0039 § 3. */
+const METHODOLOGY = {
+    url: "https://www.digitalcalculator.info/roth-conversion-calculator/",
+    version: "2026-05-27",
+};
+/**
+ * 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 const RothConversionTaxImpactInputSchema = z.object({
+    conversionAmount: z
+        .number()
+        .min(ROTH_CONVERSION_BOUNDS.MIN_CONVERSION)
+        .max(ROTH_CONVERSION_BOUNDS.MAX_CONVERSION)
+        .describe("Conversion amount in USD."),
+    age: z
+        .number()
+        .int()
+        .min(ROTH_CONVERSION_BOUNDS.MIN_AGE)
+        .max(ROTH_CONVERSION_BOUNDS.MAX_AGE)
+        .describe("Current age. Drives the Roth 5-year-rule flag (applies if age < 59.5)."),
+    filingStatus: z
+        .enum(FEDERAL_FILING_STATUS)
+        .describe("Federal filing status: single | married | marriedSeparate | headOfHousehold."),
+    currentTaxableIncome: z
+        .number()
+        .min(ROTH_CONVERSION_BOUNDS.MIN_TAXABLE_INCOME)
+        .max(ROTH_CONVERSION_BOUNDS.MAX_TAXABLE_INCOME)
+        .describe("Current federal taxable income BEFORE adding the conversion, USD. Used as the lower bound for the incremental-tax bracket walk."),
+    retirementMarginalRatePercent: z
+        .number()
+        .min(ROTH_CONVERSION_BOUNDS.MIN_RETIREMENT_RATE_PERCENT)
+        .max(ROTH_CONVERSION_BOUNDS.MAX_RETIREMENT_RATE_PERCENT)
+        .optional()
+        .describe("Optional expected retirement marginal federal tax rate, whole-number percent (e.g., 12 for 12%). When omitted, breakEvenYears returns null."),
+    expectedReturnPercent: z
+        .number()
+        .min(ROTH_CONVERSION_BOUNDS.MIN_RETURN_PERCENT)
+        .max(ROTH_CONVERSION_BOUNDS.MAX_RETURN_PERCENT)
+        .optional()
+        .describe("Optional real annual return on the converted Roth balance, whole-number percent. Defaults to 7. Used only for the break-even calculation."),
+});
+/** Tool description used in mcp.tools/list. */
+export const TOOL_DESCRIPTION = "Compute the federal income tax impact of a SINGLE Roth conversion using " +
+    "2026 IRS brackets. Returns the incremental tax owed, the top marginal " +
+    "bracket the conversion pushes you into, the effective rate, a Roth 5-year-" +
+    "rule flag, and optional break-even years if you provide your expected " +
+    "retirement marginal rate. SCOPE LIMITS: single-conversion only (multi-year " +
+    "optimization is a future tool); state tax and IRMAA tier impact are NOT " +
+    "modeled — caller is responsible for those.";
+/**
+ * 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 = RothConversionTaxImpactInputSchema.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 = taxImpact(input);
+    }
+    catch (err) {
+        return {
+            ok: false,
+            error: makeError({
+                code: "INTERNAL",
+                message: "Engine error computing Roth conversion tax impact.",
+                retriable: false,
+            }),
+        };
+    }
+    // Sanity check: NaN / non-finite results are an internal failure.
+    // breakEvenYears may legitimately be null (no retirement rate given) or
+    // Infinity (mathematically unreachable), both of which we allow.
+    const beOk = payload.breakEvenYears === null ||
+        payload.breakEvenYears === Infinity ||
+        Number.isFinite(payload.breakEvenYears);
+    if (!Number.isFinite(payload.taxOwed) ||
+        !Number.isFinite(payload.marginalRateOnConversion) ||
+        !Number.isFinite(payload.effectiveRateOnConversion) ||
+        !beOk) {
+        return {
+            ok: false,
+            error: makeError({
+                code: "INTERNAL",
+                message: "Roth conversion engine produced a non-finite result.",
+                retriable: false,
+            }),
+        };
+    }
+    return {
+        ok: true,
+        value: makeResult({
+            result: payload,
+            methodology: METHODOLOGY,
+            engineVersion: ENGINE_VERSION,
+            disclaimer: YMYL_DISCLAIMER,
+        }),
+    };
+}
+//# sourceMappingURL=rothConversion.js.map

package/dist/tools/rothConversion.js.map

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

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@markcolabs/mcp",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "private": false,
-  "description": "Model Context Protocol server for digitalcalculator.info financial calculators. v0.2.0 ships 5 calculator tools (mortgage monthlyPayment, compound-interest futureValue, retirement401k projection, Social Security estimatedBenefit, paycheck netPay). Per ADR-0039 + ADR-0041 contract reconciliation.",
+  "description": "Model Context Protocol server for digitalcalculator.info financial calculators. v0.3.0 ships 9 calculator tools (mortgage monthlyPayment, compound-interest futureValue, retirement401k projection, Social Security estimatedBenefit, paycheck netPay, IRA contributionLimit, Roth conversion taxImpact, RMD distributionAmount, HSA contributionLimit). Per ADR-0039 + ADR-0041 contract reconciliation.",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -18,7 +18,9 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "LICENSE",
+    "LICENSE-API.md"
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
@@ -35,16 +37,28 @@
   "keywords": [
     "mcp",
     "model-context-protocol",
+    "mcp-server",
+    "claude-mcp",
+    "anthropic",
     "financial-calculator",
     "mortgage",
     "compound-interest",
     "401k",
     "social-security",
     "paycheck",
-    "digitalcalculator"
+    "ira",
+    "roth-conversion",
+    "rmd",
+    "hsa",
+    "digitalcalculator",
+    "digitalcalculator.info"
   ],
   "author": "Markcolabs LLC",
   "license": "MIT",
+  "homepage": "https://www.digitalcalculator.info/mcp/",
+  "bugs": {
+    "url": "https://github.com/mark57-ux/digitalcalculator/issues"
+  },
   "repository": {
     "type": "git",
     "url": "https://github.com/mark57-ux/digitalcalculator.git",