API access
Your AI client reaches USACE National Inventory of Dams through one ParcelOps MCP endpoint, so there is no separate key to hold for it and no per-source client to write. Reaching it takes no credentials of your own.
Where it came from
Freshness and coverage
What this source cannot tell you
- ⚠ Anything outside United States: the 50 states, Puerto Rico, and Guam publish National Inventory of Dams records and No records at all for the District of Columbia, the U.S. Virgin Islands, American Samoa, and the Northern Mariana Islands. A request past that edge comes back empty rather than approximated.
- ⚠ Structures span from nineteenth-century dams to current completions. Condition assessment, inspection, and emergency action plan dates are per record and are frequently older than the layer refresh.
- ⚠ Anything USACE National Inventory of Dams (NGDA), hosted feature layer does not publish. ParcelOps returns this source as it stands and never fills a blank field from a different one.
- ⚠ Proximity to a dam is not an inundation risk finding. Hazard potential classification describes the consequence of a failure for people and property downstream, not the probability of failure and not whether a given point is in the failure path.
- ⚠ Downstream inundation depends on terrain, breach behaviour, reservoir level, and warning time. The National Inventory of Dams does not model or publish inundation extents in this layer, so nothing this connector returns places a property inside or outside a dam failure inundation area.
- ⚠ Never present a dam list as a flood determination. Flood zone comes from the FEMA National Flood Hazard Layer through the floodzone connector, and most dam failure inundation areas are not mapped as special flood hazard areas.
- ⚠ This connector cannot tell upstream from downstream. It sorts by straight-line distance from the coordinates supplied, so a dam across a ridge and a dam on the same creek read identically.
- ⚠ Hazard potential and condition assessment are different facts. A high hazard dam rated Satisfactory is ordinary; a Poor or Unsatisfactory condition assessment on any hazard class is the signal worth escalating.
- ⚠ Emergency action plan status is blank on the overwhelming majority of records. The layer publishes only Yes and Not Required, never No, so a blank is an unreported field and is never evidence that no plan exists.
- ⚠ Condition assessment is unreported on roughly one dam in five, and operational status on most. A blank is an unreported field, not a clean bill of health.
- ⚠ The inventory lists dams that would risk life or critical facilities on failure, plus dams roughly at or above 25 feet high with more than 15 acre-feet of storage or above 50 acre-feet of storage and more than 6 feet high. Farm ponds and stock tanks below those thresholds are absent, and USACE states the inventory does not yet contain every dam meeting its own criteria.
- ⚠ Inspection reports, engineering drawings, breach studies, and emergency action plan mapping are held by the state dam safety office named in stateRegulatoryAgency or by the federal owner, and are not exposed here.
- ⚠ The USACE-hosted Dams_Public FeatureServer requires a token, so this connector reads the keyless Esri Federal hosted mirror of the same NGDA source instead.
Methods (4)
A method is one call your agent can make against this source.
findDamsNearPoint
readListed dams near coordinates, nearest first, with a hazard class rollup.
What you must providelatitudelongitudeRecords returneddamHow to get more resultsoffset (offsetField: offset, limitField: limit)UnitsdistanceMiles: statute miles from the supplied coordinates · damHeightFeet: feet · nidStorageAcreFeet: acre-feet · maximumStorageAcreFeet: acre-feet · surfaceAreaAcres: acres · drainageAreaSquareMiles: square milesCoordinate systemEPSG:4326FreshnessScheduled · every 7 days (source-level)Input schema
{ "type": "object", "properties": { "latitude": { "type": "number", "minimum": -90, "maximum": 90 }, "longitude": { "type": "number", "minimum": -180, "maximum": 180 }, "radiusMiles": { "type": "number", "minimum": 0.1, "maximum": 25 }, "hazardPotential": { "type": "string", "enum": [ "High", "Significant", "Low", "Undetermined" ], "description": "Consequence class if the dam failed. Not a probability and not a site finding." }, "minStorageAcreFeet": { "type": "number", "minimum": 0, "description": "Minimum NID storage in acre-feet. Drops small impoundments." }, "limit": { "type": "integer", "minimum": 1, "maximum": 200 }, "offset": { "type": "integer", "minimum": 0, "maximum": 2000 } }, "required": [ "latitude", "longitude" ], "additionalProperties": false }- ⚠ hazardSummary counts every dam matching the query, not only the returned page.
- ⚠ A dam inside the radius may have no hydraulic connection to the site. Straight-line distance is not a flow path.
- ⚠ If the question is really flood exposure, this is the wrong answer to give: dam proximity is not inundation, and flood zone comes from the FEMA flood hazard layer through the floodzone connector.
distanceMiles is from the point given, never from a parcel line.
getDamDetail
readFull inventory record for one dam by its National Inventory of Dams identifier.
What you must providenidIdRecords returneddamHow to get more resultsnoneCoordinate systemEPSG:4326FreshnessScheduled · every 7 days (source-level)Input schema
{ "type": "object", "properties": { "nidId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{3,24}$", "description": "State-prefixed identifier such as TX09668." } }, "required": [ "nidId" ], "additionalProperties": false }- ⚠ A null field is an unreported value, never a zero.
- ⚠ Condition and inspection dates are as reported by the regulator and are often years old.
Adds engineering, spillway, lock, and authority fields.
searchDamsByCounty
readListed dams in one county or parish, with a hazard class rollup.
What you must providestatecountyRecords returneddamHow to get more resultsoffset (offsetField: offset, limitField: limit)Coordinate systemEPSG:4326FreshnessScheduled · every 7 days (source-level)Input schema
{ "type": "object", "properties": { "state": { "type": "string", "minLength": 2, "maxLength": 40, "description": "Two-letter code such as TX, or the full name such as Texas." }, "county": { "type": "string", "minLength": 2, "maxLength": 80, "description": "County, parish, borough, or census area name. A County or Parish suffix is stripped." }, "hazardPotential": { "type": "string", "enum": [ "High", "Significant", "Low", "Undetermined" ], "description": "Consequence class if the dam failed. Not a probability and not a site finding." }, "minStorageAcreFeet": { "type": "number", "minimum": 0, "description": "Minimum NID storage in acre-feet. Drops small impoundments." }, "limit": { "type": "integer", "minimum": 1, "maximum": 200 }, "offset": { "type": "integer", "minimum": 0, "maximum": 2000 } }, "required": [ "state", "county" ], "additionalProperties": false }- ⚠ A county name the layer does not carry returns the same empty result as a county with no listed dams, so the result states the exact value that was matched.
Ordered by identifier, not by distance from anything.
getServiceInfo
readLayer URL, licence, coverage, vocabularies, units, and what this connector does not expose.
Records returneddata_sourceHow to get more resultsnoneFreshnessScheduled · every 7 days (source-level)Input schema
{ "type": "object", "properties": {}, "required": [], "additionalProperties": false }States the inundation and inspection gaps machine-readably.
Where this source is used
- Land research
Parcel records, ground conditions, and what reaches the property line, for raw and rural land.
- Data center siting
Power, water, transport, airspace, and hazard screening for a site before anyone signs anything.
- Commercial real estate
Parcel and assessment records, building programs, and the entity on the other side of the deal.
- Residential real estate
The parcel record, the housing programs that touch an address, and the conditions a buyer asks about.
- Real estate law
Federal rule text, rulemaking dockets, party records, and the property facts a filing has to state.
- Realtors and brokerages
The facts behind a listing, the programs a buyer may qualify for, and your own files in the same place.
- Is there a dam near this property?
