@markcolabs/mcp 0.3.0 → 0.4.0

package/dist/tools/rothConversion.js

@@ -1,141 +0,0 @@
-/**
- * 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

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

package/dist/tools/socialSecurity.d.ts

@@ -1,51 +0,0 @@
-/**
- * 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.
- * Per ADR-0039 § 3: returns ToolResult<SocialSecurityEstimateResult>.
- * Per ADR-0039 § 4: failures funnel through ToolError; tools never throw.
- *
- * YMYL note: SS benefits depend on a person's specific 35-year earnings
- * history; this engine uses the SSA-public bend-points formula on a
- * simplified earnings approximation (`estimateAIME`). For an authoritative
- * estimate, callers should be directed to https://www.ssa.gov/myaccount/.
- * The methodology link covers the simplified-AIME caveat.
- */
-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 (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;
-    claimAge: z.ZodNumber;
-    yearsWorked: z.ZodOptional<z.ZodNumber>;
-    lifeExpectancy: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    birthYear: number;
-    currentEarnings: number;
-    claimAge: number;
-    yearsWorked?: number | undefined;
-    lifeExpectancy?: number | undefined;
-}, {
-    birthYear: number;
-    currentEarnings: number;
-    claimAge: number;
-    yearsWorked?: number | undefined;
-    lifeExpectancy?: number | undefined;
-}>;
-export type SocialSecurityEstimateToolInput = z.infer<typeof SocialSecurityEstimateInputSchema>;
-export declare const TOOL_DESCRIPTION: string;
-/**
- * Execute the tool.
- */
-export declare function execute(rawInput: unknown): {
-    ok: true;
-    value: ToolResult<SocialSecurityEstimateResult>;
-} | {
-    ok: false;
-    error: ToolError;
-};
-//# sourceMappingURL=socialSecurity.d.ts.map

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

@@ -1 +0,0 @@
-{"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,117 +0,0 @@
-/**
- * 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.
- * Per ADR-0039 § 3: returns ToolResult<SocialSecurityEstimateResult>.
- * Per ADR-0039 § 4: failures funnel through ToolError; tools never throw.
- *
- * YMYL note: SS benefits depend on a person's specific 35-year earnings
- * history; this engine uses the SSA-public bend-points formula on a
- * simplified earnings approximation (`estimateAIME`). For an authoritative
- * estimate, callers should be directed to https://www.ssa.gov/myaccount/.
- * The methodology link covers the simplified-AIME caveat.
- */
-import { z } from "zod";
-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 (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",
-};
-export const SocialSecurityEstimateInputSchema = z.object({
-    birthYear: z
-        .number()
-        .int()
-        .min(SOCIAL_SECURITY_BOUNDS.MIN_BIRTH_YEAR)
-        .max(SOCIAL_SECURITY_BOUNDS.MAX_BIRTH_YEAR)
-        .describe("Birth year. SSA bend-point lookups support eligibility years (birthYear + 62) from 2014 onward."),
-    currentEarnings: z
-        .number()
-        .min(SOCIAL_SECURITY_BOUNDS.MIN_CURRENT_EARNINGS)
-        .max(SOCIAL_SECURITY_BOUNDS.MAX_CURRENT_EARNINGS)
-        .describe("Current/final annual earnings in USD."),
-    claimAge: z
-        .number()
-        .min(SOCIAL_SECURITY_BOUNDS.MIN_CLAIM_AGE)
-        .max(SOCIAL_SECURITY_BOUNDS.MAX_CLAIM_AGE)
-        .describe("Age at which to start claiming benefits (62-70). Earlier = reduced; later = delayed credit."),
-    yearsWorked: z
-        .number()
-        .int()
-        .min(SOCIAL_SECURITY_BOUNDS.MIN_YEARS_WORKED)
-        .max(SOCIAL_SECURITY_BOUNDS.MAX_YEARS_WORKED)
-        .optional()
-        .describe("Years of work earning SS credits. Defaults to 35 (the SSA averaging window)."),
-    lifeExpectancy: z
-        .number()
-        .min(SOCIAL_SECURITY_BOUNDS.MIN_LIFE_EXPECTANCY)
-        .max(SOCIAL_SECURITY_BOUNDS.MAX_LIFE_EXPECTANCY)
-        .optional()
-        .describe("Life expectancy assumption for lifetime benefit projection. Defaults to 85."),
-});
-export const TOOL_DESCRIPTION = "Estimate Social Security retirement benefits using the SSA bend-point " +
-    "formula and a simplified AIME approximation. Returns monthly benefit at " +
-    "Full Retirement Age, the adjusted monthly benefit at the chosen claim " +
-    "age (early reduction or delayed credit), and a lifetime projection to " +
-    "the assumed life expectancy. For an authoritative estimate based on your " +
-    "actual earnings history, see https://www.ssa.gov/myaccount/.";
-/**
- * Execute the tool.
- */
-export function execute(rawInput) {
-    const parsed = SocialSecurityEstimateInputSchema.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 = estimate(input);
-    }
-    catch (err) {
-        return {
-            ok: false,
-            error: makeError({
-                code: "INTERNAL",
-                message: "Engine error computing Social Security estimate.",
-                retriable: false,
-            }),
-        };
-    }
-    if (!Number.isFinite(payload.monthlyBenefitAtFRA) ||
-        !Number.isFinite(payload.adjustedMonthlyBenefit) ||
-        !Number.isFinite(payload.lifetimeBenefitProjection)) {
-        return {
-            ok: false,
-            error: makeError({
-                code: "INTERNAL",
-                message: "Social Security engine produced a non-finite result.",
-                retriable: false,
-            }),
-        };
-    }
-    return {
-        ok: true,
-        value: makeResult({
-            result: payload,
-            methodology: METHODOLOGY,
-            engineVersion: ENGINE_VERSION,
-            disclaimer: YMYL_DISCLAIMER,
-        }),
-    };
-}
-//# sourceMappingURL=socialSecurity.js.map

package/dist/tools/socialSecurity.js.map

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

package/dist/util/zod-to-json-schema.d.ts

@@ -1,28 +0,0 @@
-/**
- * Minimal Zod → JSON Schema converter for the MCP `tools/list` `inputSchema` field.
- *
- * The MCP SDK expects a JSON Schema object on each tool descriptor. Rather than
- * pulling in the `zod-to-json-schema` npm package (extra dep, infrequent updates),
- * this file implements the small subset we need for v1 input shapes:
- *   - z.object({...})
- *   - z.number() with .min()/.max()/.int()
- *   - z.enum([...])
- *   - .optional() / .describe() metadata
- *
- * If a schema feature added later isn't supported here, extend this util — or
- * swap in the `zod-to-json-schema` package.
- */
-import { type ZodTypeAny } from "zod";
-interface JsonSchema {
-    type?: string;
-    properties?: Record<string, JsonSchema>;
-    required?: string[];
-    description?: string;
-    minimum?: number;
-    maximum?: number;
-    enum?: string[];
-    additionalProperties?: boolean;
-}
-export declare function zodToJsonSchema(schema: ZodTypeAny): JsonSchema;
-export {};
-//# sourceMappingURL=zod-to-json-schema.d.ts.map

package/dist/util/zod-to-json-schema.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"zod-to-json-schema.d.ts","sourceRoot":"","sources":["../../src/util/zod-to-json-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAK,KAAK,UAAU,EAAE,MAAM,KAAK,CAAC;AAEzC,UAAU,UAAU;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAE9D"}

package/dist/util/zod-to-json-schema.js

@@ -1,98 +0,0 @@
-/**
- * Minimal Zod → JSON Schema converter for the MCP `tools/list` `inputSchema` field.
- *
- * The MCP SDK expects a JSON Schema object on each tool descriptor. Rather than
- * pulling in the `zod-to-json-schema` npm package (extra dep, infrequent updates),
- * this file implements the small subset we need for v1 input shapes:
- *   - z.object({...})
- *   - z.number() with .min()/.max()/.int()
- *   - z.enum([...])
- *   - .optional() / .describe() metadata
- *
- * If a schema feature added later isn't supported here, extend this util — or
- * swap in the `zod-to-json-schema` package.
- */
-import { z } from "zod";
-export function zodToJsonSchema(schema) {
-    return convert(schema);
-}
-function convert(schema) {
-    const def = schema._def;
-    const description = def?.description;
-    // ZodOptional / ZodDefault unwrapping (we still mark the field as optional in
-    // the parent object; here we just convert the inner type).
-    if (schema instanceof z.ZodOptional) {
-        return { ...convert(def.innerType), description };
-    }
-    if (schema instanceof z.ZodDefault) {
-        return { ...convert(def.innerType), description };
-    }
-    // ZodEffects wraps schemas built with .refine() / .transform() / .preprocess().
-    // Cross-field rules can't be expressed in JSON Schema, but the runtime check
-    // still fires inside the tool's safeParse(), so unwrapping to the inner schema
-    // exposes a valid JSON Schema to MCP clients without losing validation.
-    if (schema instanceof z.ZodEffects) {
-        return { ...convert(def.schema), description };
-    }
-    if (schema instanceof z.ZodObject) {
-        const shape = schema.shape;
-        const properties = {};
-        const required = [];
-        for (const [key, child] of Object.entries(shape)) {
-            const childSchema = child;
-            properties[key] = convert(childSchema);
-            const isOptional = childSchema instanceof z.ZodOptional ||
-                childSchema instanceof z.ZodDefault;
-            if (!isOptional)
-                required.push(key);
-        }
-        const out = {
-            type: "object",
-            properties,
-            additionalProperties: false,
-        };
-        if (required.length)
-            out.required = required;
-        if (description)
-            out.description = description;
-        return out;
-    }
-    if (schema instanceof z.ZodNumber) {
-        const out = { type: "number" };
-        // Iterate Zod's check list to extract min/max/int.
-        const checks = def.checks ?? [];
-        for (const c of checks) {
-            if (c.kind === "min" && typeof c.value === "number")
-                out.minimum = c.value;
-            if (c.kind === "max" && typeof c.value === "number")
-                out.maximum = c.value;
-            if (c.kind === "int")
-                out.type = "integer";
-        }
-        if (description)
-            out.description = description;
-        return out;
-    }
-    if (schema instanceof z.ZodEnum) {
-        return {
-            type: "string",
-            enum: [...schema.options],
-            ...(description ? { description } : {}),
-        };
-    }
-    if (schema instanceof z.ZodString) {
-        return {
-            type: "string",
-            ...(description ? { description } : {}),
-        };
-    }
-    if (schema instanceof z.ZodBoolean) {
-        return {
-            type: "boolean",
-            ...(description ? { description } : {}),
-        };
-    }
-    // Fallback — accept anything; widen as needed in future sprints.
-    return {};
-}
-//# sourceMappingURL=zod-to-json-schema.js.map

package/dist/util/zod-to-json-schema.js.map

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