@cyanheads/fema-mcp-server 0.1.1

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

@@ -0,0 +1,246 @@
+/**
+ * @fileoverview Tool: fema_get_housing_assistance — IA housing assistance data for a disaster.
+ * @module mcp-server/tools/definitions/fema-get-housing-assistance
+ */
+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 femaGetHousingAssistance = tool('fema_get_housing_assistance', {
+    title: 'Get FEMA Housing Assistance Data',
+    description: 'Retrieve Individual Assistance (IA) housing data for a disaster by disaster number. ' +
+        'Returns owner and/or renter breakdowns by county and ZIP code — valid registrations, ' +
+        'total approved IHP amounts, repair/rental amounts, and inspection data. ' +
+        'Use type to select owners, renters, or both (default). ' +
+        'IA housing data is only available when ia_declared: true on the disaster (check via fema_get_disaster). ' +
+        'Use disaster_number from fema_search_disasters.',
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    input: z.object({
+        disaster_number: z
+            .number()
+            .int()
+            .positive()
+            .describe('FEMA disaster number. Obtain from fema_search_disasters.'),
+        state: z
+            .string()
+            .length(2)
+            .toUpperCase()
+            .optional()
+            .describe('Two-letter state code to narrow results when a disaster spans multiple states.'),
+        type: z
+            .enum(['owners', 'renters', 'both'])
+            .default('both')
+            .describe('Which housing assistance dataset to query: owners, renters, or both (default).'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(1000)
+            .default(100)
+            .describe('Maximum records per dataset to return (default 100).'),
+        offset: z.number().int().min(0).default(0).describe('Pagination offset (default 0).'),
+    }),
+    output: z.object({
+        owners: z
+            .array(z
+            .object({
+            disaster_number: z.number().describe('FEMA disaster number this record belongs to.'),
+            state: z
+                .string()
+                .optional()
+                .describe('Two-letter state code. Absent when not recorded.'),
+            county: z.string().optional().describe('County name. Absent when not recorded.'),
+            city: z.string().optional().describe('City name. Absent when not recorded.'),
+            zip_code: z.string().optional().describe('5-digit ZIP code. Absent when not recorded.'),
+            valid_registrations: z
+                .number()
+                .optional()
+                .describe('Number of valid IA registrations from homeowners in this area. Absent when zero or not reported.'),
+            approved_for_fema_assistance: z
+                .number()
+                .optional()
+                .describe('Number of homeowner registrations approved for any FEMA assistance. Absent when zero or not reported.'),
+            total_approved_ihp_amount: z
+                .number()
+                .optional()
+                .describe('Total Individuals and Households Program (IHP) assistance approved in USD. Absent when zero or not reported.'),
+            repair_replace_amount: z
+                .number()
+                .optional()
+                .describe('Home repair and replacement assistance in USD. Absent when zero or not reported.'),
+            rental_amount: z
+                .number()
+                .optional()
+                .describe('Rental assistance granted in USD. Absent when zero or not reported.'),
+            other_needs_amount: z
+                .number()
+                .optional()
+                .describe('Other needs assistance (personal property, transportation, etc.) in USD. Absent when zero or not reported.'),
+        })
+            .describe('Homeowner housing assistance aggregated by county and ZIP for one disaster.'))
+            .describe('Homeowner (HousingAssistanceOwners) records. Empty when type is "renters" or no owner data exists.'),
+        renters: z
+            .array(z
+            .object({
+            disaster_number: z.number().describe('FEMA disaster number this record belongs to.'),
+            state: z
+                .string()
+                .optional()
+                .describe('Two-letter state code. Absent when not recorded.'),
+            county: z.string().optional().describe('County name. Absent when not recorded.'),
+            city: z.string().optional().describe('City name. Absent when not recorded.'),
+            zip_code: z.string().optional().describe('5-digit ZIP code. Absent when not recorded.'),
+            valid_registrations: z
+                .number()
+                .optional()
+                .describe('Number of valid IA registrations from renters in this area. Absent when zero or not reported.'),
+            approved_for_fema_assistance: z
+                .number()
+                .optional()
+                .describe('Number of renter registrations approved for any FEMA assistance. Absent when zero or not reported.'),
+            total_approved_ihp_amount: z
+                .number()
+                .optional()
+                .describe('Total IHP assistance approved for renters in USD. Absent when zero or not reported.'),
+            rental_amount: z
+                .number()
+                .optional()
+                .describe('Rental assistance granted in USD. Absent when zero or not reported.'),
+            other_needs_amount: z
+                .number()
+                .optional()
+                .describe('Other needs assistance in USD. Absent when zero or not reported.'),
+        })
+            .describe('Renter housing assistance aggregated by county and ZIP for one disaster.'))
+            .describe('Renter (HousingAssistanceRenters) records. Empty when type is "owners" or no renter data exists.'),
+        owners_count: z
+            .number()
+            .describe('Total owner records available before the per-dataset limit.'),
+        renters_count: z
+            .number()
+            .describe('Total renter records available before the per-dataset limit.'),
+    }),
+    enrichment: {
+        notice: z.string().optional().describe('Guidance when no results were found.'),
+    },
+    errors: [
+        {
+            reason: 'no_results',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No IA housing records found for this disaster.',
+            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.',
+        },
+    ],
+    async handler(input, ctx) {
+        const svc = getOpenFemaService();
+        const baseFilter = [`disasterNumber eq ${input.disaster_number}`];
+        if (input.state?.trim()) {
+            baseFilter.push(`state eq '${input.state}'`);
+        }
+        const filter = baseFilter.join(' and ');
+        const queryOpts = {
+            filter,
+            orderby: 'totalApprovedIhpAmount desc',
+            top: input.limit,
+            skip: input.offset,
+        };
+        const fetchOwners = input.type === 'owners' || input.type === 'both';
+        const fetchRenters = input.type === 'renters' || input.type === 'both';
+        const [ownersResult, rentersResult] = await Promise.all([
+            fetchOwners ? svc.fetchHousingAssistance('HousingAssistanceOwners', queryOpts, ctx) : null,
+            fetchRenters ? svc.fetchHousingAssistance('HousingAssistanceRenters', queryOpts, ctx) : null,
+        ]);
+        const ownersData = ownersResult?.rows ?? [];
+        const rentersData = rentersResult?.rows ?? [];
+        const ownersCount = ownersResult?.count ?? 0;
+        const rentersCount = rentersResult?.count ?? 0;
+        if (ownersData.length === 0 && rentersData.length === 0) {
+            ctx.enrich.notice(`No housing assistance records found for DR-${input.disaster_number}. Verify IA was declared via fema_get_disaster.`);
+            throw ctx.fail('no_results', `No IA housing records for disaster ${input.disaster_number}.`, {
+                disasterNumber: input.disaster_number,
+                ...ctx.recoveryFor('no_results'),
+            });
+        }
+        const mapRow = (r) => ({
+            disaster_number: r.disasterNumber ?? input.disaster_number,
+            ...(r.state ? { state: r.state } : {}),
+            ...(r.county ? { county: r.county } : {}),
+            ...(r.city ? { city: r.city } : {}),
+            ...(r.zipCode ? { zip_code: r.zipCode } : {}),
+            ...(r.validRegistrations != null ? { valid_registrations: r.validRegistrations } : {}),
+            ...(r.approvedForFemaAssistance != null
+                ? { approved_for_fema_assistance: r.approvedForFemaAssistance }
+                : {}),
+            ...(r.totalApprovedIhpAmount != null
+                ? { total_approved_ihp_amount: r.totalApprovedIhpAmount }
+                : {}),
+            ...(r.repairReplaceAmount != null ? { repair_replace_amount: r.repairReplaceAmount } : {}),
+            ...(r.rentalAmount != null ? { rental_amount: r.rentalAmount } : {}),
+            ...(r.otherNeedsAmount != null ? { other_needs_amount: r.otherNeedsAmount } : {}),
+        });
+        ctx.log.info('Housing assistance fetch complete', {
+            disasterNumber: input.disaster_number,
+            owners: ownersData.length,
+            renters: rentersData.length,
+        });
+        return {
+            owners: ownersData.map(mapRow),
+            renters: rentersData.map(mapRow),
+            owners_count: ownersCount,
+            renters_count: rentersCount,
+        };
+    },
+    format: (result) => {
+        const lines = [];
+        if (result.owners.length > 0) {
+            lines.push(`## Owner Assistance (${result.owners.length} of ${result.owners_count} records)`);
+            for (const o of result.owners) {
+                const loc = [o.county, o.city, o.zip_code].filter(Boolean).join(', ');
+                const locLabel = loc || `DR-${o.disaster_number}`;
+                lines.push(`### ${locLabel}`);
+                if (o.state)
+                    lines.push(`**State:** ${o.state} | **Disaster:** DR-${o.disaster_number}`);
+                if (o.valid_registrations != null)
+                    lines.push(`**Registrations:** ${o.valid_registrations}`);
+                if (o.approved_for_fema_assistance != null)
+                    lines.push(`**Approved for FEMA Assistance:** ${o.approved_for_fema_assistance}`);
+                if (o.total_approved_ihp_amount != null)
+                    lines.push(`**Total Approved IHP:** $${o.total_approved_ihp_amount.toLocaleString()}`);
+                if (o.repair_replace_amount != null)
+                    lines.push(`**Repair/Replacement:** $${o.repair_replace_amount.toLocaleString()}`);
+                if (o.rental_amount != null)
+                    lines.push(`**Rental Assistance:** $${o.rental_amount.toLocaleString()}`);
+                if (o.other_needs_amount != null)
+                    lines.push(`**Other Needs:** $${o.other_needs_amount.toLocaleString()}`);
+                lines.push('');
+            }
+        }
+        if (result.renters.length > 0) {
+            lines.push(`## Renter Assistance (${result.renters.length} of ${result.renters_count} records)`);
+            for (const r of result.renters) {
+                const loc = [r.county, r.city, r.zip_code].filter(Boolean).join(', ');
+                const locLabel = loc || `DR-${r.disaster_number}`;
+                lines.push(`### ${locLabel}`);
+                if (r.state)
+                    lines.push(`**State:** ${r.state} | **Disaster:** DR-${r.disaster_number}`);
+                if (r.valid_registrations != null)
+                    lines.push(`**Registrations:** ${r.valid_registrations}`);
+                if (r.approved_for_fema_assistance != null)
+                    lines.push(`**Approved for FEMA Assistance:** ${r.approved_for_fema_assistance}`);
+                if (r.total_approved_ihp_amount != null)
+                    lines.push(`**Total Approved IHP:** $${r.total_approved_ihp_amount.toLocaleString()}`);
+                if (r.rental_amount != null)
+                    lines.push(`**Rental Assistance:** $${r.rental_amount.toLocaleString()}`);
+                if (r.other_needs_amount != null)
+                    lines.push(`**Other Needs:** $${r.other_needs_amount.toLocaleString()}`);
+                lines.push('');
+            }
+        }
+        if (lines.length === 0) {
+            lines.push('No housing assistance records available.');
+            lines.push(`owners_count: ${result.owners_count}`);
+            lines.push(`renters_count: ${result.renters_count}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=fema-get-housing-assistance.tool.js.map

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

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

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

@@ -0,0 +1,45 @@
+/**
+ * @fileoverview Tool: fema_get_public_assistance — PA funded project details for a disaster or state.
+ * @module mcp-server/tools/definitions/fema-get-public-assistance
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const femaGetPublicAssistance: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    disaster_number: z.ZodOptional<z.ZodNumber>;
+    state: z.ZodOptional<z.ZodString>;
+    county: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    projects: z.ZodArray<z.ZodObject<{
+        disaster_number: z.ZodNumber;
+        pw_number: z.ZodOptional<z.ZodNumber>;
+        applicant_id: z.ZodOptional<z.ZodString>;
+        application_title: z.ZodOptional<z.ZodString>;
+        damage_category_code: z.ZodOptional<z.ZodString>;
+        damage_category_description: z.ZodOptional<z.ZodString>;
+        project_amount: z.ZodOptional<z.ZodNumber>;
+        federal_share_obligated: z.ZodOptional<z.ZodNumber>;
+        total_obligated: z.ZodOptional<z.ZodNumber>;
+        county: z.ZodOptional<z.ZodString>;
+        state: z.ZodOptional<z.ZodString>;
+        project_status: z.ZodOptional<z.ZodString>;
+        project_size: z.ZodOptional<z.ZodString>;
+        first_obligation_date: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    total_count: z.ZodNumber;
+    returned_count: z.ZodNumber;
+}, z.core.$strip>, readonly [{
+    readonly reason: "missing_filter";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "Neither disaster_number nor state was provided.";
+    readonly recovery: "Provide at least one of disaster_number (from fema_search_disasters) or state (2-letter code) to scope the query.";
+}, {
+    readonly reason: "no_results";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No PA project records found for the given filters.";
+    readonly recovery: "Verify the disaster has PA declared (pa_declared: true via fema_get_disaster) or check the state code. Recent disasters may have incomplete records.";
+}], {
+    readonly notice: z.ZodOptional<z.ZodString>;
+}>;
+//# sourceMappingURL=fema-get-public-assistance.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fema-get-public-assistance.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/fema-get-public-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,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoOlC,CAAC"}

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

@@ -0,0 +1,210 @@
+/**
+ * @fileoverview Tool: fema_get_public_assistance — PA funded project details for a disaster or state.
+ * @module mcp-server/tools/definitions/fema-get-public-assistance
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { escapeODataString, getOpenFemaService } from '../../../services/openfema/openfema-service.js';
+export const femaGetPublicAssistance = tool('fema_get_public_assistance', {
+    title: 'Get FEMA Public Assistance Projects',
+    description: 'Retrieve Public Assistance (PA) funded project records for a disaster or state — shows where federal recovery money was obligated. ' +
+        'Returns applicant, damage category, project size and status, federal share obligated, and total obligated amounts. ' +
+        'Either disaster_number or state must be provided. ' +
+        'Use disaster_number (from fema_search_disasters) to scope to a single declaration, or state to browse all PA projects for a state. ' +
+        'PA projects are created only when the PA program is declared (pa_declared: true on the disaster).',
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    input: z.object({
+        disaster_number: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe('FEMA disaster number to scope results to a single declaration.'),
+        state: z
+            .string()
+            .length(2)
+            .toUpperCase()
+            .optional()
+            .describe('Two-letter state code to browse all PA projects for a state.'),
+        county: z.string().optional().describe('Filter by county name substring.'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(1000)
+            .default(100)
+            .describe('Maximum number of projects to return (1–1000, default 100).'),
+        offset: z.number().int().min(0).default(0).describe('Pagination offset (default 0).'),
+    }),
+    output: z.object({
+        projects: z
+            .array(z
+            .object({
+            disaster_number: z.number().describe('FEMA disaster number this project belongs to.'),
+            pw_number: z
+                .number()
+                .optional()
+                .describe('Project Worksheet number assigned by FEMA. Absent when not yet assigned.'),
+            applicant_id: z
+                .string()
+                .optional()
+                .describe('FEMA applicant identifier for the recipient organization. Absent when not recorded.'),
+            application_title: z
+                .string()
+                .optional()
+                .describe('Name of the applicant organization or project. Absent when not recorded.'),
+            damage_category_code: z
+                .string()
+                .optional()
+                .describe('FEMA damage category code (e.g., A=Debris Removal, B=Emergency Protective Measures, C=Roads and Bridges). Absent when unclassified.'),
+            damage_category_description: z
+                .string()
+                .optional()
+                .describe('Human-readable name for the damage category code. Absent when unclassified.'),
+            project_amount: z
+                .number()
+                .optional()
+                .describe('Total estimated project cost in USD. Absent when not yet determined.'),
+            federal_share_obligated: z
+                .number()
+                .optional()
+                .describe('Federal dollars obligated for this project in USD. Absent before obligation.'),
+            total_obligated: z
+                .number()
+                .optional()
+                .describe('Total obligated amount across all funding sources in USD. Absent before obligation.'),
+            county: z
+                .string()
+                .optional()
+                .describe('County where the project is located. Absent when not recorded.'),
+            state: z
+                .string()
+                .optional()
+                .describe('Two-letter state abbreviation. Absent when not recorded.'),
+            project_status: z
+                .string()
+                .optional()
+                .describe('Current project status (e.g., Obligated, Closed, In Progress). Absent when not set.'),
+            project_size: z
+                .string()
+                .optional()
+                .describe('Project size classification: "small" (≤$1M) or "large" (>$1M). Absent when unclassified.'),
+            first_obligation_date: z
+                .string()
+                .optional()
+                .describe('ISO 8601 date the first federal obligation was recorded. Absent before obligation.'),
+        })
+            .describe('A single Public Assistance funded project record.'))
+            .describe('Public assistance funded project records.'),
+        total_count: z.number().describe('Total matching projects before pagination.'),
+        returned_count: z.number().describe('Number of projects in this response.'),
+    }),
+    enrichment: {
+        notice: z.string().optional().describe('Guidance when no results were found.'),
+    },
+    errors: [
+        {
+            reason: 'missing_filter',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'Neither disaster_number nor state was provided.',
+            recovery: 'Provide at least one of disaster_number (from fema_search_disasters) or state (2-letter code) to scope the query.',
+        },
+        {
+            reason: 'no_results',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No PA project records found for the given filters.',
+            recovery: 'Verify the disaster has PA declared (pa_declared: true via fema_get_disaster) or check the state code. Recent disasters may have incomplete records.',
+        },
+    ],
+    async handler(input, ctx) {
+        if (!input.disaster_number && !input.state?.trim()) {
+            throw ctx.fail('missing_filter', 'Either disaster_number or state must be provided.', {
+                ...ctx.recoveryFor('missing_filter'),
+            });
+        }
+        const filterParts = [];
+        if (input.disaster_number) {
+            filterParts.push(`disasterNumber eq ${input.disaster_number}`);
+        }
+        if (input.state?.trim()) {
+            filterParts.push(`stateAbbreviation eq '${input.state}'`);
+        }
+        if (input.county?.trim()) {
+            filterParts.push(`substringof('${escapeODataString(input.county)}', county)`);
+        }
+        const svc = getOpenFemaService();
+        const { rows, count } = await svc.fetchPaProjects({
+            filter: filterParts.join(' and '),
+            orderby: 'totalObligated desc',
+            top: input.limit,
+            skip: input.offset,
+        }, ctx);
+        if (rows.length === 0) {
+            ctx.enrich.notice(`No Public Assistance projects found for the given filters. Verify the disaster has PA declared via fema_get_disaster.`);
+            throw ctx.fail('no_results', 'No PA project records found.', {
+                ...ctx.recoveryFor('no_results'),
+            });
+        }
+        const projects = rows.map((r) => ({
+            disaster_number: r.disasterNumber ?? 0,
+            ...(r.pwNumber ? { pw_number: r.pwNumber } : {}),
+            ...(r.applicantId ? { applicant_id: r.applicantId } : {}),
+            ...(r.applicationTitle ? { application_title: r.applicationTitle } : {}),
+            ...(r.damageCategoryCode ? { damage_category_code: r.damageCategoryCode } : {}),
+            ...(r.damageCategoryDescrip ? { damage_category_description: r.damageCategoryDescrip } : {}),
+            ...(r.projectAmount != null ? { project_amount: r.projectAmount } : {}),
+            ...(r.federalShareObligated != null
+                ? { federal_share_obligated: r.federalShareObligated }
+                : {}),
+            ...(r.totalObligated != null ? { total_obligated: r.totalObligated } : {}),
+            ...(r.county ? { county: r.county } : {}),
+            ...(r.stateAbbreviation ? { state: r.stateAbbreviation } : {}),
+            ...(r.projectStatus ? { project_status: r.projectStatus } : {}),
+            ...(r.projectSize ? { project_size: r.projectSize } : {}),
+            ...(r.firstObligationDate ? { first_obligation_date: r.firstObligationDate } : {}),
+        }));
+        ctx.log.info('PA projects fetch complete', { count, returned: projects.length });
+        return { projects, total_count: count, returned_count: projects.length };
+    },
+    format: (result) => {
+        const lines = [];
+        lines.push(`**${result.returned_count} of ${result.total_count} PA projects**\n`);
+        for (const p of result.projects) {
+            const title = p.application_title ?? `PW-${p.pw_number ?? 'unknown'}`;
+            lines.push(`## ${title}`);
+            lines.push(`**Disaster:** DR-${p.disaster_number}`);
+            if (p.applicant_id)
+                lines.push(`**Applicant ID:** ${p.applicant_id}`);
+            if (p.damage_category_code) {
+                lines.push(`**Damage Category:** ${p.damage_category_code}${p.damage_category_description ? ` — ${p.damage_category_description}` : ''}`);
+            }
+            if (p.total_obligated != null) {
+                lines.push(`**Total Obligated:** $${p.total_obligated.toLocaleString()}`);
+            }
+            if (p.federal_share_obligated != null) {
+                lines.push(`**Federal Share Obligated:** $${p.federal_share_obligated.toLocaleString()}`);
+            }
+            if (p.project_amount != null) {
+                lines.push(`**Project Amount:** $${p.project_amount.toLocaleString()}`);
+            }
+            const meta = [];
+            if (p.project_status)
+                meta.push(`Status: ${p.project_status}`);
+            if (p.project_size)
+                meta.push(`Size: ${p.project_size}`);
+            if (p.county)
+                meta.push(`County: ${p.county}`);
+            if (p.state)
+                meta.push(`State: ${p.state}`);
+            if (p.pw_number)
+                meta.push(`PW: ${p.pw_number}`);
+            if (meta.length > 0)
+                lines.push(meta.join(' | '));
+            if (p.first_obligation_date)
+                lines.push(`**First Obligated:** ${p.first_obligation_date}`);
+            lines.push('');
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=fema-get-public-assistance.tool.js.map

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

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

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

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview Tool: fema_query_dataset — generic OData query against any OpenFEMA v2 dataset.
+ * @module mcp-server/tools/definitions/fema-query-dataset
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const femaQueryDataset: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    dataset: z.ZodString;
+    filter: z.ZodOptional<z.ZodString>;
+    select: z.ZodOptional<z.ZodString>;
+    orderby: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    dataset: z.ZodString;
+    rows: z.ZodArray<z.ZodObject<{}, z.core.$loose>>;
+    total_count: z.ZodNumber;
+    returned_count: z.ZodNumber;
+}, z.core.$strip>, readonly [{
+    readonly reason: "unknown_dataset";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "Dataset name not recognized — API returned HTML 404 instead of JSON.";
+    readonly recovery: "Check the exact dataset entity name at https://www.fema.gov/about/openfema/data-sets. Names are case-sensitive (e.g., FimaNfipClaims not fimaNfipClaims).";
+}, {
+    readonly reason: "invalid_filter";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "OData filter expression could not be parsed by the API.";
+    readonly recovery: "Fix the OData $filter syntax. String values must use single quotes. Check field names against the dataset schema at the FEMA OpenFEMA portal.";
+}], {
+    readonly notice: z.ZodOptional<z.ZodString>;
+}>;
+//# sourceMappingURL=fema-query-dataset.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fema-query-dataset.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/fema-query-dataset.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,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;EAgJ3B,CAAC"}