@markcolabs/mcp 0.3.0 → 0.4.1

package/dist/index.js

@@ -1,295 +1,67 @@
 #!/usr/bin/env node
 /**
- * @markcolabs/mcp — MCP server entrypoint.
+ * @markcolabs/mcp v0.4.1 — stdio↔HTTPS shim.
  *
- * v0.3.0 (per ADR-0039 + ADR-0041 reconciliation; S141 Wave 1A + 1B).
- * Registers:
- *   - 9 tools:
- *       dc.calculator.mortgage.monthlyPayment           (S135 Item 5)
- *       dc.calculator.compoundInterest.futureValue      (S135 Item 5)
- *       dc.calculator.retirement401k.projection         (S136 Item 3, renamed v0.2.0 per ADR-0041 D2)
- *       dc.calculator.socialSecurity.estimatedBenefit   (S136 Item 3, renamed v0.2.0 per ADR-0041 D2)
- *       dc.calculator.paycheck.netPay                   (S136 Item 3)
- *       dc.calculator.ira.contributionLimit             (S141 Wave 1A)
- *       dc.calculator.rothConversion.taxImpact          (S141 Wave 1A)
- *       dc.calculator.rmd.distributionAmount            (S141 Wave 1B — new)
- *       dc.calculator.hsa.contributionLimit             (S141 Wave 1B — new)
- *   - 1 resource: dc://disclaimers/ymyl (canonical YMYL disclaimer)
+ * Proxies MCP JSON-RPC messages from stdin to the hosted MCP server at
+ * mcp.digitalcalculator.info/mcp and writes responses back to stdout.
  *
- * Transport: stdio (default for local MCP clients).
+ * Per ADR-0044a (ACCEPTED 2026-05-28): engine source lives in the private
+ * monorepo at infra/mcp/. This shim contains no calculation logic — it is
+ * a thin transport adapter only. MIT-licensed.
  *
- * S141 Wave 1A took tool coverage 5 → 7; Wave 1B finalizes 7 → 9 (v0.3.0).
+ * Claude Desktop config:
+ *   { "mcpServers": { "digitalcalculator": { "command": "npx", "args": ["-y", "@markcolabs/mcp"] } } }
  */
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import { zodToJsonSchema } from "./util/zod-to-json-schema.js";
-import * as mortgageTool from "./tools/mortgage.js";
-import * as compoundInterestTool from "./tools/compoundInterest.js";
-import * as retirement401kTool from "./tools/retirement401k.js";
-import * as socialSecurityTool from "./tools/socialSecurity.js";
-import * as paycheckTool from "./tools/paycheck.js";
-import * as iraTool from "./tools/ira.js";
-import * as rothConversionTool from "./tools/rothConversion.js";
-import * as rmdTool from "./tools/rmd.js";
-import * as hsaTool from "./tools/hsa.js";
-import { YMYL_DISCLAIMER, YMYL_DISCLAIMER_URI, } from "./disclaimers/ymyl.js";
-// Re-export the tool execute functions and engines so consumers (and parity
-// tests) can import them directly without spinning up the MCP transport.
-export { execute as executeMortgageTool } from "./tools/mortgage.js";
-export { execute as executeCompoundInterestTool } from "./tools/compoundInterest.js";
-export { execute as executeRetirement401kTool } from "./tools/retirement401k.js";
-export { execute as executeSocialSecurityTool } from "./tools/socialSecurity.js";
-export { execute as executePaycheckTool } from "./tools/paycheck.js";
-export { execute as executeIraTool } from "./tools/ira.js";
-export { execute as executeRothConversionTool } from "./tools/rothConversion.js";
-export { execute as executeRmdTool } from "./tools/rmd.js";
-export { execute as executeHsaTool } from "./tools/hsa.js";
-export * as mortgageEngine from "./engines/mortgage.js";
-export * as compoundInterestEngine from "./engines/compoundInterest.js";
-export * as retirement401kEngine from "./engines/retirement401k.js";
-export * as socialSecurityEngine from "./engines/socialSecurity.js";
-export * as paycheckEngine from "./engines/paycheck.js";
-export * as iraEngine from "./engines/ira.js";
-export * as rothConversionEngine from "./engines/rothConversion.js";
-export * as rmdEngine from "./engines/rmd.js";
-export * as hsaEngine from "./engines/hsa.js";
-export * from "./envelope.js";
-// ---------------------------------------------------------------------------
-// Server setup
-// ---------------------------------------------------------------------------
-const server = new Server({
-    name: "@markcolabs/mcp",
-    version: "0.3.0",
-}, {
-    capabilities: {
-        tools: {},
-        resources: {},
-    },
-});
-// ---------------------------------------------------------------------------
-// tools/list
-// ---------------------------------------------------------------------------
-/**
- * Tool annotations per Anthropic Claude Connectors Directory spec
- * (MCP-AUDIT-023, S141 Item #5):
- *   - title:           human-readable display name (sentence-case)
- *   - readOnlyHint:    true — all our tools are pure functions, no mutation
- *   - destructiveHint: false — no tool modifies any state
- *
- * Applied uniformly across all 9 tools — the package is read-only by design
- * (MCP-AUDIT-008 audit-bundle conclusion).
- */
-const READ_ONLY_ANNOTATIONS = {
-    readOnlyHint: true,
-    destructiveHint: false,
-};
-server.setRequestHandler(ListToolsRequestSchema, async () => {
-    return {
-        tools: [
-            {
-                name: mortgageTool.TOOL_NAME,
-                description: mortgageTool.TOOL_DESCRIPTION,
-                inputSchema: zodToJsonSchema(mortgageTool.MortgageMonthlyPaymentInputSchema),
-                annotations: {
-                    title: "Mortgage Monthly Payment",
-                    ...READ_ONLY_ANNOTATIONS,
-                },
-            },
-            {
-                name: compoundInterestTool.TOOL_NAME,
-                description: compoundInterestTool.TOOL_DESCRIPTION,
-                inputSchema: zodToJsonSchema(compoundInterestTool.CompoundInterestFutureValueInputSchema),
-                annotations: {
-                    title: "Compound Interest Future Value",
-                    ...READ_ONLY_ANNOTATIONS,
-                },
-            },
-            {
-                name: retirement401kTool.TOOL_NAME,
-                description: retirement401kTool.TOOL_DESCRIPTION,
-                inputSchema: zodToJsonSchema(retirement401kTool.Retirement401kProjectionInputSchema),
-                annotations: {
-                    title: "401(k) Retirement Projection",
-                    ...READ_ONLY_ANNOTATIONS,
-                },
-            },
-            {
-                name: socialSecurityTool.TOOL_NAME,
-                description: socialSecurityTool.TOOL_DESCRIPTION,
-                inputSchema: zodToJsonSchema(socialSecurityTool.SocialSecurityEstimateInputSchema),
-                annotations: {
-                    title: "Social Security Estimated Benefit",
-                    ...READ_ONLY_ANNOTATIONS,
-                },
-            },
-            {
-                name: paycheckTool.TOOL_NAME,
-                description: paycheckTool.TOOL_DESCRIPTION,
-                inputSchema: zodToJsonSchema(paycheckTool.PaycheckNetPayInputSchema),
-                annotations: {
-                    title: "Paycheck Net Pay",
-                    ...READ_ONLY_ANNOTATIONS,
-                },
-            },
-            {
-                name: iraTool.TOOL_NAME,
-                description: iraTool.TOOL_DESCRIPTION,
-                inputSchema: zodToJsonSchema(iraTool.IraContributionLimitInputSchema),
-                annotations: {
-                    title: "IRA Contribution Limit",
-                    ...READ_ONLY_ANNOTATIONS,
-                },
-            },
-            {
-                name: rothConversionTool.TOOL_NAME,
-                description: rothConversionTool.TOOL_DESCRIPTION,
-                inputSchema: zodToJsonSchema(rothConversionTool.RothConversionTaxImpactInputSchema),
-                annotations: {
-                    title: "Roth Conversion Tax Impact",
-                    ...READ_ONLY_ANNOTATIONS,
-                },
-            },
-            {
-                name: rmdTool.TOOL_NAME,
-                description: rmdTool.TOOL_DESCRIPTION,
-                inputSchema: zodToJsonSchema(rmdTool.RmdDistributionAmountInputSchema),
-                annotations: {
-                    title: "RMD Distribution Amount",
-                    ...READ_ONLY_ANNOTATIONS,
-                },
-            },
-            {
-                name: hsaTool.TOOL_NAME,
-                description: hsaTool.TOOL_DESCRIPTION,
-                inputSchema: zodToJsonSchema(hsaTool.HsaContributionLimitInputSchema),
-                annotations: {
-                    title: "HSA Contribution Limit",
-                    ...READ_ONLY_ANNOTATIONS,
-                },
+import * as readline from "readline";
+import * as https from "https";
+const MCP_ENDPOINT = "https://mcp.digitalcalculator.info/mcp";
+const SESSION_ID = Math.random().toString(36).slice(2);
+const PACKAGE_VERSION = "0.4.1";
+const REQUEST_TIMEOUT_MS = 30_000;
+function post(body) {
+    return new Promise((resolve, reject) => {
+        const url = new URL(MCP_ENDPOINT);
+        const data = Buffer.from(body);
+        const req = https.request({
+            hostname: url.hostname,
+            path: url.pathname,
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "Content-Length": data.byteLength,
+                "Mcp-Session-Id": SESSION_ID,
+                "User-Agent": `@markcolabs/mcp/${PACKAGE_VERSION}`,
             },
-        ],
-    };
-});
-// ---------------------------------------------------------------------------
-// tools/call
-// ---------------------------------------------------------------------------
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-    const { name, arguments: args } = request.params;
-    let result;
-    switch (name) {
-        case mortgageTool.TOOL_NAME:
-            result = mortgageTool.execute(args);
-            break;
-        case compoundInterestTool.TOOL_NAME:
-            result = compoundInterestTool.execute(args);
-            break;
-        case retirement401kTool.TOOL_NAME:
-            result = retirement401kTool.execute(args);
-            break;
-        case socialSecurityTool.TOOL_NAME:
-            result = socialSecurityTool.execute(args);
-            break;
-        case paycheckTool.TOOL_NAME:
-            result = paycheckTool.execute(args);
-            break;
-        case iraTool.TOOL_NAME:
-            result = iraTool.execute(args);
-            break;
-        case rothConversionTool.TOOL_NAME:
-            result = rothConversionTool.execute(args);
-            break;
-        case rmdTool.TOOL_NAME:
-            result = rmdTool.execute(args);
-            break;
-        case hsaTool.TOOL_NAME:
-            result = hsaTool.execute(args);
-            break;
-        default:
-            return {
-                isError: true,
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({
-                            error: {
-                                code: "INPUT_VALIDATION",
-                                message: `Unknown tool: ${name}`,
-                                retriable: false,
-                            },
-                        }),
-                    },
-                ],
-            };
+            timeout: REQUEST_TIMEOUT_MS,
+        }, (res) => {
+            const chunks = [];
+            res.on("data", (chunk) => chunks.push(chunk));
+            res.on("end", () => resolve(Buffer.concat(chunks).toString("utf8")));
+        });
+        req.on("timeout", () => req.destroy(new Error(`Request timed out after ${REQUEST_TIMEOUT_MS / 1000}s`)));
+        req.on("error", reject);
+        req.write(data);
+        req.end();
+    });
+}
+const rl = readline.createInterface({ input: process.stdin, terminal: false });
+rl.on("line", async (line) => {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return;
+    try {
+        const response = await post(trimmed);
+        process.stdout.write(response + "\n");
     }
-    if (result.ok) {
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: JSON.stringify(result.value, null, 2),
-                },
-            ],
-        };
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        const parsed = (() => { try {
+            return JSON.parse(trimmed);
+        }
+        catch {
+            return {};
+        } })();
+        process.stdout.write(JSON.stringify({ jsonrpc: "2.0", id: parsed.id ?? null, error: { code: -32603, message } }) + "\n");
     }
-    return {
-        isError: true,
-        content: [
-            {
-                type: "text",
-                text: JSON.stringify(result.error),
-            },
-        ],
-    };
-});
-// ---------------------------------------------------------------------------
-// resources/list — exposes the canonical YMYL disclaimer (O5-KR2 stub)
-// ---------------------------------------------------------------------------
-server.setRequestHandler(ListResourcesRequestSchema, async () => {
-    return {
-        resources: [
-            {
-                uri: YMYL_DISCLAIMER_URI,
-                name: "Canonical YMYL Disclaimer",
-                description: "Single source of truth for the YMYL disclaimer string returned in every tool response.",
-                mimeType: "text/plain",
-            },
-        ],
-    };
 });
-server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
-    const { uri } = request.params;
-    if (uri === YMYL_DISCLAIMER_URI) {
-        return {
-            contents: [
-                {
-                    uri,
-                    mimeType: "text/plain",
-                    text: YMYL_DISCLAIMER,
-                },
-            ],
-        };
-    }
-    throw new Error(`Unknown resource: ${uri}`);
-});
-// ---------------------------------------------------------------------------
-// Boot — only run when invoked directly (not when imported by tests).
-// ---------------------------------------------------------------------------
-async function main() {
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-    // eslint-disable-next-line no-console
-    console.error("[@markcolabs/mcp] v0.3.0 ready (stdio) — 9 tools registered.");
-}
-// Run only when invoked as a binary, not when imported by parity tests.
-const isDirect = import.meta.url === `file://${process.argv[1]}` ||
-    process.argv[1]?.endsWith("dist/index.js") ||
-    process.argv[1]?.endsWith("dist\\index.js");
-if (isDirect) {
-    main().catch((err) => {
-        // eslint-disable-next-line no-console
-        console.error("[@markcolabs/mcp] fatal:", err);
-        process.exit(1);
-    });
-}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@markcolabs/mcp",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "private": false,
-  "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.",
+  "description": "MCP stdio↔HTTPS shim for digitalcalculator.info financial calculators. Proxies MCP JSON-RPC to the hosted server at mcp.digitalcalculator.info/mcp. Per ADR-0044a: engine source is private; this package is a thin transport adapter only.",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -12,24 +12,17 @@
   "scripts": {
     "build": "tsc",
     "start": "node ./dist/index.js",
-    "test": "vitest run",
-    "test:watch": "vitest",
     "typecheck": "tsc --noEmit"
   },
   "files": [
     "dist",
     "README.md",
-    "LICENSE",
-    "LICENSE-API.md"
+    "LICENSE"
   ],
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "zod": "^3.23.8"
-  },
+  "dependencies": {},
   "devDependencies": {
     "@types/node": "^20.12.7",
-    "typescript": "^5.4.5",
-    "vitest": "^4.0.18"
+    "typescript": "^5.4.5"
   },
   "engines": {
     "node": ">=18.0.0"
@@ -50,8 +43,17 @@
     "roth-conversion",
     "rmd",
     "hsa",
+    "inflation",
+    "savings",
     "digitalcalculator",
-    "digitalcalculator.info"
+    "digitalcalculator.info",
+    "financial-planning",
+    "loan",
+    "retirement-planning",
+    "investment",
+    "debt",
+    "capital-gains",
+    "net-worth"
   ],
   "author": "Markcolabs LLC",
   "license": "MIT",

package/LICENSE-API.md

@@ -1,111 +0,0 @@
-# Hosted API Terms — `mcp.digitalcalculator.info/mcp`
-
-**Document**: LICENSE-API.md
-**Applies to**: Use of the **hosted** MCP API at `https://mcp.digitalcalculator.info/mcp` operated by Markco Labs LLC.
-**Does NOT apply to**: Self-hosted use of the `@markcolabs/mcp` source code, which is governed by the [MIT LICENSE](./LICENSE) that ships in this package.
-
-These terms are distinct from, and complementary to, the MIT license that
-governs the package source. The MIT license lets you copy, modify, and
-redistribute the source — including running your own copy of the server on
-your own infrastructure. These hosted-API terms govern how you may interact
-with the Markco Labs–operated HTTP endpoint at the URL above.
-
----
-
-## 1. Scope
-
-These terms apply **only** to HTTP requests made to
-`https://mcp.digitalcalculator.info/mcp` (and any future host-name variants
-operated by Markco Labs LLC for the same service).
-
-If you `npm install @markcolabs/mcp` and run it locally over MCP stdio, or
-deploy it to your own infrastructure, the MIT [LICENSE](./LICENSE) is the only
-license that applies — these hosted-API terms do not bind you in that mode.
-
-## 2. Acceptable Use
-
-The hosted endpoint is free to use, without signup or API key, subject to the
-following acceptable-use constraints:
-
-- **No scraping at scale.** The endpoint is for interactive AI agent calls and
-  developer integrations. Bulk crawling of every input combination to build
-  derivative datasets is not permitted.
-- **No resale of raw API output as a standalone product.** Embedding tool
-  responses inside a larger product (AI agent answers, calculators, dashboards)
-  is fine and encouraged. Selling the raw JSON responses as a paid feed is not.
-- **No sole-authority financial decisions.** The tools return YMYL (Your Money
-  or Your Life) estimates with a canonical disclaimer (see
-  `packages/mcp/src/disclaimers/ymyl.ts`). Downstream products must surface
-  the disclaimer alongside the numbers and must not present the results as
-  professional financial, tax, legal, or investment advice. Verify all
-  outputs against the canonical methodology pages on
-  [www.digitalcalculator.info](https://www.digitalcalculator.info) before
-  acting on them.
-- **No reverse-engineering of throttle behavior** to evade rate limits, and
-  no use of multiple IPs / clients to multiply effective throughput beyond
-  the published thresholds.
-
-## 3. Rate Limits
-
-The hosted endpoint enforces a per-IP rate limit:
-
-- **100 requests per 5 minutes per source IP** (WAFv2-enforced floor).
-- Bursts above this threshold receive HTTP 429 with the
-  `{"error":{"code":"RATE_LIMIT","retriable":true}}` envelope.
-- Markco Labs reserves the right to tighten, loosen, or replace this throttle
-  at any time. Significant changes will be announced in the package CHANGELOG
-  and on the [/mcp/](https://www.digitalcalculator.info/mcp/) landing page.
-
-Markco Labs reserves the right to suspend or block clients (by IP, ASN, or
-other identifier) that materially exceed fair-share usage, generate abuse
-patterns, or violate the acceptable-use terms above. Suspension decisions
-are at Markco Labs' sole discretion.
-
-## 4. No Warranty / Liability Limitation
-
-THE HOSTED API IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, OR ACCURACY OF THE
-CALCULATIONS RETURNED.
-
-Specifically:
-
-- **No accuracy warranty for hosted output.** Although the engines that power
-  the hosted endpoint are parity-tested against the canonical calculators at
-  www.digitalcalculator.info on every release, the hosted endpoint is a
-  convenience surface. Authoritative results for any consequential financial
-  decision must be verified against the corresponding methodology page on the
-  main site (linked via the `methodology.url` field of every response
-  envelope).
-- **No uptime SLA.** The hosted endpoint is offered free of charge and runs
-  on best-effort infrastructure. No service-level agreement is provided.
-- **No liability for downstream use.** Markco Labs is not liable for any
-  damages — direct, indirect, incidental, special, consequential, or punitive
-  — arising from your use of the hosted endpoint, including but not limited
-  to losses caused by acting on inaccurate or out-of-date calculations.
-
-Self-hosters running the MIT-licensed source independently are governed only
-by the warranty disclaimer in the [LICENSE](./LICENSE) file — not by this
-section.
-
-## 5. Contact
-
-- **Technical issues** (bugs, broken responses, integration questions): open
-  an issue at
-  [github.com/mark57-ux/digitalcalculator/issues](https://github.com/mark57-ux/digitalcalculator/issues).
-  Best-effort triage, no SLA.
-- **Acceptable-use questions or abuse reports**: open a GitHub issue with the
-  `mcp-abuse` label, or use the contact path on
-  [www.digitalcalculator.info](https://www.digitalcalculator.info).
-- **Content / accuracy concerns**: the canonical YMYL disclaimer policy
-  (see `packages/mcp/src/disclaimers/ymyl.ts` and the response envelope)
-  applies. Direct content/accuracy disputes to the corresponding calculator's
-  methodology page on www.digitalcalculator.info.
-
----
-
-These terms may be updated from time to time. The version that applies to a
-given request is the version that was current at the time the request was
-served. Material changes are noted in `packages/mcp/CHANGELOG.md`.
-
-Last updated: 2026-05-27 (v0.2.1 patch release).

package/dist/disclaimers/ymyl.d.ts

@@ -1,16 +0,0 @@
-/**
- * Canonical YMYL disclaimer — single source of truth.
- *
- * Per ADR-0039 § 3 and § Implementation Notes / "YMYL disclaimer canonicalization":
- * - Every ToolResult.disclaimer field embeds this exact string.
- * - The same string is exposed as the `dc://disclaimers/ymyl` MCP resource.
- * - Tools do NOT author their own disclaimers. All MCP responses use this constant.
- *
- * Authoring is owned by Content. Updates here propagate to every tool response.
- */
-export declare const YMYL_DISCLAIMER: string;
-/**
- * MCP resource URI under which the disclaimer is exposed (O5-KR2).
- */
-export declare const YMYL_DISCLAIMER_URI = "dc://disclaimers/ymyl";
-//# sourceMappingURL=ymyl.d.ts.map

package/dist/disclaimers/ymyl.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ymyl.d.ts","sourceRoot":"","sources":["../../src/disclaimers/ymyl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,QAKqE,CAAC;AAElG;;GAEG;AACH,eAAO,MAAM,mBAAmB,0BAA0B,CAAC"}

package/dist/disclaimers/ymyl.js

@@ -1,20 +0,0 @@
-/**
- * Canonical YMYL disclaimer — single source of truth.
- *
- * Per ADR-0039 § 3 and § Implementation Notes / "YMYL disclaimer canonicalization":
- * - Every ToolResult.disclaimer field embeds this exact string.
- * - The same string is exposed as the `dc://disclaimers/ymyl` MCP resource.
- * - Tools do NOT author their own disclaimers. All MCP responses use this constant.
- *
- * Authoring is owned by Content. Updates here propagate to every tool response.
- */
-export const YMYL_DISCLAIMER = "Estimates only — for educational purposes. Results are computed in USD using deterministic " +
-    "formulas and the inputs you provided. They do not constitute financial, tax, legal, or " +
-    "investment advice. Actual rates, fees, taxes, and outcomes vary by lender, jurisdiction, " +
-    "and personal circumstances. Verify with a licensed professional before making financial " +
-    "decisions. Source: digitalcalculator.info — see methodology link for formula and assumptions.";
-/**
- * MCP resource URI under which the disclaimer is exposed (O5-KR2).
- */
-export const YMYL_DISCLAIMER_URI = "dc://disclaimers/ymyl";
-//# sourceMappingURL=ymyl.js.map

package/dist/disclaimers/ymyl.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ymyl.js","sourceRoot":"","sources":["../../src/disclaimers/ymyl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,eAAe,GAC1B,6FAA6F;IAC7F,yFAAyF;IACzF,2FAA2F;IAC3F,0FAA0F;IAC1F,+FAA+F,CAAC;AAElG;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,uBAAuB,CAAC"}