fdic-mcp-server 1.26.0 → 1.28.0

package/dist/index.js

@@ -32,7 +32,7 @@ var import_types = require("@modelcontextprotocol/sdk/types.js");
 var import_express2 = __toESM(require("express"));
 
 // src/constants.ts
-var VERSION = true ? "1.26.0" : process.env.npm_package_version ?? "0.0.0-dev";
+var VERSION = true ? "1.28.0" : process.env.npm_package_version ?? "0.0.0-dev";
 var FDIC_API_BASE_URL = "https://banks.data.fdic.gov/api";
 var CHARACTER_LIMIT = 5e4;
 var DEFAULT_FDIC_MAX_RESPONSE_BYTES = 5 * 1024 * 1024;
@@ -31963,6 +31963,21 @@ var CertSchema = import_zod.z.object({
 // src/schemas/output.ts
 var import_zod2 = require("zod");
 var FdicRecord = import_zod2.z.record(import_zod2.z.unknown());
+var FdicFinancialRecord = import_zod2.z.object({
+  CERT: import_zod2.z.number().int().optional(),
+  NAME: import_zod2.z.string().optional(),
+  REPDTE: import_zod2.z.union([import_zod2.z.string(), import_zod2.z.number()]).optional(),
+  ASSET: import_zod2.z.number().optional(),
+  DEP: import_zod2.z.number().optional(),
+  NETINC: import_zod2.z.number().optional(),
+  ROA: import_zod2.z.number().optional(),
+  ROE: import_zod2.z.number().optional(),
+  IDT1CER: import_zod2.z.number().optional(),
+  NCLNLSR: import_zod2.z.number().optional(),
+  LNLSDEPR: import_zod2.z.number().optional(),
+  NIMY: import_zod2.z.number().optional(),
+  EEFFR: import_zod2.z.number().optional()
+}).passthrough();
 var Pagination = {
   total: import_zod2.z.number().int(),
   offset: import_zod2.z.number().int(),
@@ -31970,10 +31985,10 @@ var Pagination = {
   has_more: import_zod2.z.boolean(),
   next_offset: import_zod2.z.number().int().optional()
 };
-function paginatedSearchSchema(recordKey) {
+function paginatedSearchSchema(recordKey, recordSchema = FdicRecord) {
   return import_zod2.z.object({
     ...Pagination,
-    [recordKey]: import_zod2.z.array(FdicRecord),
+    [recordKey]: import_zod2.z.array(recordSchema),
     truncated: import_zod2.z.boolean().optional()
   });
 }
@@ -31984,7 +31999,8 @@ var FdicFailuresSearchOutputSchema = paginatedSearchSchema("failures");
 var FdicLocationsSearchOutputSchema = paginatedSearchSchema("locations");
 var FdicHistorySearchOutputSchema = paginatedSearchSchema("events");
 var FdicFinancialsSearchOutputSchema = paginatedSearchSchema(
-  "financials"
+  "financials",
+  FdicFinancialRecord
 );
 var FdicSummarySearchOutputSchema = paginatedSearchSchema("summary");
 var FdicSodSearchOutputSchema = paginatedSearchSchema("deposits");
@@ -32078,10 +32094,47 @@ var PeerHealthInstitutionSchema = import_zod2.z.object({
   component_ratings: import_zod2.z.record(import_zod2.z.number()),
   flags: import_zod2.z.array(import_zod2.z.string())
 });
+var PeerHealthProxySummarySchema = import_zod2.z.object({
+  model: import_zod2.z.literal("public_camels_proxy_v1"),
+  official_status: import_zod2.z.literal("public off-site proxy, not official CAMELS"),
+  score: import_zod2.z.number(),
+  band: import_zod2.z.string(),
+  components: import_zod2.z.array(
+    import_zod2.z.object({
+      name: import_zod2.z.string(),
+      label: import_zod2.z.string(),
+      score: import_zod2.z.number(),
+      legacy_rating: import_zod2.z.number(),
+      legacy_label: import_zod2.z.string(),
+      flags: import_zod2.z.array(import_zod2.z.string())
+    })
+  ),
+  capital_classification: import_zod2.z.object({
+    category: import_zod2.z.string(),
+    label: import_zod2.z.string(),
+    binding_constraint: import_zod2.z.string().nullable(),
+    ratios_used: import_zod2.z.record(import_zod2.z.number().nullable())
+  }),
+  management_overlay: import_zod2.z.object({
+    level: import_zod2.z.string(),
+    caps_band: import_zod2.z.boolean(),
+    reason_codes: import_zod2.z.array(import_zod2.z.string())
+  }),
+  risk_signal_count: import_zod2.z.number().int(),
+  risk_signal_severities: import_zod2.z.record(import_zod2.z.number().int()),
+  trend_count: import_zod2.z.number().int(),
+  data_quality: import_zod2.z.object({
+    report_date: import_zod2.z.string(),
+    staleness: import_zod2.z.string(),
+    gaps_count: import_zod2.z.number().int(),
+    gaps: import_zod2.z.array(import_zod2.z.string())
+  })
+});
 var FdicPeerHealthOutputSchema = import_zod2.z.object({
   model: import_zod2.z.literal("public_camels_proxy_v1"),
   official_status: import_zod2.z.literal("public off-site proxy, not official CAMELS"),
   proxy: import_zod2.z.unknown().nullable(),
+  proxy_summary: PeerHealthProxySummarySchema.nullable(),
   report_date: import_zod2.z.string(),
   sort_by: import_zod2.z.string(),
   total_institutions: import_zod2.z.number().int(),
@@ -35884,6 +35937,49 @@ var PEER_METRICS = [
   { key: "efficiencyRatioPct", legacyKey: "efficiencyRatioPct", name: "efficiency_ratio_pct", label: "Efficiency ratio", higherIsBetter: false },
   { key: "loanToDepositPct", legacyKey: "loanToDepositPct", name: "loan_to_deposit_pct", label: "Loan-to-deposit ratio", higherIsBetter: false }
 ];
+function buildProxySummary(proxy) {
+  if (!proxy) return null;
+  const componentEntries = [
+    { name: "capital", assessment: proxy.component_assessment.capital },
+    { name: "asset_quality", assessment: proxy.component_assessment.asset_quality },
+    { name: "earnings", assessment: proxy.component_assessment.earnings },
+    { name: "liquidity_funding", assessment: proxy.component_assessment.liquidity_funding },
+    { name: "sensitivity_proxy", assessment: proxy.component_assessment.sensitivity_proxy }
+  ];
+  const riskSignalSeverities = {};
+  for (const signal of proxy.risk_signals) {
+    riskSignalSeverities[signal.severity] = (riskSignalSeverities[signal.severity] ?? 0) + 1;
+  }
+  return {
+    model: proxy.model,
+    official_status: proxy.official_status,
+    score: proxy.overall.score,
+    band: proxy.overall.band,
+    components: componentEntries.map(({ name, assessment }) => ({
+      name,
+      label: assessment.label,
+      score: assessment.score,
+      legacy_rating: assessment.legacy_rating,
+      legacy_label: assessment.legacy_label,
+      flags: assessment.flags
+    })),
+    capital_classification: {
+      category: proxy.capital_classification.category,
+      label: proxy.capital_classification.label,
+      binding_constraint: proxy.capital_classification.binding_constraint ?? null,
+      ratios_used: proxy.capital_classification.ratios_used
+    },
+    management_overlay: {
+      level: proxy.management_overlay.level,
+      caps_band: proxy.management_overlay.caps_band,
+      reason_codes: proxy.management_overlay.reason_codes
+    },
+    risk_signal_count: proxy.risk_signals.length,
+    risk_signal_severities: riskSignalSeverities,
+    trend_count: proxy.trend_insights.length,
+    data_quality: proxy.data_quality
+  };
+}
 var PeerHealthInputSchema = import_zod11.z.object({
   cert: import_zod11.z.number().int().positive().optional().describe("Subject institution CERT to highlight in the ranking. Optional."),
   certs: import_zod11.z.array(import_zod11.z.number().int().positive()).max(50).optional().describe("Explicit list of CERTs to compare (max 50)."),
@@ -35918,7 +36014,7 @@ Three usage modes:
 
 Optionally provide cert to highlight a subject institution's position in the ranking.
 
-Output: structuredContent includes {model, official_status, report_date, institutions, metrics, peer_context, proxy}. Institutions include proxy scores and name_source. When a subject cert is provided, metrics is a flat subject-vs-peer array for UI binding while peer_context preserves the legacy nested percentiles and weighted averages. Auto-peer selection derives asset bands from report-date financials and broadens the cohort if fewer than 10 peers match.
+Output: structuredContent includes {model, official_status, report_date, institutions, metrics, peer_context, proxy_summary, proxy}. Institutions include proxy scores and name_source. When a subject cert is provided, metrics is a flat subject-vs-peer array and proxy_summary is a flattened subject proxy for UI binding while peer_context and proxy preserve the legacy detailed payloads. Auto-peer selection derives asset bands from report-date financials and broadens the cohort if fewer than 10 peers match.
 
 NOTE: Public off-site analytical proxy \u2014 not official supervisory ratings.`,
       inputSchema: PeerHealthInputSchema,
@@ -36307,6 +36403,7 @@ NOTE: Public off-site analytical proxy \u2014 not official supervisory ratings.`
             model: "public_camels_proxy_v1",
             official_status: "public off-site proxy, not official CAMELS",
             proxy: subjectProxy,
+            proxy_summary: buildProxySummary(subjectProxy),
             report_date: params.repdte,
             sort_by: params.sort_by,
             total_institutions: entries.length,

package/dist/server.js

@@ -47,7 +47,7 @@ var import_types = require("@modelcontextprotocol/sdk/types.js");
 var import_express2 = __toESM(require("express"));
 
 // src/constants.ts
-var VERSION = true ? "1.26.0" : process.env.npm_package_version ?? "0.0.0-dev";
+var VERSION = true ? "1.28.0" : process.env.npm_package_version ?? "0.0.0-dev";
 var FDIC_API_BASE_URL = "https://banks.data.fdic.gov/api";
 var CHARACTER_LIMIT = 5e4;
 var DEFAULT_FDIC_MAX_RESPONSE_BYTES = 5 * 1024 * 1024;
@@ -31978,6 +31978,21 @@ var CertSchema = import_zod.z.object({
 // src/schemas/output.ts
 var import_zod2 = require("zod");
 var FdicRecord = import_zod2.z.record(import_zod2.z.unknown());
+var FdicFinancialRecord = import_zod2.z.object({
+  CERT: import_zod2.z.number().int().optional(),
+  NAME: import_zod2.z.string().optional(),
+  REPDTE: import_zod2.z.union([import_zod2.z.string(), import_zod2.z.number()]).optional(),
+  ASSET: import_zod2.z.number().optional(),
+  DEP: import_zod2.z.number().optional(),
+  NETINC: import_zod2.z.number().optional(),
+  ROA: import_zod2.z.number().optional(),
+  ROE: import_zod2.z.number().optional(),
+  IDT1CER: import_zod2.z.number().optional(),
+  NCLNLSR: import_zod2.z.number().optional(),
+  LNLSDEPR: import_zod2.z.number().optional(),
+  NIMY: import_zod2.z.number().optional(),
+  EEFFR: import_zod2.z.number().optional()
+}).passthrough();
 var Pagination = {
   total: import_zod2.z.number().int(),
   offset: import_zod2.z.number().int(),
@@ -31985,10 +32000,10 @@ var Pagination = {
   has_more: import_zod2.z.boolean(),
   next_offset: import_zod2.z.number().int().optional()
 };
-function paginatedSearchSchema(recordKey) {
+function paginatedSearchSchema(recordKey, recordSchema = FdicRecord) {
   return import_zod2.z.object({
     ...Pagination,
-    [recordKey]: import_zod2.z.array(FdicRecord),
+    [recordKey]: import_zod2.z.array(recordSchema),
     truncated: import_zod2.z.boolean().optional()
   });
 }
@@ -31999,7 +32014,8 @@ var FdicFailuresSearchOutputSchema = paginatedSearchSchema("failures");
 var FdicLocationsSearchOutputSchema = paginatedSearchSchema("locations");
 var FdicHistorySearchOutputSchema = paginatedSearchSchema("events");
 var FdicFinancialsSearchOutputSchema = paginatedSearchSchema(
-  "financials"
+  "financials",
+  FdicFinancialRecord
 );
 var FdicSummarySearchOutputSchema = paginatedSearchSchema("summary");
 var FdicSodSearchOutputSchema = paginatedSearchSchema("deposits");
@@ -32093,10 +32109,47 @@ var PeerHealthInstitutionSchema = import_zod2.z.object({
   component_ratings: import_zod2.z.record(import_zod2.z.number()),
   flags: import_zod2.z.array(import_zod2.z.string())
 });
+var PeerHealthProxySummarySchema = import_zod2.z.object({
+  model: import_zod2.z.literal("public_camels_proxy_v1"),
+  official_status: import_zod2.z.literal("public off-site proxy, not official CAMELS"),
+  score: import_zod2.z.number(),
+  band: import_zod2.z.string(),
+  components: import_zod2.z.array(
+    import_zod2.z.object({
+      name: import_zod2.z.string(),
+      label: import_zod2.z.string(),
+      score: import_zod2.z.number(),
+      legacy_rating: import_zod2.z.number(),
+      legacy_label: import_zod2.z.string(),
+      flags: import_zod2.z.array(import_zod2.z.string())
+    })
+  ),
+  capital_classification: import_zod2.z.object({
+    category: import_zod2.z.string(),
+    label: import_zod2.z.string(),
+    binding_constraint: import_zod2.z.string().nullable(),
+    ratios_used: import_zod2.z.record(import_zod2.z.number().nullable())
+  }),
+  management_overlay: import_zod2.z.object({
+    level: import_zod2.z.string(),
+    caps_band: import_zod2.z.boolean(),
+    reason_codes: import_zod2.z.array(import_zod2.z.string())
+  }),
+  risk_signal_count: import_zod2.z.number().int(),
+  risk_signal_severities: import_zod2.z.record(import_zod2.z.number().int()),
+  trend_count: import_zod2.z.number().int(),
+  data_quality: import_zod2.z.object({
+    report_date: import_zod2.z.string(),
+    staleness: import_zod2.z.string(),
+    gaps_count: import_zod2.z.number().int(),
+    gaps: import_zod2.z.array(import_zod2.z.string())
+  })
+});
 var FdicPeerHealthOutputSchema = import_zod2.z.object({
   model: import_zod2.z.literal("public_camels_proxy_v1"),
   official_status: import_zod2.z.literal("public off-site proxy, not official CAMELS"),
   proxy: import_zod2.z.unknown().nullable(),
+  proxy_summary: PeerHealthProxySummarySchema.nullable(),
   report_date: import_zod2.z.string(),
   sort_by: import_zod2.z.string(),
   total_institutions: import_zod2.z.number().int(),
@@ -35899,6 +35952,49 @@ var PEER_METRICS = [
   { key: "efficiencyRatioPct", legacyKey: "efficiencyRatioPct", name: "efficiency_ratio_pct", label: "Efficiency ratio", higherIsBetter: false },
   { key: "loanToDepositPct", legacyKey: "loanToDepositPct", name: "loan_to_deposit_pct", label: "Loan-to-deposit ratio", higherIsBetter: false }
 ];
+function buildProxySummary(proxy) {
+  if (!proxy) return null;
+  const componentEntries = [
+    { name: "capital", assessment: proxy.component_assessment.capital },
+    { name: "asset_quality", assessment: proxy.component_assessment.asset_quality },
+    { name: "earnings", assessment: proxy.component_assessment.earnings },
+    { name: "liquidity_funding", assessment: proxy.component_assessment.liquidity_funding },
+    { name: "sensitivity_proxy", assessment: proxy.component_assessment.sensitivity_proxy }
+  ];
+  const riskSignalSeverities = {};
+  for (const signal of proxy.risk_signals) {
+    riskSignalSeverities[signal.severity] = (riskSignalSeverities[signal.severity] ?? 0) + 1;
+  }
+  return {
+    model: proxy.model,
+    official_status: proxy.official_status,
+    score: proxy.overall.score,
+    band: proxy.overall.band,
+    components: componentEntries.map(({ name, assessment }) => ({
+      name,
+      label: assessment.label,
+      score: assessment.score,
+      legacy_rating: assessment.legacy_rating,
+      legacy_label: assessment.legacy_label,
+      flags: assessment.flags
+    })),
+    capital_classification: {
+      category: proxy.capital_classification.category,
+      label: proxy.capital_classification.label,
+      binding_constraint: proxy.capital_classification.binding_constraint ?? null,
+      ratios_used: proxy.capital_classification.ratios_used
+    },
+    management_overlay: {
+      level: proxy.management_overlay.level,
+      caps_band: proxy.management_overlay.caps_band,
+      reason_codes: proxy.management_overlay.reason_codes
+    },
+    risk_signal_count: proxy.risk_signals.length,
+    risk_signal_severities: riskSignalSeverities,
+    trend_count: proxy.trend_insights.length,
+    data_quality: proxy.data_quality
+  };
+}
 var PeerHealthInputSchema = import_zod11.z.object({
   cert: import_zod11.z.number().int().positive().optional().describe("Subject institution CERT to highlight in the ranking. Optional."),
   certs: import_zod11.z.array(import_zod11.z.number().int().positive()).max(50).optional().describe("Explicit list of CERTs to compare (max 50)."),
@@ -35933,7 +36029,7 @@ Three usage modes:
 
 Optionally provide cert to highlight a subject institution's position in the ranking.
 
-Output: structuredContent includes {model, official_status, report_date, institutions, metrics, peer_context, proxy}. Institutions include proxy scores and name_source. When a subject cert is provided, metrics is a flat subject-vs-peer array for UI binding while peer_context preserves the legacy nested percentiles and weighted averages. Auto-peer selection derives asset bands from report-date financials and broadens the cohort if fewer than 10 peers match.
+Output: structuredContent includes {model, official_status, report_date, institutions, metrics, peer_context, proxy_summary, proxy}. Institutions include proxy scores and name_source. When a subject cert is provided, metrics is a flat subject-vs-peer array and proxy_summary is a flattened subject proxy for UI binding while peer_context and proxy preserve the legacy detailed payloads. Auto-peer selection derives asset bands from report-date financials and broadens the cohort if fewer than 10 peers match.
 
 NOTE: Public off-site analytical proxy \u2014 not official supervisory ratings.`,
       inputSchema: PeerHealthInputSchema,
@@ -36322,6 +36418,7 @@ NOTE: Public off-site analytical proxy \u2014 not official supervisory ratings.`
             model: "public_camels_proxy_v1",
             official_status: "public off-site proxy, not official CAMELS",
             proxy: subjectProxy,
+            proxy_summary: buildProxySummary(subjectProxy),
             report_date: params.repdte,
             sort_by: params.sort_by,
             total_institutions: entries.length,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fdic-mcp-server",
-  "version": "1.26.0",
+  "version": "1.28.0",
   "description": "MCP server for the FDIC BankFind Suite API",
   "mcpName": "io.github.jflamb/fdic-mcp-server",
   "main": "dist/server.js",