Geocode the property address to a latitude/longitude coordinate pair using a geocoding service; accuracy to street-level is required for meaningful flood zone results
Query the FEMA NFHL ArcGIS REST API at the S_Fld_Haz_Ar (Special Flood Hazard Area) layer endpoint, passing the coordinate as a point geometry with the appropriate spatial reference (WKID 4326 for WGS84)
Parse the fld_zone field in the response: zones beginning with 'A' or 'V' indicate Special Flood Hazard Areas (high risk, 1% annual chance); zone 'X' indicates moderate or minimal risk; 'D' indicates undetermined risk
Also read the floodway and BFE (Base Flood Elevation) fields where present to support underwriting decisions or mandatory purchase requirement determinations
Cache results with the DFIRM panel ID and effective date; re-query when a LOMA (Letter of Map Amendment) or map revision may have updated the panel
Known gotchas
NFHL digital data covers over 90% of the U.S. population but not all parcels; a null response does not mean low risk—it may mean the area has not been mapped, and you must flag it accordingly
Point-in-polygon queries are sensitive to coordinate precision; a parcel near a flood zone boundary may return different results depending on whether the centroid or a specific corner is used—consider querying the full parcel polygon
FEMA map panels are updated on a rolling basis; the effective date field in the response indicates when the panel was last revised, and a newly issued Flood Insurance Rate Map (FIRM) may supersede cached results
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp