fdic-mcp-server 1.27.0 → 1.29.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.27.0" : process.env.npm_package_version ?? "0.0.0-dev";
+var VERSION = true ? "1.29.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");
@@ -32114,6 +32130,13 @@ var PeerHealthProxySummarySchema = import_zod2.z.object({
     gaps: import_zod2.z.array(import_zod2.z.string())
   })
 });
+var DeprecationNoticeSchema = import_zod2.z.object({
+  path: import_zod2.z.string(),
+  status: import_zod2.z.literal("deprecated"),
+  replacement: import_zod2.z.string(),
+  removal_target: import_zod2.z.literal("future_major_release"),
+  note: 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"),
@@ -32127,6 +32150,7 @@ var FdicPeerHealthOutputSchema = import_zod2.z.object({
   subject_rank: import_zod2.z.number().int().nullable(),
   metrics: import_zod2.z.array(PeerHealthMetricRowSchema),
   institutions: import_zod2.z.array(PeerHealthInstitutionSchema),
+  deprecations: import_zod2.z.array(DeprecationNoticeSchema),
   peer_context: import_zod2.z.object({
     peer_count: import_zod2.z.number().int(),
     peer_definition: import_zod2.z.string(),
@@ -35912,6 +35936,15 @@ function computePeerStats(subjectValue, peerValues, options) {
 }
 
 // src/tools/peerHealth.ts
+var PEER_HEALTH_DEPRECATIONS = [
+  {
+    path: "peer_context.subject_percentiles",
+    status: "deprecated",
+    replacement: "metrics",
+    removal_target: "future_major_release",
+    note: "Use metrics[] for new subject-vs-peer UI bindings. The legacy camelCase percentile map remains for backward compatibility until a coordinated major release."
+  }
+];
 var PEER_METRICS = [
   // legacyKey preserves the original camelCase peer_context map keys for backward compatibility.
   // New UI consumers should bind to the flat metrics[].name snake_case values instead.
@@ -35998,7 +36031,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_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.
+Output: structuredContent includes {model, official_status, report_date, institutions, metrics, peer_context, proxy_summary, proxy, deprecations}. Institutions include proxy scores and name_source. When a subject cert is provided, metrics[] is the preferred subject-vs-peer array for new UI bindings and proxy_summary is a flattened subject proxy. peer_context.subject_percentiles is deprecated, remains for backward compatibility, and is targeted for removal only in a future coordinated major release. 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,
@@ -36396,7 +36429,8 @@ NOTE: Public off-site analytical proxy \u2014 not official supervisory ratings.`
             subject_rank: subjectRank,
             metrics: metricRows,
             institutions: returned,
-            peer_context: peerContext
+            peer_context: peerContext,
+            deprecations: PEER_HEALTH_DEPRECATIONS
           }
         };
       } catch (err) {

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.27.0" : process.env.npm_package_version ?? "0.0.0-dev";
+var VERSION = true ? "1.29.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");
@@ -32129,6 +32145,13 @@ var PeerHealthProxySummarySchema = import_zod2.z.object({
     gaps: import_zod2.z.array(import_zod2.z.string())
   })
 });
+var DeprecationNoticeSchema = import_zod2.z.object({
+  path: import_zod2.z.string(),
+  status: import_zod2.z.literal("deprecated"),
+  replacement: import_zod2.z.string(),
+  removal_target: import_zod2.z.literal("future_major_release"),
+  note: 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"),
@@ -32142,6 +32165,7 @@ var FdicPeerHealthOutputSchema = import_zod2.z.object({
   subject_rank: import_zod2.z.number().int().nullable(),
   metrics: import_zod2.z.array(PeerHealthMetricRowSchema),
   institutions: import_zod2.z.array(PeerHealthInstitutionSchema),
+  deprecations: import_zod2.z.array(DeprecationNoticeSchema),
   peer_context: import_zod2.z.object({
     peer_count: import_zod2.z.number().int(),
     peer_definition: import_zod2.z.string(),
@@ -35927,6 +35951,15 @@ function computePeerStats(subjectValue, peerValues, options) {
 }
 
 // src/tools/peerHealth.ts
+var PEER_HEALTH_DEPRECATIONS = [
+  {
+    path: "peer_context.subject_percentiles",
+    status: "deprecated",
+    replacement: "metrics",
+    removal_target: "future_major_release",
+    note: "Use metrics[] for new subject-vs-peer UI bindings. The legacy camelCase percentile map remains for backward compatibility until a coordinated major release."
+  }
+];
 var PEER_METRICS = [
   // legacyKey preserves the original camelCase peer_context map keys for backward compatibility.
   // New UI consumers should bind to the flat metrics[].name snake_case values instead.
@@ -36013,7 +36046,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_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.
+Output: structuredContent includes {model, official_status, report_date, institutions, metrics, peer_context, proxy_summary, proxy, deprecations}. Institutions include proxy scores and name_source. When a subject cert is provided, metrics[] is the preferred subject-vs-peer array for new UI bindings and proxy_summary is a flattened subject proxy. peer_context.subject_percentiles is deprecated, remains for backward compatibility, and is targeted for removal only in a future coordinated major release. 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,
@@ -36411,7 +36444,8 @@ NOTE: Public off-site analytical proxy \u2014 not official supervisory ratings.`
             subject_rank: subjectRank,
             metrics: metricRows,
             institutions: returned,
-            peer_context: peerContext
+            peer_context: peerContext,
+            deprecations: PEER_HEALTH_DEPRECATIONS
           }
         };
       } catch (err) {

package/package.json

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