@cyanheads/fema-mcp-server 0.1.1

package/dist/mcp-server/resources/definitions/fema-disaster.resource.js

@@ -0,0 +1,59 @@
+/**
+ * @fileoverview Resource: fema://disaster/{disasterNumber} — disaster declaration summary.
+ * @module mcp-server/resources/definitions/fema-disaster
+ */
+import { resource, z } from '@cyanheads/mcp-ts-core';
+import { notFound } from '@cyanheads/mcp-ts-core/errors';
+import { getOpenFemaService } from '../../../services/openfema/openfema-service.js';
+export const femaDisasterResource = resource('fema://disaster/{disasterNumber}', {
+    name: 'FEMA Disaster Declaration',
+    description: 'Summary for a specific FEMA disaster declaration — title, state, incident type, ' +
+        'programs declared (IA/PA/HM), incident period, and designated area count. ' +
+        'Read-once context injection for agents already holding a disaster number.',
+    params: z.object({
+        disasterNumber: z
+            .string()
+            .describe('FEMA disaster number as a string (e.g., "4781"). Obtain from fema_search_disasters.'),
+    }),
+    async handler(params, ctx) {
+        const num = parseInt(params.disasterNumber, 10);
+        if (Number.isNaN(num) || num <= 0) {
+            throw notFound(`Invalid disaster number "${params.disasterNumber}". Expected a positive integer.`, { disasterNumber: params.disasterNumber });
+        }
+        const svc = getOpenFemaService();
+        const { rows } = await svc.fetchDisasters({
+            filter: `disasterNumber eq ${num}`,
+            select: 'disasterNumber,declarationTitle,state,incidentType,declarationType,' +
+                'declarationDate,incidentBeginDate,incidentEndDate,' +
+                'iaProgramDeclared,paProgramDeclared,hmProgramDeclared',
+            top: 500,
+        }, ctx);
+        if (rows.length === 0) {
+            throw notFound(`Disaster number ${num} not found in FEMA records.`, { disasterNumber: num });
+        }
+        // biome-ignore lint/style/noNonNullAssertion: rows.length === 0 checked above via notFound throw
+        const first = rows[0];
+        const programs = [];
+        if (first.iaProgramDeclared)
+            programs.push('IA');
+        if (first.paProgramDeclared)
+            programs.push('PA');
+        if (first.hmProgramDeclared)
+            programs.push('HM');
+        const summary = {
+            disaster_number: first.disasterNumber ?? num,
+            title: first.declarationTitle ?? 'Unknown',
+            state: first.state ?? '',
+            incident_type: first.incidentType ?? '',
+            declaration_type: first.declarationType ?? '',
+            declaration_date: first.declarationDate ?? '',
+            incident_begin_date: first.incidentBeginDate,
+            incident_end_date: first.incidentEndDate,
+            programs_declared: programs,
+            designated_area_count: rows.length,
+        };
+        ctx.log.info('Disaster resource fetched', { disasterNumber: num });
+        return summary;
+    },
+});
+//# sourceMappingURL=fema-disaster.resource.js.map

package/dist/mcp-server/resources/definitions/fema-disaster.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fema-disaster.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/fema-disaster.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAE7E,MAAM,CAAC,MAAM,oBAAoB,GAAG,QAAQ,CAAC,kCAAkC,EAAE;IAC/E,IAAI,EAAE,2BAA2B;IACjC,WAAW,EACT,kFAAkF;QAClF,4EAA4E;QAC5E,2EAA2E;IAC7E,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,cAAc,EAAE,CAAC;aACd,MAAM,EAAE;aACR,QAAQ,CACP,qFAAqF,CACtF;KACJ,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG;QACvB,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QAChD,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,QAAQ,CACZ,4BAA4B,MAAM,CAAC,cAAc,iCAAiC,EAClF,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,CAC1C,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,kBAAkB,EAAE,CAAC;QACjC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,GAAG,CAAC,cAAc,CACvC;YACE,MAAM,EAAE,qBAAqB,GAAG,EAAE;YAClC,MAAM,EACJ,qEAAqE;gBACrE,oDAAoD;gBACpD,uDAAuD;YACzD,GAAG,EAAE,GAAG;SACT,EACD,GAAG,CACJ,CAAC;QAEF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,QAAQ,CAAC,mBAAmB,GAAG,6BAA6B,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC;QAC/F,CAAC;QAED,iGAAiG;QACjG,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;QACvB,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,IAAI,KAAK,CAAC,iBAAiB;YAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,KAAK,CAAC,iBAAiB;YAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,KAAK,CAAC,iBAAiB;YAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEjD,MAAM,OAAO,GAAG;YACd,eAAe,EAAE,KAAK,CAAC,cAAc,IAAI,GAAG;YAC5C,KAAK,EAAE,KAAK,CAAC,gBAAgB,IAAI,SAAS;YAC1C,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE;YACxB,aAAa,EAAE,KAAK,CAAC,YAAY,IAAI,EAAE;YACvC,gBAAgB,EAAE,KAAK,CAAC,eAAe,IAAI,EAAE;YAC7C,gBAAgB,EAAE,KAAK,CAAC,eAAe,IAAI,EAAE;YAC7C,mBAAmB,EAAE,KAAK,CAAC,iBAAiB;YAC5C,iBAAiB,EAAE,KAAK,CAAC,eAAe;YACxC,iBAAiB,EAAE,QAAQ;YAC3B,qBAAqB,EAAE,IAAI,CAAC,MAAM;SACnC,CAAC;QAEF,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,2BAA2B,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC;QAEnE,OAAO,OAAO,CAAC;IACjB,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/fema-dataframe-describe.tool.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @fileoverview Tool: fema_dataframe_describe — describe tables on a DataCanvas staged by fema_search_nfip.
+ * @module mcp-server/tools/definitions/fema-dataframe-describe
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const femaDataframeDescribe: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    canvas_id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    tables: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        kind: z.ZodString;
+        row_count: z.ZodNumber;
+        columns: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodString;
+            nullable: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    canvas_id: z.ZodString;
+}, z.core.$strip>, readonly [{
+    readonly reason: "canvas_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The canvas_id does not correspond to an active canvas session.";
+    readonly recovery: "Re-run fema_search_nfip to stage a fresh canvas, then use the new canvas_id.";
+}], undefined>;
+//# sourceMappingURL=fema-dataframe-describe.tool.d.ts.map

package/dist/mcp-server/tools/definitions/fema-dataframe-describe.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fema-dataframe-describe.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/fema-dataframe-describe.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;cA8GhC,CAAC"}

package/dist/mcp-server/tools/definitions/fema-dataframe-describe.tool.js

@@ -0,0 +1,99 @@
+/**
+ * @fileoverview Tool: fema_dataframe_describe — describe tables on a DataCanvas staged by fema_search_nfip.
+ * @module mcp-server/tools/definitions/fema-dataframe-describe
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getCanvas } from '../../../services/canvas/canvas-accessor.js';
+export const femaDataframeDescribe = tool('fema_dataframe_describe', {
+    title: 'Describe FEMA DataCanvas Tables',
+    description: 'List tables and column schemas on a DataCanvas staged by fema_search_nfip. ' +
+        'Call this before fema_dataframe_query to discover the exact table name, column names, and DuckDB data types needed to write valid SQL. ' +
+        'The canvas holds the full NFIP claims result set — row count here is the total available for queries.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    input: z.object({
+        canvas_id: z.string().describe('Canvas ID from the fema_search_nfip response.'),
+    }),
+    output: z.object({
+        tables: z
+            .array(z
+            .object({
+            name: z
+                .string()
+                .describe('Table or view name — use this exact string in SQL FROM clauses.'),
+            kind: z
+                .string()
+                .describe('Object type: "table" for a registered data table, "view" for a derived view.'),
+            row_count: z
+                .number()
+                .describe('Total rows in this table — the full staged result set, not the inline preview count.'),
+            columns: z
+                .array(z
+                .object({
+                name: z
+                    .string()
+                    .describe('Column name — use in SELECT, WHERE, GROUP BY, and ORDER BY clauses.'),
+                type: z
+                    .string()
+                    .describe('DuckDB SQL data type (e.g., VARCHAR, DOUBLE, INTEGER, BOOLEAN).'),
+                nullable: z
+                    .boolean()
+                    .optional()
+                    .describe('True when the column can contain NULL values. Absent when nullability is unknown.'),
+            })
+                .describe('A single column in the table.'))
+                .describe('All columns in this table, in schema order.'),
+        })
+            .describe('A single registered table or view on the canvas.'))
+            .describe('All tables and views available on this canvas.'),
+        canvas_id: z.string().describe('Canvas ID that was described — pass to fema_dataframe_query.'),
+    }),
+    errors: [
+        {
+            reason: 'canvas_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The canvas_id does not correspond to an active canvas session.',
+            recovery: 'Re-run fema_search_nfip to stage a fresh canvas, then use the new canvas_id.',
+        },
+    ],
+    async handler(input, ctx) {
+        const canvas = getCanvas();
+        if (!canvas) {
+            throw new Error('DataCanvas is not enabled. Set CANVAS_PROVIDER_TYPE=duckdb to use fema_dataframe_describe.');
+        }
+        const instance = await canvas.acquire(input.canvas_id, ctx);
+        const tableInfos = await instance.describe();
+        ctx.log.info('DataCanvas describe complete', {
+            canvasId: input.canvas_id,
+            tableCount: tableInfos.length,
+        });
+        return {
+            tables: tableInfos.map((t) => ({
+                name: t.name,
+                kind: t.kind,
+                row_count: t.rowCount,
+                columns: t.columns.map((c) => ({
+                    name: c.name,
+                    type: c.type,
+                    ...(c.nullable != null ? { nullable: c.nullable } : {}),
+                })),
+            })),
+            canvas_id: input.canvas_id,
+        };
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`**Canvas:** ${result.canvas_id} | **${result.tables.length} table(s)**\n`);
+        for (const t of result.tables) {
+            lines.push(`## ${t.name} (${t.kind}, ${t.row_count} rows)`);
+            lines.push(`| Column | Type | Nullable |`);
+            lines.push(`| --- | --- | --- |`);
+            for (const c of t.columns) {
+                lines.push(`| ${c.name} | ${c.type} | ${c.nullable ?? 'unknown'} |`);
+            }
+            lines.push('');
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=fema-dataframe-describe.tool.js.map

package/dist/mcp-server/tools/definitions/fema-dataframe-describe.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fema-dataframe-describe.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/fema-dataframe-describe.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/fema-dataframe-query.tool.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @fileoverview Tool: fema_dataframe_query — SQL SELECT against a DataCanvas table staged by fema_search_nfip.
+ * @module mcp-server/tools/definitions/fema-dataframe-query
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const femaDataframeQuery: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    canvas_id: z.ZodString;
+    query: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    rows: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    row_count: z.ZodNumber;
+    canvas_id: z.ZodString;
+}, z.core.$strip>, readonly [{
+    readonly reason: "canvas_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "The canvas_id does not correspond to an active canvas session.";
+    readonly recovery: "Re-run fema_search_nfip to stage a fresh canvas, then use the new canvas_id.";
+}, {
+    readonly reason: "invalid_query";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "The SQL statement is not a valid SELECT, references a non-existent table or column, or uses blocked operations.";
+    readonly recovery: "Call fema_dataframe_describe to verify table and column names, then correct the SQL. Only SELECT statements are permitted.";
+}], undefined>;
+//# sourceMappingURL=fema-dataframe-query.tool.d.ts.map

package/dist/mcp-server/tools/definitions/fema-dataframe-query.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fema-dataframe-query.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/fema-dataframe-query.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;cA4F7B,CAAC"}

package/dist/mcp-server/tools/definitions/fema-dataframe-query.tool.js

@@ -0,0 +1,87 @@
+/**
+ * @fileoverview Tool: fema_dataframe_query — SQL SELECT against a DataCanvas table staged by fema_search_nfip.
+ * @module mcp-server/tools/definitions/fema-dataframe-query
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getCanvas } from '../../../services/canvas/canvas-accessor.js';
+export const femaDataframeQuery = tool('fema_dataframe_query', {
+    title: 'Query FEMA DataCanvas Table',
+    description: 'Run a read-only SQL SELECT against a DataCanvas table staged by fema_search_nfip. ' +
+        'Enables aggregation, GROUP BY, SUM/COUNT, time-series, and filtered analysis over the full NFIP claims result ' +
+        'without re-fetching from the API. ' +
+        'Call fema_dataframe_describe first to get the exact table name and column names needed for valid SQL. ' +
+        'Only SELECT statements are allowed — DDL, DML, COPY, and file-reading functions are blocked.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    input: z.object({
+        canvas_id: z
+            .string()
+            .describe('Canvas ID from the fema_search_nfip response (the canvas_id field).'),
+        query: z
+            .string()
+            .describe('SQL SELECT statement to run against the staged table. Use the table name from fema_dataframe_describe. ' +
+            'Example: "SELECT year_of_loss, COUNT(*) AS claims, SUM(amount_paid_building) AS total_building_paid FROM df_nfip_abc123 GROUP BY year_of_loss ORDER BY year_of_loss"'),
+    }),
+    output: z.object({
+        rows: z
+            .array(z
+            .record(z.string(), z.unknown())
+            .describe('A single result row — keys are column names from the SELECT, values are the computed data.'))
+            .describe('All rows returned by the query.'),
+        row_count: z
+            .number()
+            .describe('Number of rows in this response (may be capped at the canvas row limit).'),
+        canvas_id: z.string().describe('Canvas ID that was queried — reuse for follow-up queries.'),
+    }),
+    errors: [
+        {
+            reason: 'canvas_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'The canvas_id does not correspond to an active canvas session.',
+            recovery: 'Re-run fema_search_nfip to stage a fresh canvas, then use the new canvas_id.',
+        },
+        {
+            reason: 'invalid_query',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'The SQL statement is not a valid SELECT, references a non-existent table or column, or uses blocked operations.',
+            recovery: 'Call fema_dataframe_describe to verify table and column names, then correct the SQL. Only SELECT statements are permitted.',
+        },
+    ],
+    async handler(input, ctx) {
+        const canvas = getCanvas();
+        if (!canvas) {
+            throw new Error('DataCanvas is not enabled. Set CANVAS_PROVIDER_TYPE=duckdb to use fema_dataframe_query.');
+        }
+        const instance = await canvas.acquire(input.canvas_id, ctx);
+        const result = await instance.query(input.query, { signal: ctx.signal });
+        ctx.log.info('DataCanvas query complete', {
+            canvasId: input.canvas_id,
+            rowCount: result.rowCount,
+        });
+        return {
+            rows: result.rows,
+            row_count: result.rowCount,
+            canvas_id: input.canvas_id,
+        };
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`**${result.row_count} rows** | Canvas: ${result.canvas_id}\n`);
+        if (result.rows.length === 0) {
+            lines.push('_No rows returned._');
+        }
+        else {
+            const headers = Object.keys(result.rows[0] ?? {});
+            if (headers.length > 0) {
+                lines.push(`| ${headers.join(' | ')} |`);
+                lines.push(`| ${headers.map(() => '---').join(' | ')} |`);
+                for (const row of result.rows) {
+                    const cells = headers.map((h) => String(row[h] ?? ''));
+                    lines.push(`| ${cells.join(' | ')} |`);
+                }
+            }
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=fema-dataframe-query.tool.js.map

package/dist/mcp-server/tools/definitions/fema-dataframe-query.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fema-dataframe-query.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/fema-dataframe-query.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/fema-get-disaster.tool.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @fileoverview Tool: fema_get_disaster — fetch all designated-area rows for a specific disaster.
+ * @module mcp-server/tools/definitions/fema-get-disaster
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const femaGetDisaster: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    disaster_number: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    disaster_number: z.ZodNumber;
+    title: z.ZodString;
+    state: z.ZodString;
+    incident_type: z.ZodString;
+    declaration_type: z.ZodString;
+    declaration_date: z.ZodString;
+    incident_begin_date: z.ZodOptional<z.ZodString>;
+    incident_end_date: z.ZodOptional<z.ZodString>;
+    ia_declared: z.ZodBoolean;
+    pa_declared: z.ZodBoolean;
+    hm_declared: z.ZodBoolean;
+    designated_areas: z.ZodArray<z.ZodObject<{
+        area: z.ZodString;
+        fips_state_code: z.ZodOptional<z.ZodString>;
+        fips_county_code: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    designated_area_count: z.ZodNumber;
+}, z.core.$strip>, readonly [{
+    readonly reason: "not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No declaration found with the given disaster number.";
+    readonly recovery: "Verify the disaster number using fema_search_disasters. FEMA disaster numbers are typically 4-digit integers.";
+}], undefined>;
+//# sourceMappingURL=fema-get-disaster.tool.d.ts.map

package/dist/mcp-server/tools/definitions/fema-get-disaster.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fema-get-disaster.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/fema-get-disaster.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;cAyJ1B,CAAC"}

package/dist/mcp-server/tools/definitions/fema-get-disaster.tool.js

@@ -0,0 +1,142 @@
+/**
+ * @fileoverview Tool: fema_get_disaster — fetch all designated-area rows for a specific disaster.
+ * @module mcp-server/tools/definitions/fema-get-disaster
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getOpenFemaService } from '../../../services/openfema/openfema-service.js';
+export const femaGetDisaster = tool('fema_get_disaster', {
+    title: 'Get FEMA Disaster Details',
+    description: 'Fetch all designated-area rows for a specific FEMA disaster by disaster number (e.g., 4781). ' +
+        'Returns every county/municipality designated under the declaration along with programs activated, ' +
+        'incident period, and state info. Use fema_search_disasters to find disaster numbers. ' +
+        'The returned disaster_number chains to fema_get_public_assistance and fema_get_housing_assistance.',
+    annotations: { readOnlyHint: true, openWorldHint: false },
+    input: z.object({
+        disaster_number: z
+            .number()
+            .int()
+            .positive()
+            .describe('FEMA disaster number (e.g., 4781). Obtain from fema_search_disasters.'),
+    }),
+    output: z.object({
+        disaster_number: z
+            .number()
+            .describe('FEMA disaster number — use as the chain key for PA and housing assistance tools.'),
+        title: z.string().describe('Official declaration title (e.g., "SEVERE STORMS AND FLOODING").'),
+        state: z.string().describe('Two-letter state/territory code.'),
+        incident_type: z.string().describe('Type of incident (e.g., Flood, Hurricane, Severe Storm).'),
+        declaration_type: z
+            .string()
+            .describe('Declaration type: DR (major disaster), EM (emergency), or FM (fire management).'),
+        declaration_date: z.string().describe('ISO 8601 date the declaration was signed.'),
+        incident_begin_date: z
+            .string()
+            .optional()
+            .describe('ISO 8601 start date of the incident. Absent when not recorded.'),
+        incident_end_date: z
+            .string()
+            .optional()
+            .describe('ISO 8601 end date of the incident. Absent for ongoing or unrecorded incidents.'),
+        ia_declared: z
+            .boolean()
+            .describe('True when Individual Assistance (housing/personal grants) was declared.'),
+        pa_declared: z
+            .boolean()
+            .describe('True when Public Assistance (infrastructure recovery grants) was declared.'),
+        hm_declared: z.boolean().describe('True when Hazard Mitigation grants were declared.'),
+        designated_areas: z
+            .array(z
+            .object({
+            area: z.string().describe('Name of the designated county or municipality.'),
+            fips_state_code: z
+                .string()
+                .optional()
+                .describe('2-digit state FIPS code. Absent when not returned.'),
+            fips_county_code: z
+                .string()
+                .optional()
+                .describe('3-digit county FIPS code. Absent when not returned.'),
+        })
+            .describe('A single designated area entry.'))
+            .describe('All counties/municipalities designated for assistance under this declaration.'),
+        designated_area_count: z
+            .number()
+            .describe('Total number of designated areas in this declaration.'),
+    }),
+    errors: [
+        {
+            reason: 'not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No declaration found with the given disaster number.',
+            recovery: 'Verify the disaster number using fema_search_disasters. FEMA disaster numbers are typically 4-digit integers.',
+        },
+    ],
+    async handler(input, ctx) {
+        const svc = getOpenFemaService();
+        const { rows } = await svc.fetchDisasters({
+            filter: `disasterNumber eq ${input.disaster_number}`,
+            select: 'disasterNumber,declarationTitle,state,incidentType,declarationType,' +
+                'declarationDate,incidentBeginDate,incidentEndDate,' +
+                'iaProgramDeclared,paProgramDeclared,hmProgramDeclared,' +
+                'designatedArea,fipsStateCode,fipsCountyCode',
+            top: 1000,
+        }, ctx);
+        if (rows.length === 0) {
+            throw ctx.fail('not_found', `No disaster declaration found with number ${input.disaster_number}.`, { disasterNumber: input.disaster_number, ...ctx.recoveryFor('not_found') });
+        }
+        // biome-ignore lint/style/noNonNullAssertion: rows.length === 0 checked above
+        const first = rows[0];
+        const designatedAreas = rows.map((r) => ({
+            area: r.designatedArea ?? 'Unknown',
+            ...(r.fipsStateCode ? { fips_state_code: r.fipsStateCode } : {}),
+            ...(r.fipsCountyCode ? { fips_county_code: r.fipsCountyCode } : {}),
+        }));
+        ctx.log.info('Disaster fetch complete', {
+            disasterNumber: input.disaster_number,
+            areaCount: designatedAreas.length,
+        });
+        return {
+            disaster_number: first.disasterNumber ?? input.disaster_number,
+            title: first.declarationTitle ?? 'Unknown',
+            state: first.state ?? '',
+            incident_type: first.incidentType ?? '',
+            declaration_type: first.declarationType ?? '',
+            declaration_date: first.declarationDate ?? '',
+            ...(first.incidentBeginDate ? { incident_begin_date: first.incidentBeginDate } : {}),
+            ...(first.incidentEndDate ? { incident_end_date: first.incidentEndDate } : {}),
+            ia_declared: first.iaProgramDeclared ?? false,
+            pa_declared: first.paProgramDeclared ?? false,
+            hm_declared: first.hmProgramDeclared ?? false,
+            designated_areas: designatedAreas,
+            designated_area_count: designatedAreas.length,
+        };
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`# DR-${result.disaster_number} — ${result.title}`);
+        lines.push(`**State:** ${result.state} | **Type:** ${result.declaration_type} | **Incident:** ${result.incident_type}`);
+        lines.push(`**Declared:** ${result.declaration_date}`);
+        if (result.incident_begin_date) {
+            lines.push(`**Incident Period:** ${result.incident_begin_date}${result.incident_end_date ? ` → ${result.incident_end_date}` : ' (ongoing)'}`);
+        }
+        const programs = [];
+        if (result.ia_declared)
+            programs.push('Individual Assistance (IA)');
+        if (result.pa_declared)
+            programs.push('Public Assistance (PA)');
+        if (result.hm_declared)
+            programs.push('Hazard Mitigation (HM)');
+        lines.push(`**Programs Declared:** ${programs.length > 0 ? programs.join(', ') : 'None'}`);
+        lines.push('');
+        lines.push(`## Designated Areas (${result.designated_area_count})`);
+        for (const area of result.designated_areas) {
+            const fips = area.fips_state_code && area.fips_county_code
+                ? ` (FIPS ${area.fips_state_code}${area.fips_county_code})`
+                : '';
+            lines.push(`- ${area.area}${fips}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=fema-get-disaster.tool.js.map

package/dist/mcp-server/tools/definitions/fema-get-disaster.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fema-get-disaster.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/fema-get-disaster.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/fema-get-housing-assistance.tool.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @fileoverview Tool: fema_get_housing_assistance — IA housing assistance data for a disaster.
+ * @module mcp-server/tools/definitions/fema-get-housing-assistance
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const femaGetHousingAssistance: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    disaster_number: z.ZodNumber;
+    state: z.ZodOptional<z.ZodString>;
+    type: z.ZodDefault<z.ZodEnum<{
+        owners: "owners";
+        renters: "renters";
+        both: "both";
+    }>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    owners: z.ZodArray<z.ZodObject<{
+        disaster_number: z.ZodNumber;
+        state: z.ZodOptional<z.ZodString>;
+        county: z.ZodOptional<z.ZodString>;
+        city: z.ZodOptional<z.ZodString>;
+        zip_code: z.ZodOptional<z.ZodString>;
+        valid_registrations: z.ZodOptional<z.ZodNumber>;
+        approved_for_fema_assistance: z.ZodOptional<z.ZodNumber>;
+        total_approved_ihp_amount: z.ZodOptional<z.ZodNumber>;
+        repair_replace_amount: z.ZodOptional<z.ZodNumber>;
+        rental_amount: z.ZodOptional<z.ZodNumber>;
+        other_needs_amount: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    renters: z.ZodArray<z.ZodObject<{
+        disaster_number: z.ZodNumber;
+        state: z.ZodOptional<z.ZodString>;
+        county: z.ZodOptional<z.ZodString>;
+        city: z.ZodOptional<z.ZodString>;
+        zip_code: z.ZodOptional<z.ZodString>;
+        valid_registrations: z.ZodOptional<z.ZodNumber>;
+        approved_for_fema_assistance: z.ZodOptional<z.ZodNumber>;
+        total_approved_ihp_amount: z.ZodOptional<z.ZodNumber>;
+        rental_amount: z.ZodOptional<z.ZodNumber>;
+        other_needs_amount: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    owners_count: z.ZodNumber;
+    renters_count: z.ZodNumber;
+}, z.core.$strip>, readonly [{
+    readonly reason: "no_results";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No IA housing records found for this disaster.";
+    readonly recovery: "Check that ia_declared is true for this disaster using fema_get_disaster. IA housing data may take weeks to appear after a declaration.";
+}], {
+    readonly notice: z.ZodOptional<z.ZodString>;
+}>;
+//# sourceMappingURL=fema-get-housing-assistance.tool.d.ts.map

package/dist/mcp-server/tools/definitions/fema-get-housing-assistance.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fema-get-housing-assistance.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/fema-get-housing-assistance.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwRnC,CAAC"}