fdic-mcp-server 1.16.0 → 1.17.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.16.0" : process.env.npm_package_version ?? "0.0.0-dev";
+var VERSION = true ? "1.17.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;
@@ -32687,19 +32687,16 @@ Common filter examples:
   - Branches in a state: STALPBR:CA
   - Branches in a city: CITYBR:"Austin"
   - High-deposit branches: DEPSUMBR:[1000000 TO *]
-  - By metro area: MSANAMEBR:"Dallas-Fort Worth-Arlington"
+  - By metro area (MSA code): MSABR:19100
 
 Key returned fields:
   - YEAR: Report year (as of June 30)
   - CERT: FDIC Certificate Number
   - BRNUM: Branch number (0 = main office)
-  - UNINAME: Institution name
-  - NAMEFULL: Full branch name
+  - NAMEFULL: Branch or institution name
   - ADDRESBR, CITYBR, STALPBR, ZIPBR: Branch address
-  - CNTYBR: County
   - DEPSUMBR: Total deposits at branch ($thousands)
-  - MSABR: Metropolitan Statistical Area code
-  - MSANAMEBR: MSA name
+  - MSABR: Metropolitan Statistical Area code (numeric; 0 = non-MSA)
   - LATITUDE, LONGITUDE: Coordinates
 
 Args:
@@ -34640,7 +34637,7 @@ var CANONICAL_FIELDS = [
   "SC",
   "ASSTLT",
   "VOLIAB",
-  "BRWDMONY"
+  "OTHBRF"
 ].join(",");
 var FIELD_ALIASES = {
   IDT1CER: ["REPTE9"],
@@ -34717,7 +34714,7 @@ function extractCanonicalMetrics(raw) {
   const sc = asNumber(raw.SC);
   const asstlt = asNumber(raw.ASSTLT);
   const voliab = asNumber(raw.VOLIAB);
-  const brwdmony = asNumber(raw.BRWDMONY);
+  const othbrf = asNumber(raw.OTHBRF);
   const metrics = {
     // Amounts
     totalAssets: direct("totalAssets", "ASSET"),
@@ -34786,8 +34783,8 @@ function extractCanonicalMetrics(raw) {
     ),
     borrowedFundsToAssetsPct: derived(
       "borrowedFundsToAssetsPct",
-      () => safeDivPct(brwdmony, asset),
-      "BRWDMONY / ASSET * 100"
+      () => safeDivPct(othbrf, asset),
+      "OTHBRF / ASSET * 100"
     )
   };
   for (const [key, value] of Object.entries(metrics)) {
@@ -36678,7 +36675,6 @@ var CREDIT_FIELDS = [
   "LNCI",
   "LNCON",
   "LNAG",
-  "LNOTH",
   "LNREDOM",
   "LNREFOR"
 ].join(",");
@@ -37571,7 +37567,7 @@ function buildMarketConcentration(participants) {
 }
 
 // src/tools/marketShareAnalysis.ts
-var SOD_FIELDS = "CERT,UNINAME,DEPSUMBR,BRNUM,MSANAMEBR,CNTYBR,STALPBR,YEAR";
+var SOD_FIELDS = "CERT,NAMEFULL,DEPSUMBR,BRNUM,MSABR,STALPBR,YEAR";
 var SOD_FETCH_LIMIT = 1e4;
 function fmtNum(val) {
   return Math.round(val).toLocaleString("en-US");
@@ -37624,12 +37620,12 @@ function getDefaultSodYear() {
   return (/* @__PURE__ */ new Date()).getFullYear() - 1;
 }
 var MarketShareInputSchema = import_zod16.z.object({
-  msa: import_zod16.z.string().optional().describe(
-    'MSA name to filter (e.g., "Dallas-Fort Worth-Arlington"). Use MSANAMEBR field.'
+  msa: import_zod16.z.number().int().positive().optional().describe(
+    "FDIC MSABR numeric code for the Metropolitan Statistical Area (e.g., 19100 for Dallas-Fort Worth-Arlington, 42660 for Seattle-Tacoma-Bellevue). Use fdic_search_sod with MSABR to look up codes."
   ),
-  county: import_zod16.z.string().optional().describe('County name (e.g., "Travis"). Requires state.'),
+  city: import_zod16.z.string().optional().describe('City name (e.g., "Austin"). Requires state.'),
   state: import_zod16.z.string().length(2).optional().describe(
-    "Two-letter state abbreviation (e.g., TX). Required when using county filter."
+    "Two-letter state abbreviation (e.g., TX). Required when using city filter."
   ),
   year: import_zod16.z.number().int().min(1994).optional().describe("SOD report year (1994-present). Defaults to most recent."),
   cert: import_zod16.z.number().int().positive().optional().describe("Highlight a specific institution in the results.")
@@ -37639,17 +37635,21 @@ function registerMarketShareAnalysisTools(server) {
     "fdic_market_share_analysis",
     {
       title: "Deposit Market Share Analysis",
-      description: `Analyze deposit market share and concentration for an MSA or county market using FDIC Summary of Deposits (SOD) data.
+      description: `Analyze deposit market share and concentration for an MSA or city market using FDIC Summary of Deposits (SOD) data.
 
 Computes market share for all institutions in a geographic market, ranks them by deposits, and calculates the Herfindahl-Hirschman Index (HHI) for market concentration analysis per DOJ/FTC merger guidelines.
 
+Two entry modes:
+  - MSA market: provide msa as the numeric MSABR code (e.g., msa: 19100 for Dallas-Fort Worth-Arlington, msa: 42660 for Seattle-Tacoma-Bellevue). Use fdic_search_sod to look up MSABR codes.
+  - City market: provide city (branch city name, e.g., "Austin") and state (two-letter code, e.g., "TX").
+
 Output includes:
   - Market overview with total deposits, institution count, and HHI classification
-  - Optional highlighted institution showing rank and share
+  - Optional highlighted institution showing rank and share (provide cert)
   - Top institutions ranked by deposit market share
   - Structured JSON for programmatic consumption
 
-Requires at least one of: msa, or county + state.`,
+Requires at least one of: msa (numeric MSABR code), or city + state.`,
       inputSchema: MarketShareInputSchema,
       annotations: {
         readOnlyHint: true,
@@ -37663,17 +37663,17 @@ Requires at least one of: msa, or county + state.`,
       const timeoutId = setTimeout(() => controller.abort(), ANALYSIS_TIMEOUT_MS);
       const progressToken = extra._meta?.progressToken;
       try {
-        if (!rawParams.msa && !rawParams.county) {
+        if (!rawParams.msa && !rawParams.city) {
           return formatToolError(
             new Error(
-              "At least one of 'msa' or 'county' (with 'state') must be provided."
+              "At least one of 'msa' (numeric MSABR code) or 'city' (with 'state') must be provided."
             )
           );
         }
-        if (rawParams.county && !rawParams.state) {
+        if (rawParams.city && !rawParams.state) {
           return formatToolError(
             new Error(
-              "'state' is required when using 'county' filter."
+              "'state' is required when using 'city' filter."
             )
           );
         }
@@ -37681,11 +37681,11 @@ Requires at least one of: msa, or county + state.`,
         let filterStr;
         let marketName;
         if (rawParams.msa) {
-          filterStr = `MSANAMEBR:"${rawParams.msa}" AND YEAR:${year}`;
-          marketName = rawParams.msa;
+          filterStr = `MSABR:${rawParams.msa} AND YEAR:${year}`;
+          marketName = `MSA ${rawParams.msa}`;
         } else {
-          filterStr = `CNTYBR:"${rawParams.county}" AND STALPBR:${rawParams.state} AND YEAR:${year}`;
-          marketName = `${rawParams.county} County, ${rawParams.state}`;
+          filterStr = `CITYBR:"${rawParams.city}" AND STALPBR:${rawParams.state} AND YEAR:${year}`;
+          marketName = `${rawParams.city}, ${rawParams.state}`;
         }
         await sendProgressNotification(
           server.server,
@@ -37720,7 +37720,7 @@ Requires at least one of: msa, or county + state.`,
         );
         const branches = records.map((r) => ({
           cert: Number(r.CERT),
-          name: String(r.UNINAME ?? ""),
+          name: String(r.NAMEFULL ?? ""),
           deposits: typeof r.DEPSUMBR === "number" ? r.DEPSUMBR : 0
         }));
         const participants = computeMarketShare(branches);
@@ -37767,7 +37767,7 @@ Requires at least one of: msa, or county + state.`,
 
 // src/tools/franchiseFootprint.ts
 var import_zod17 = require("zod");
-var SOD_BRANCH_FIELDS = "CERT,UNINAME,DEPSUMBR,BRNUM,MSANAMEBR,CNTYBR,STALPBR,YEAR";
+var SOD_BRANCH_FIELDS = "CERT,NAMEFULL,DEPSUMBR,BRNUM,MSABR,STALPBR,YEAR";
 var SOD_FETCH_LIMIT2 = 1e4;
 var NON_MSA_LABEL = "Non-MSA / Rural";
 function fmtNum2(val) {
@@ -37889,7 +37889,7 @@ Branches outside MSAs are grouped under "Non-MSA / Rural".`,
         );
         const byMarket = /* @__PURE__ */ new Map();
         for (const rec of branchRecords) {
-          const msaName = typeof rec.MSANAMEBR === "string" && rec.MSANAMEBR.trim() !== "" ? rec.MSANAMEBR.trim() : NON_MSA_LABEL;
+          const msaName = typeof rec.MSABR === "number" && rec.MSABR !== 0 ? `MSA ${rec.MSABR}` : NON_MSA_LABEL;
           const deposits = typeof rec.DEPSUMBR === "number" ? rec.DEPSUMBR : 0;
           const existing = byMarket.get(msaName);
           if (existing) {

package/dist/server.js

@@ -46,7 +46,7 @@ var import_types = require("@modelcontextprotocol/sdk/types.js");
 var import_express2 = __toESM(require("express"));
 
 // src/constants.ts
-var VERSION = true ? "1.16.0" : process.env.npm_package_version ?? "0.0.0-dev";
+var VERSION = true ? "1.17.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;
@@ -32701,19 +32701,16 @@ Common filter examples:
   - Branches in a state: STALPBR:CA
   - Branches in a city: CITYBR:"Austin"
   - High-deposit branches: DEPSUMBR:[1000000 TO *]
-  - By metro area: MSANAMEBR:"Dallas-Fort Worth-Arlington"
+  - By metro area (MSA code): MSABR:19100
 
 Key returned fields:
   - YEAR: Report year (as of June 30)
   - CERT: FDIC Certificate Number
   - BRNUM: Branch number (0 = main office)
-  - UNINAME: Institution name
-  - NAMEFULL: Full branch name
+  - NAMEFULL: Branch or institution name
   - ADDRESBR, CITYBR, STALPBR, ZIPBR: Branch address
-  - CNTYBR: County
   - DEPSUMBR: Total deposits at branch ($thousands)
-  - MSABR: Metropolitan Statistical Area code
-  - MSANAMEBR: MSA name
+  - MSABR: Metropolitan Statistical Area code (numeric; 0 = non-MSA)
   - LATITUDE, LONGITUDE: Coordinates
 
 Args:
@@ -34654,7 +34651,7 @@ var CANONICAL_FIELDS = [
   "SC",
   "ASSTLT",
   "VOLIAB",
-  "BRWDMONY"
+  "OTHBRF"
 ].join(",");
 var FIELD_ALIASES = {
   IDT1CER: ["REPTE9"],
@@ -34731,7 +34728,7 @@ function extractCanonicalMetrics(raw) {
   const sc = asNumber(raw.SC);
   const asstlt = asNumber(raw.ASSTLT);
   const voliab = asNumber(raw.VOLIAB);
-  const brwdmony = asNumber(raw.BRWDMONY);
+  const othbrf = asNumber(raw.OTHBRF);
   const metrics = {
     // Amounts
     totalAssets: direct("totalAssets", "ASSET"),
@@ -34800,8 +34797,8 @@ function extractCanonicalMetrics(raw) {
     ),
     borrowedFundsToAssetsPct: derived(
       "borrowedFundsToAssetsPct",
-      () => safeDivPct(brwdmony, asset),
-      "BRWDMONY / ASSET * 100"
+      () => safeDivPct(othbrf, asset),
+      "OTHBRF / ASSET * 100"
     )
   };
   for (const [key, value] of Object.entries(metrics)) {
@@ -36692,7 +36689,6 @@ var CREDIT_FIELDS = [
   "LNCI",
   "LNCON",
   "LNAG",
-  "LNOTH",
   "LNREDOM",
   "LNREFOR"
 ].join(",");
@@ -37585,7 +37581,7 @@ function buildMarketConcentration(participants) {
 }
 
 // src/tools/marketShareAnalysis.ts
-var SOD_FIELDS = "CERT,UNINAME,DEPSUMBR,BRNUM,MSANAMEBR,CNTYBR,STALPBR,YEAR";
+var SOD_FIELDS = "CERT,NAMEFULL,DEPSUMBR,BRNUM,MSABR,STALPBR,YEAR";
 var SOD_FETCH_LIMIT = 1e4;
 function fmtNum(val) {
   return Math.round(val).toLocaleString("en-US");
@@ -37638,12 +37634,12 @@ function getDefaultSodYear() {
   return (/* @__PURE__ */ new Date()).getFullYear() - 1;
 }
 var MarketShareInputSchema = import_zod16.z.object({
-  msa: import_zod16.z.string().optional().describe(
-    'MSA name to filter (e.g., "Dallas-Fort Worth-Arlington"). Use MSANAMEBR field.'
+  msa: import_zod16.z.number().int().positive().optional().describe(
+    "FDIC MSABR numeric code for the Metropolitan Statistical Area (e.g., 19100 for Dallas-Fort Worth-Arlington, 42660 for Seattle-Tacoma-Bellevue). Use fdic_search_sod with MSABR to look up codes."
   ),
-  county: import_zod16.z.string().optional().describe('County name (e.g., "Travis"). Requires state.'),
+  city: import_zod16.z.string().optional().describe('City name (e.g., "Austin"). Requires state.'),
   state: import_zod16.z.string().length(2).optional().describe(
-    "Two-letter state abbreviation (e.g., TX). Required when using county filter."
+    "Two-letter state abbreviation (e.g., TX). Required when using city filter."
   ),
   year: import_zod16.z.number().int().min(1994).optional().describe("SOD report year (1994-present). Defaults to most recent."),
   cert: import_zod16.z.number().int().positive().optional().describe("Highlight a specific institution in the results.")
@@ -37653,17 +37649,21 @@ function registerMarketShareAnalysisTools(server) {
     "fdic_market_share_analysis",
     {
       title: "Deposit Market Share Analysis",
-      description: `Analyze deposit market share and concentration for an MSA or county market using FDIC Summary of Deposits (SOD) data.
+      description: `Analyze deposit market share and concentration for an MSA or city market using FDIC Summary of Deposits (SOD) data.
 
 Computes market share for all institutions in a geographic market, ranks them by deposits, and calculates the Herfindahl-Hirschman Index (HHI) for market concentration analysis per DOJ/FTC merger guidelines.
 
+Two entry modes:
+  - MSA market: provide msa as the numeric MSABR code (e.g., msa: 19100 for Dallas-Fort Worth-Arlington, msa: 42660 for Seattle-Tacoma-Bellevue). Use fdic_search_sod to look up MSABR codes.
+  - City market: provide city (branch city name, e.g., "Austin") and state (two-letter code, e.g., "TX").
+
 Output includes:
   - Market overview with total deposits, institution count, and HHI classification
-  - Optional highlighted institution showing rank and share
+  - Optional highlighted institution showing rank and share (provide cert)
   - Top institutions ranked by deposit market share
   - Structured JSON for programmatic consumption
 
-Requires at least one of: msa, or county + state.`,
+Requires at least one of: msa (numeric MSABR code), or city + state.`,
       inputSchema: MarketShareInputSchema,
       annotations: {
         readOnlyHint: true,
@@ -37677,17 +37677,17 @@ Requires at least one of: msa, or county + state.`,
       const timeoutId = setTimeout(() => controller.abort(), ANALYSIS_TIMEOUT_MS);
       const progressToken = extra._meta?.progressToken;
       try {
-        if (!rawParams.msa && !rawParams.county) {
+        if (!rawParams.msa && !rawParams.city) {
           return formatToolError(
             new Error(
-              "At least one of 'msa' or 'county' (with 'state') must be provided."
+              "At least one of 'msa' (numeric MSABR code) or 'city' (with 'state') must be provided."
             )
           );
         }
-        if (rawParams.county && !rawParams.state) {
+        if (rawParams.city && !rawParams.state) {
           return formatToolError(
             new Error(
-              "'state' is required when using 'county' filter."
+              "'state' is required when using 'city' filter."
             )
           );
         }
@@ -37695,11 +37695,11 @@ Requires at least one of: msa, or county + state.`,
         let filterStr;
         let marketName;
         if (rawParams.msa) {
-          filterStr = `MSANAMEBR:"${rawParams.msa}" AND YEAR:${year}`;
-          marketName = rawParams.msa;
+          filterStr = `MSABR:${rawParams.msa} AND YEAR:${year}`;
+          marketName = `MSA ${rawParams.msa}`;
         } else {
-          filterStr = `CNTYBR:"${rawParams.county}" AND STALPBR:${rawParams.state} AND YEAR:${year}`;
-          marketName = `${rawParams.county} County, ${rawParams.state}`;
+          filterStr = `CITYBR:"${rawParams.city}" AND STALPBR:${rawParams.state} AND YEAR:${year}`;
+          marketName = `${rawParams.city}, ${rawParams.state}`;
         }
         await sendProgressNotification(
           server.server,
@@ -37734,7 +37734,7 @@ Requires at least one of: msa, or county + state.`,
         );
         const branches = records.map((r) => ({
           cert: Number(r.CERT),
-          name: String(r.UNINAME ?? ""),
+          name: String(r.NAMEFULL ?? ""),
           deposits: typeof r.DEPSUMBR === "number" ? r.DEPSUMBR : 0
         }));
         const participants = computeMarketShare(branches);
@@ -37781,7 +37781,7 @@ Requires at least one of: msa, or county + state.`,
 
 // src/tools/franchiseFootprint.ts
 var import_zod17 = require("zod");
-var SOD_BRANCH_FIELDS = "CERT,UNINAME,DEPSUMBR,BRNUM,MSANAMEBR,CNTYBR,STALPBR,YEAR";
+var SOD_BRANCH_FIELDS = "CERT,NAMEFULL,DEPSUMBR,BRNUM,MSABR,STALPBR,YEAR";
 var SOD_FETCH_LIMIT2 = 1e4;
 var NON_MSA_LABEL = "Non-MSA / Rural";
 function fmtNum2(val) {
@@ -37903,7 +37903,7 @@ Branches outside MSAs are grouped under "Non-MSA / Rural".`,
         );
         const byMarket = /* @__PURE__ */ new Map();
         for (const rec of branchRecords) {
-          const msaName = typeof rec.MSANAMEBR === "string" && rec.MSANAMEBR.trim() !== "" ? rec.MSANAMEBR.trim() : NON_MSA_LABEL;
+          const msaName = typeof rec.MSABR === "number" && rec.MSABR !== 0 ? `MSA ${rec.MSABR}` : NON_MSA_LABEL;
           const deposits = typeof rec.DEPSUMBR === "number" ? rec.DEPSUMBR : 0;
           const existing = byMarket.get(msaName);
           if (existing) {

package/package.json

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