Get Failure Details by Certificate Number
fdic_get_institution_failureRead-onlyIdempotent
Retrieve failure details for FDIC-insured institutions using their certificate number to access specific failure records and structured data.
Instructions
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.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cert | Yes | FDIC Certificate Number — the unique identifier for an institution | |
| fields | No | Comma-separated list of fields to return |
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); } }, );