{"report":{"v":1,"package":"@cyanheads/fema-mcp-server","version":"0.5.1","ranAt":"2026-11-16T11:45:59.199Z","install":{"ok":true,"integrity":"sha512-TaM9OOLRc/luY/u7hEFTp8wKYgRO8UUQaMbDWbZMfIT/vxcR9PJPwt5t7ir5P6Tpn/ocKCPcJNnAUijI2aVpXA==","deps":47,"scripts":[],"bins":["fema-mcp-server"],"license":"Apache-2.0","engines":"node >=24.0.0","repository":"git+https://github.com/cyanheads/fema-mcp-server.git","bin":"fema-mcp-server"},"start":{"ok":true,"ms":300,"serverName":"fema-mcp-server","serverVersion":"0.5.1","protocol":"2025-06-18","stderr":"(from fema_search_disasters) or state (2-letter code) to scope the query.\"},\"reason\":\"missing_filter\",\"originalErrorName\":\"McpError\",\"originalMessage\":\"Either disaster_number or state must be provided.\"},\"stack\":\"McpError: Either disaster_number or state must be provided.\\n    at Object.handler (file:///app/node_modules/@cyanheads/fema-mcp-server/dist/mcp-server/tools/definitions/fema-get-public-assistance.tool.js:208:23)\\n    at measureToolExecution (file:///app/node_modules/@cyanheads/mcp-ts-core/dist/mcp-server/tools/utils/toolHandlerFactory.js:84:53)\\n    at file:///app/node_modules/@cyanheads/mcp-ts-core/dist/utils/internal/performance.js:197:34\\n    at NoopContextManager.with (file:///app/node_modules/@opentelemetry/api/dist/context/NoopContextManager.mjs:8:13)\\n    at ContextAPI.with (file:///app/node_modules/@opentelemetry/api/dist/api/context.mjs:46:40)\\n    at NoopTracer.startActiveSpan (file:///app/node_modules/@opentelemetry/api/dist/trace/NoopTracer.mjs:35:25)\\n    at ProxyTracer.startActiveSpan (file:///app/node_modules/@opentelemetry/api/dist/trace/ProxyTracer.mjs:21:18)\\n    at measure (file:///app/node_modules/@cyanheads/mcp-ts-core/dist/utils/internal/performance.js:166:25)\\n    at measureToolExecution (file:///app/node_modules/@cyanheads/mcp-ts-core/dist/utils/internal/performance.js:305:18)\\n    at file:///app/node_modules/@cyanheads/mcp-ts-core/dist/mcp-server/tools/utils/toolHandlerFactory.js:79:26\",\"jsonRpcId\":4,\"toolName\":\"fema_get_public_assistance\",\"msg\":\"Error in tool:fema_get_public_assistance: Either disaster_number or state must be provided.\"}\n"},"tools":[{"name":"fema_search_disasters","description":"Search federal disaster declarations by title, state, incident type, declaration type, date range, and county. Returns deduplicated declaration-level summaries — each disaster number appears once with a designated_area_count showing how many counties/municipalities were designated. The disaster number is the chain key for fema_get_disaster, fema_get_public_assistance, and fema_get_housing_assistance. Use declaration_type to filter: DR (major disaster, most common), EM (emergency), FM (fire management). Date filters apply to the declaration date. Use fema_get_disaster to retrieve all designated-area rows for a specific declaration. county selects the declarations that designated a matching area; their area counts and program flags still describe the whole declaration, and matched_areas lists the matching areas with their own program flags. A search reads the most recent 10,000 designated-area rows; when more match, it returns the declarations dated after the day that window ends, sets truncated, and its notice names the date_to that continues with older declarations. A page holds at most 100,000 characters of declarations; when declarations remain past it, next_offset is the offset to continue from.","params":["title","state","incident_type","declaration_type","date_from","date_to","county","limit","offset"]},{"name":"fema_get_disaster","description":"Fetch up to 1,000 designated-area rows for a specific FEMA disaster by disaster number (e.g., 4781). Discloses partial area and program coverage when more rows exist. Returns counties/municipalities along with programs observed, 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.","params":["disaster_number"]},{"name":"fema_get_public_assistance","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). A page holds at most 100,000 characters of projects; when projects remain past it, next_offset is the offset to continue from.","params":["disaster_number","state","county","limit","offset"]},{"name":"fema_get_housing_assistance","description":"Retrieve Individual Assistance (IA) housing data for a disaster by disaster number. Returns owner and/or renter records aggregated by county, city, and ZIP code — valid registrations, total approved IHP amounts, repair/rental/other-needs amounts, and inspection counts (owners also carry inspected damage in USD). Narrow with state, county, or zip_code; owners_count, renters_count, and offset then count the filtered records. Use type to select owners, renters, or both (default). A page holds at most 100,000 characters of records, owners and renters cut at the same row count so one offset continues both; when records remain past it, next_offset is the offset to continue from. Use disaster_number from fema_search_disasters.","params":["disaster_number","state","county","zip_code","type","limit","offset"]},{"name":"fema_search_nfip","description":"Search National Flood Insurance Program (NFIP) claims data by state, county, ZIP code, and year range. Returns the matching claim count and claim records — amounts paid on building and contents, damage estimates, flood zones, cause and occupancy codes, and loss dates — newest loss first. state is required — the full NFIP dataset is 2.7 million rows; unfiltered access is prohibited. Page the inline claims with limit and offset; a page holds at most 100,000 characters of claims, and while claims remain past it, next_offset is the offset to continue from. When DataCanvas is enabled and the match exceeds that inline budget, a call at offset 0 stages the match (up to 50,000 claims) on a canvas: inspect the staged table with fema_dataframe_describe, then aggregate it with SQL via fema_dataframe_query.","params":["state","county_code","zip_code","year_from","year_to","limit","offset","canvas_id"]},{"name":"fema_dataframe_query","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. A response holds at most 100,000 characters of rows; when it holds fewer rows than the query returned, truncated and shown are set and the notice says how to page with OFFSET.","params":["canvas_id","query"]},{"name":"fema_dataframe_describe","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. Row count reflects what was actually staged — check truncated in the fema_search_nfip response to know whether the canvas holds the full matching set.","params":["canvas_id"]},{"name":"fema_query_dataset","description":"Generic OData query against any dataset in the OpenFEMA dataset catalog — the escape hatch for datasets the convenience tools do not cover (e.g., NfipPolicies, IndividualAssistanceHousingRegistrantsLargeDisasters, FemaWebDeclarationAreas, PublicAssistanceApplicants). Accepts raw OData filter, select, orderby, and pagination parameters. For NfipPolicies, use propertyState (not state) for the state and reportedZipCode for the ZIP code — it has no countyCode; always include a ZIP filter to avoid timeout. The dataset name must match the exact OpenFEMA entity name (case-sensitive, e.g., NfipClaims). Names missing from the catalog return an unknown_dataset error; a listed dataset OpenFEMA does not serve through the API, or a retired version, returns dataset_not_served. A page holds at most 100,000 characters of records; when records remain past it, next_offset is the offset to continue from.","params":["dataset","filter","select","orderby","limit","offset"]}],"toolsHash":"0c0370b6a4f1f4cf1864b29296bf9ab3e2609da6fd96a4c952ebd68e18c46229","wrote":[],"callsAt":"2026-11-16T11:46:10.225Z","calls":[{"tool":"fema_search_disasters","ok":true,"ms":1901,"bytes":12433},{"tool":"fema_get_public_assistance","ok":false,"ms":5,"bytes":0,"error":"tool reported an error: Error: Either disaster_number or state must be provided.\n\nRecovery: Provide at least one of disaster_number (from fema_search_disasters) or state (2-letter code) to scope the query.\n\n(reason missing_f"}],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[],"callNames":["www.fema.gov"],"callConns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[],"tools":8,"wrote":0,"callsTried":2,"callsAnswered":1,"callContacts":["www.fema.gov"]},"history":[{"package":"@cyanheads/fema-mcp-server","version":"0.5.1","ranAt":"2026-11-16T11:45:59.199Z","outcome":"started","tools":8,"contacts":0,"flags":0,"serious":0,"toolsHash":"0c0370b6a4f1f4cf1864b29296bf9ab3e2609da6fd96a4c952ebd68e18c46229"}],"page":"https://bragproof.smaverk.com/r/%40cyanheads/fema-mcp-server"}