@markcolabs/mcp 0.1.0 → 0.3.0

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/dist/tools/socialSecurity.d.ts

@@ -1,5 +1,5 @@
 /**
- * MCP tool wrapper for `dc.calculator.socialSecurity.estimate`.
+ * MCP tool wrapper for `dc.calculator.socialSecurity.estimatedBenefit`.
  *
  * Per ADR-0039 § 1: tool name is locked.
  * Per ADR-0039 § 2: Zod input schema with bounds from shared/bounds.ts.
@@ -15,8 +15,8 @@
 import { z } from "zod";
 import { type SocialSecurityEstimateResult } from "../engines/socialSecurity.js";
 import { type ToolResult, type ToolError } from "../envelope.js";
-/** Locked tool name per ADR-0039 § 1. */
-export declare const TOOL_NAME = "dc.calculator.socialSecurity.estimate";
+/** Locked tool name per ADR-0039 § 1 (corrected v0.2.0 per ADR-0041 D2). */
+export declare const TOOL_NAME = "dc.calculator.socialSecurity.estimatedBenefit";
 export declare const SocialSecurityEstimateInputSchema: z.ZodObject<{
     birthYear: z.ZodNumber;
     currentEarnings: z.ZodNumber;

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

@@ -1 +1 @@
-{"version":3,"file":"socialSecurity.d.ts","sourceRoot":"","sources":["../../src/tools/socialSecurity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAGL,KAAK,4BAA4B,EAClC,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,SAAS,EACf,MAAM,gBAAgB,CAAC;AAExB,yCAAyC;AACzC,eAAO,MAAM,SAAS,0CAA0C,CAAC;AAOjE,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;EAsC5C,CAAC;AAEH,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CACnD,OAAO,iCAAiC,CACzC,CAAC;AAEF,eAAO,MAAM,gBAAgB,QAMmC,CAAC;AAEjE;;GAEG;AACH,wBAAgB,OAAO,CACrB,QAAQ,EAAE,OAAO,GAEf;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC,4BAA4B,CAAC,CAAA;CAAE,GAC7D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAuDlC"}
+{"version":3,"file":"socialSecurity.d.ts","sourceRoot":"","sources":["../../src/tools/socialSecurity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAGL,KAAK,4BAA4B,EAClC,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,SAAS,EACf,MAAM,gBAAgB,CAAC;AAExB,4EAA4E;AAC5E,eAAO,MAAM,SAAS,kDAAkD,CAAC;AAOzE,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;EAsC5C,CAAC;AAEH,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CACnD,OAAO,iCAAiC,CACzC,CAAC;AAEF,eAAO,MAAM,gBAAgB,QAMmC,CAAC;AAEjE;;GAEG;AACH,wBAAgB,OAAO,CACrB,QAAQ,EAAE,OAAO,GAEf;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC,4BAA4B,CAAC,CAAA;CAAE,GAC7D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAuDlC"}

package/dist/tools/socialSecurity.js

@@ -1,5 +1,5 @@
 /**
- * MCP tool wrapper for `dc.calculator.socialSecurity.estimate`.
+ * MCP tool wrapper for `dc.calculator.socialSecurity.estimatedBenefit`.
  *
  * Per ADR-0039 § 1: tool name is locked.
  * Per ADR-0039 § 2: Zod input schema with bounds from shared/bounds.ts.
@@ -17,8 +17,8 @@ import { estimate, ENGINE_VERSION, } from "../engines/socialSecurity.js";
 import { SOCIAL_SECURITY_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.socialSecurity.estimate";
+/** Locked tool name per ADR-0039 § 1 (corrected v0.2.0 per ADR-0041 D2). */
+export const TOOL_NAME = "dc.calculator.socialSecurity.estimatedBenefit";
 const METHODOLOGY = {
     url: "https://www.digitalcalculator.info/social-security-calculator/methodology/",
     version: "2026-05-09",

package/dist/tools/socialSecurity.js.map

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

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@markcolabs/mcp",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "private": false,
-  "description": "Model Context Protocol server for digitalcalculator.info financial calculators. v0.1.0 ships 5 calculator tools (mortgage monthlyPayment, compound-interest futureValue, 401k projection, Social Security estimate, paycheck netPay). Per ADR-0039.",
+  "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,19 +37,31 @@
   "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/digitalcalculator/digitalcalculator.git",
+    "url": "https://github.com/mark57-ux/digitalcalculator.git",
     "directory": "packages/mcp"
   }
 }