{"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\":[]}}","token":"eyJhbGciOiJSUzI1NiIsImtpZCI6IjM4ODI2YjE3LTZhMzAtNWY5Yi1iMTY5LThiZWI4MjAyZjcyMyIsInR5cCI6IkpXVCIsIng1dCI6InlrTmFZNHFNX3RhNGsyVGdaT0NFWUxrY1lsQSJ9.eyJhY3RvciI6Iml0c0hhZGRhZCIsImFjdG9yX2lkIjoiMTE0NzMyNjEiLCJhdWQiOiJicmFncHJvb2YtcmVwb3J0OmM4NGQ2MzllYzQxZWFjZTdmM2VhZDlkZGNhZDViMDA4ZjczNTI3NDQ4OWI5ODAzZmI0NWE1MTk0N2IxMDRjNDAiLCJiYXNlX3JlZiI6IiIsImNoZWNrX3J1bl9pZCI6IjEzMzI2Mzk5NTYwNyIsImV2ZW50X25hbWUiOiJzY2hlZHVsZSIsImV4cCI6MTc5NDgyOTg3NywiaGVhZF9yZWYiOiIiLCJpYXQiOjE3OTQ4Mjk1NzcsImlzcyI6Imh0dHBzOi8vdG9rZW4uYWN0aW9ucy5naXRodWJ1c2VyY29udGVudC5jb20iLCJqb2Jfd29ya2Zsb3dfcmVmIjoiaXRzSGFkZGFkL2JyYWdwcm9vZi8uZ2l0aHViL3dvcmtmbG93cy9yZXBvcnQueW1sQHJlZnMvaGVhZHMvbWFpbiIsImpvYl93b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIiwianRpIjoiNWVmYjMzNzUtMzQzMC00YTUzLThkMTItODk3Y2I1YWNlZTk5IiwibmJmIjoxNzk0ODI5Mjc3LCJyZWYiOiJyZWZzL2hlYWRzL21haW4iLCJyZWZfcHJvdGVjdGVkIjoiZmFsc2UiLCJyZWZfdHlwZSI6ImJyYW5jaCIsInJlcG9zaXRvcnkiOiJpdHNIYWRkYWQvYnJhZ3Byb29mIiwicmVwb3NpdG9yeV9pZCI6IjE0NTQ2MjExODMiLCJyZXBvc2l0b3J5X293bmVyIjoiaXRzSGFkZGFkIiwicmVwb3NpdG9yeV9vd25lcl9pZCI6IjExNDczMjYxIiwicmVwb3NpdG9yeV92aXNpYmlsaXR5IjoicHVibGljIiwicnVuX2F0dGVtcHQiOiIxIiwicnVuX2lkIjoiNDM4NTcwNzAyMTYiLCJydW5fbnVtYmVyIjoiMjQiLCJydW5uZXJfZW52aXJvbm1lbnQiOiJnaXRodWItaG9zdGVkIiwic2hhIjoiZWFhZmZmZmFmNTIyNTVkMWI3N2RjNGFhY2ZmZGZhZjM1M2YwYzEyYyIsInN1YiI6InJlcG86aXRzSGFkZGFkQDExNDczMjYxL2JyYWdwcm9vZkAxNDU0NjIxMTgzOnJlZjpyZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvdyI6InJlcG9ydCIsIndvcmtmbG93X3JlZiI6Iml0c0hhZGRhZC9icmFncHJvb2YvLmdpdGh1Yi93b3JrZmxvd3MvcmVwb3J0LnltbEByZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIn0.uTsOmCg0adz23dnNUMornwktEOgSgu_AV1LfWusPzUvoZ0UIAtHfwbyMYIYCX8A5Oaeeice1B-y9e61_kv1HAfKT75EapGVU7ETr6nn-95KPSPXUB2ggrE31DxbMPBG7W0sGOIaxmoh7uDq2Rbcj0y86p7EvMLdXyrZcwHpNjVwONnRupAs2oTTmjqbcLnVDq-kqkUjs5iFNH5W6EEs_qVsFKcKZH3p7ysJ0dORNvCsSLXp6FW9cCvyf6YW9gnGhi0mVBgw6QKUQrX4LBdKn05o9VyOFIIEPRY2A3hDcLFNRCFOvM8OH0K_teKMxzsAwW7PIdGehidZXOnHSSAtIvg"}