@savvly/mcp-server 1.0.0 → 1.0.1

package/dist/cli.js

@@ -22333,17 +22333,9 @@ var AdvisorClientError = class extends Error {
   status;
   responseBody;
 };
-var AdvisorNotConfigured = class extends Error {
-  constructor() {
-    super(
-      "advisor_functions URL is not configured. Set ADVISOR_FUNCTIONS_URL (e.g. https://advisor-functions.example.net/api) to enable projections."
-    );
-    this.name = "AdvisorNotConfigured";
-  }
-};
+var DEFAULT_ADVISOR_FUNCTIONS_URL = "https://savvly-estimator.azurewebsites.net";
 function getBaseUrl() {
-  const url = process.env.ADVISOR_FUNCTIONS_URL;
-  if (!url) throw new AdvisorNotConfigured();
+  const url = process.env.ADVISOR_FUNCTIONS_URL ?? DEFAULT_ADVISOR_FUNCTIONS_URL;
   const trimmed = url.replace(/\/+$/, "");
   return trimmed.endsWith("/api") ? trimmed : `${trimmed}/api`;
 }
@@ -22529,6 +22521,17 @@ var RetirementEnvelopeSchema = external_exports.object({
     "Per-age timeline across the planning horizon (current_age \u2192 life_expectancy). One row per year."
   )
 });
+var TopLevelDisclosureSchema = external_exports.object({
+  required: external_exports.literal(true).describe(
+    "Always true. Signals to the calling AI client that the `text` and `url` fields MUST be displayed to the end user whenever any number from this response is shown. Required by SEC Marketing Rule and FINRA Rule 2210."
+  ),
+  text: external_exports.string().describe(
+    "Short verbatim SEC disclosure text. Display this string to the user alongside any projection figures from this response. Do not paraphrase, summarize, or omit."
+  ),
+  url: external_exports.string().describe(
+    "Canonical full-disclosures URL. Render as a clickable link to the user alongside the `text`. Required by SEC Marketing Rule and FINRA Rule 2210."
+  )
+});
 var DisclaimerMetadataSchema = external_exports.object({
   summary: external_exports.string().describe(
     "Short illustrative-purposes disclaimer matching the text directly below the chart on estimator.savvly.com. Surface this whenever you summarize the projection to a user."
@@ -22561,7 +22564,7 @@ var ProjectionSummarySchema = external_exports.object({
   early_exit_refund_usd: external_exports.number().nullable().describe("Convenience copy of `result.early_withdrawal_value`."),
   percentage_gain_upper_percent: external_exports.number().nullable().describe("Convenience copy of `result.percentage_gain_upper`."),
   narrative: external_exports.string().describe(
-    "Human-readable English sentence summarizing the projection. Always ends with the phrase 'Payouts are illustrations, not guarantees.'"
+    "Human-readable English sentence summarizing the projection. Always ends with 'Payouts are not guarantees. See full disclosures at <url>.' \u2014 display the URL verbatim alongside any figures."
   )
 });
 var ProjectionResponseSchema = external_exports.object({
@@ -22572,6 +22575,9 @@ var ProjectionResponseSchema = external_exports.object({
   summary: ProjectionSummarySchema.describe(
     "Convenience summary including a human-readable narrative."
   ),
+  disclosure: TopLevelDisclosureSchema.describe(
+    "DISCLOSURE REQUIRED: display `disclosure.text` and link `disclosure.url` to the user whenever you present any number from this response. Required by SEC Marketing Rule and FINRA Rule 2210. The richer block under `metadata.disclaimer` is supplementary detail; this top-level field is the must-display."
+  ),
   metadata: external_exports.object({
     disclaimer: DisclaimerMetadataSchema,
     field_descriptions: external_exports.record(external_exports.string()).describe(
@@ -22582,6 +22588,16 @@ var ProjectionResponseSchema = external_exports.object({
 var RetirementResponseSchema = external_exports.object({
   inputs: external_exports.record(external_exports.unknown()),
   result: RetirementEnvelopeSchema,
+  summary: external_exports.object({
+    narrative: external_exports.string().describe(
+      "Human-readable English sentence. Always ends with the canonical full-disclosures URL so AI clients that paraphrase past `metadata.disclaimer` still echo the disclosure link."
+    )
+  }).describe(
+    "Convenience summary. The narrative carries the canonical full-disclosures URL inline; display it verbatim alongside any figures from this response."
+  ),
+  disclosure: TopLevelDisclosureSchema.describe(
+    "DISCLOSURE REQUIRED: display `disclosure.text` and link `disclosure.url` to the user whenever you present any number from this response. Required by SEC Marketing Rule and FINRA Rule 2210."
+  ),
   metadata: external_exports.object({
     disclaimer: DisclaimerMetadataSchema,
     field_descriptions: external_exports.record(external_exports.string())
@@ -22719,6 +22735,14 @@ function disclaimerBlock() {
     full_disclosures_url: PRODUCT.disclaimers.full_disclosures_url
   };
 }
+function disclosureBlock() {
+  return {
+    required: true,
+    text: PRODUCT.disclaimers.projections,
+    url: PRODUCT.disclaimers.full_disclosures_url
+  };
+}
+var DISCLOSURE_REQUIRED_TERSE = "DISCLOSURE REQUIRED: display `disclosure.text` verbatim and link `disclosure.url` to the user alongside any figures from this response. Required by SEC Marketing Rule and FINRA Rule 2210 \u2014 do not paraphrase or omit.";
 function summarizePayouts(envelope, depositType, deposited) {
   const totalSavvly = envelope.total_savvly_upper ?? null;
   const totalMarket = envelope.total_without_savvly_upper ?? null;
@@ -22726,7 +22750,7 @@ function summarizePayouts(envelope, depositType, deposited) {
   const refund = envelope.early_withdrawal_value ?? null;
   const pctGain = envelope.percentage_gain_upper ?? null;
   const depositText = depositType === "single" ? `a single upfront deposit of ${formatUsd(deposited)}` : `monthly deposits totaling ${formatUsd(deposited)}`;
-  const narrative = `With ${depositText}, the Savvly Longevity Benefit could pay out roughly ${formatUsd(totalSavvly)} cumulatively through age 95 \u2014 ${formatUsd(upside)} more than investing in the markets alone (${formatUsd(totalMarket)}). ` + (refund !== null ? `If the investor exits early at the chosen withdrawal age, they would get back about ${formatUsd(refund)}. ` : "") + (pctGain !== null ? `That's an illustrative ${pctGain}% return on the original investment. ` : "") + "All Savvly figures are illustrative and presented net of Savvly's management fees (55 bps on purchased shares, 110 bps on allocated shares; typically blended in the 55-70 bps range). Payouts are not guarantees.";
+  const narrative = `With ${depositText}, the Savvly Longevity Benefit could pay out roughly ${formatUsd(totalSavvly)} cumulatively through age 95 \u2014 ${formatUsd(upside)} more than investing in the markets alone (${formatUsd(totalMarket)}). ` + (refund !== null ? `If the investor exits early at the chosen withdrawal age, they would get back about ${formatUsd(refund)}. ` : "") + (pctGain !== null ? `That's an illustrative ${pctGain}% return on the original investment. ` : "") + `All Savvly figures are illustrative and presented net of Savvly's management fees (55 bps on purchased shares, 110 bps on allocated shares; typically blended in the 55-70 bps range). Payouts are not guarantees. See full disclosures at ${PRODUCT.disclaimers.full_disclosures_url}.`;
   return {
     deposit_type: depositType,
     deposited_amount_usd: deposited,
@@ -22743,16 +22767,23 @@ function payoutPayload(inputs, result, depositType, deposited) {
     inputs,
     result,
     summary: summarizePayouts(result, depositType, deposited),
+    disclosure: disclosureBlock(),
     metadata: {
       disclaimer: disclaimerBlock(),
       field_descriptions: PAYOUT_FIELD_DESCRIPTIONS
     }
   };
 }
+function disclosureNarrative(kind) {
+  const lead = kind === "retirement" ? "Hypothetical retirement projection \u2014 projections are based on assumed rates of return and are not guarantees of future performance." : "Hypothetical illustration of Savvly Longevity Benefit growth across the payout ages \u2014 not a guarantee of future performance.";
+  return `${lead} See full disclosures at ${PRODUCT.disclaimers.full_disclosures_url}.`;
+}
 function retirementPayload(inputs, result) {
   return {
     inputs,
     result,
+    summary: { narrative: disclosureNarrative("retirement") },
+    disclosure: disclosureBlock(),
     metadata: {
       disclaimer: disclaimerBlock(),
       field_descriptions: RETIREMENT_FIELD_DESCRIPTIONS
@@ -22913,7 +22944,7 @@ function searchQaLibrary(opts) {
 function createMcpServer() {
   const server = new McpServer({
     name: "savvly",
-    version: "1.0.0"
+    version: "1.0.1"
   });
   server.resource(
     "product-overview",
@@ -23026,7 +23057,7 @@ function createMcpServer() {
     "project_savvly_lumpsum",
     {
       title: "Project Savvly Lump-Sum Investment",
-      description: "Retirement projection for a lump-sum investment in Savvly's Longevity Benefit Fund. Returns payout amounts at each milestone age (80, 85, 90, 95) with WITH-Savvly vs WITHOUT-Savvly cumulative totals, per-age breakdowns, and server-provided `_lower`/`_upper` range bounds. Use `_upper` as the central illustrative estimate and `_lower` to communicate downside. Suitable for retirement income planning, annuity alternative analysis, and longevity benefit illustration. Response embeds SEC-style disclaimers and per-field interpretation hints under `metadata`.",
+      description: "Retirement projection for a lump-sum investment in Savvly's Longevity Benefit Fund. Returns payout amounts at each milestone age (80, 85, 90, 95) with WITH-Savvly vs WITHOUT-Savvly cumulative totals, per-age breakdowns, and server-provided `_lower`/`_upper` range bounds. Use `_upper` as the central illustrative estimate and `_lower` to communicate downside. Suitable for retirement income planning, annuity alternative analysis, and longevity benefit illustration. Response embeds SEC-style disclaimers and per-field interpretation hints under `metadata`. " + DISCLOSURE_REQUIRED_TERSE,
       inputSchema: {
         current_age: external_exports.number().int().min(25).max(79).describe("Investor's current age"),
         funding_amount: external_exports.number().min(100).describe("Lump sum investment in USD"),
@@ -23050,7 +23081,7 @@ function createMcpServer() {
     "project_savvly_monthly",
     {
       title: "Project Savvly Monthly Contributions",
-      description: "Retirement projection for monthly contributions to Savvly's Longevity Benefit Fund over a number of years. Returns payout amounts at milestone ages 80/85/90/95 with WITH-Savvly vs WITHOUT-Savvly cumulative totals, per-age breakdowns, and server-provided `_lower`/`_upper` range bounds. Use `_upper` as the central illustrative estimate and `_lower` to communicate downside. Suitable for retirement savings planning, annuity alternative comparison, and longevity benefit illustration. Supports an optional annual contribution increase and an optional early-withdrawal age. Disclaimers + per-field hints under `metadata`.",
+      description: "Retirement projection for monthly contributions to Savvly's Longevity Benefit Fund over a number of years. Returns payout amounts at milestone ages 80/85/90/95 with WITH-Savvly vs WITHOUT-Savvly cumulative totals, per-age breakdowns, and server-provided `_lower`/`_upper` range bounds. Use `_upper` as the central illustrative estimate and `_lower` to communicate downside. Suitable for retirement savings planning, annuity alternative comparison, and longevity benefit illustration. Supports an optional annual contribution increase and an optional early-withdrawal age. Disclaimers + per-field hints under `metadata`. " + DISCLOSURE_REQUIRED_TERSE,
       inputSchema: {
         current_age: external_exports.number().int().min(25).max(79).describe("Investor's current age"),
         monthly_amount: external_exports.number().min(10).describe("Monthly contribution in USD"),
@@ -23094,7 +23125,7 @@ function createMcpServer() {
     "project_retirement_with_savvly",
     {
       title: "Project Retirement Trajectory With Savvly",
-      description: "Full retirement simulation showing the projected savings trajectory WITH and WITHOUT a Savvly allocation across the planning horizon (current_age \u2192 life_expectancy). Returns `gap_score`, `possible_higher_monthly_paycheck`, a server-provided headline message, and a per-year `age_dependent_values[]` timeline. Disclaimers + per-field hints under `metadata`.",
+      description: "Full retirement simulation showing the projected savings trajectory WITH and WITHOUT a Savvly allocation across the planning horizon (current_age \u2192 life_expectancy). Returns `gap_score`, `possible_higher_monthly_paycheck`, a server-provided headline message, and a per-year `age_dependent_values[]` timeline. Disclaimers + per-field hints under `metadata`. " + DISCLOSURE_REQUIRED_TERSE,
       inputSchema: {
         current_age: external_exports.number().int().min(25).max(79).describe("Current age"),
         retirement_age: external_exports.number().int().min(50).max(80).describe("Planned retirement age"),