FDIC BankFind MCP Server

Instructions

Implementation Reference

• src/tools/failures.ts:96-155 (handler)

  Registration and implementation of the 'fdic_get_institution_failure' tool, which queries the FDIC failures endpoint by certificate number.

    server.registerTool(
      "fdic_get_institution_failure",
      {
        title: "Get Failure Details by Certificate Number",
        description: `Retrieve failure details for a specific institution by FDIC Certificate Number.
  
  Use this when you know the CERT of a failed institution to get its specific failure record.
  
  Args:
    - cert (number): FDIC Certificate Number of the failed institution
    - fields (string, optional): Comma-separated list of fields to return
  
  Returns detailed failure information suitable for concise summaries, with structured fields available for exact values when needed.`,
        inputSchema: CertSchema,
        annotations: {
          readOnlyHint: true,
          destructiveHint: false,
          idempotentHint: true,
          openWorldHint: false,
        },
      },
      async ({ cert, fields }) => {
        try {
          const response = await queryEndpoint(ENDPOINTS.FAILURES, {
            filters: `CERT:${cert}`,
            fields,
            limit: 1,
          });
          const records = extractRecords(response);
          if (records.length === 0) {
            const output = {
              found: false,
              cert,
              message: `No failure record found for CERT ${cert}. The institution may not have failed, or the CERT may be incorrect.`,
            };
            return {
              content: [{ type: "text", text: output.message }],
              structuredContent: output,
            };
          }
          const output = records[0];
          const text = formatLookupResultText("Failure details", output, [
            "CERT",
            "NAME",
            "FAILDATE",
            "RESTYPE",
            "COST",
            "QBFASSET",
            "CITY",
            "STALP",
          ]);
          return {
            content: [{ type: "text", text }],
            structuredContent: output,
          };
        } catch (err) {
          return formatToolError(err);
        }
      },
    );