Search Drinking Water Systems
epa_water_search_systemsDrinking water (SDWIS): Search public water systems by state, ZIP code, or county served. Returns system name, PWSID, population served, primary water source, and activity status, in PWSID order; page through a large match with offset and nextOffset. zip_code matches a system's address of record, often an owner's or operator's office far from the area it serves; county (with state) finds the systems serving an area. With has_violation, returns only systems with a current SDWA violation in EPA's ECHO, which applies EPA's Enforcement Response Policy, so it flags fewer systems than SDWIS's unresolved violation records. At least one of state or zip_code is required. Pass a returned pwsid as registry_id to epa_echo_get_facility for the system's drinking-water violations: contaminant, measured level, MCL, status, and enforcement actions.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "epa_water_search_systems"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Number of systems to return in one call. Default 25; a larger value returns at most 1,000 and says so. Page past it with offset and nextOffset. | |
| state | No | 2-letter US state or territory code (e.g. "WA", "CA"), or an EPA region code 01–10 for tribal systems, whose primacy agency is the EPA region | |
| county | No | County the system serves, e.g. "King"; requires state. Case-insensitive, and a trailing "County", "Parish", "Borough", "City and Borough", "Census Area", or "Municipality" is dropped, so "Anchorage" matches Anchorage Municipality. A system matches when one of the counties it serves is this county, so "Harris" does not match Harrison. Punctuation is matched as written ("St. Tammany"). | |
| offset | No | Number of systems to skip before this page (default 0). Pass the previous call's nextOffset to continue; a value past the end returns an empty page. | |
| pws_type | No | Filter by public water system type: community=permanent residences, non-transient=regular non-residents (schools, businesses), transient=occasional users (campgrounds) | |
| zip_code | No | 5-digit ZIP code of the water system's address of record — often its owner's or operator's office, which can be far from the area the system serves. Matches stored ZIP+4s within it; a ZIP+4 searches its 5-digit ZIP. Use county for the systems serving an area. | |
| active_only | No | When true, return only systems SDWIS lists as active (activity code A). The default false also returns inactive systems and ones changed to non-public. | |
| has_violation | No | When true, return only systems with a current SDWA violation in EPA's ECHO, its compliance status for the system, which clears violations SDWIS still lists as unresolved. Works with state, zip_code, county, or a combination. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present when the call failed. Absent on success. | |
| notice | No | Present when a check stopped early (a ZIP or county has_violation check hit 1,000 systems, or the county check its read limit); nextOffset continues. | |
| message | No | Recovery hint on an empty result; absent otherwise. | |
| systems | No | Matching systems, PWSID order | |
| guidance | No | Present when more systems may follow: the continuing offset. | |
| nextOffset | No | Next offset; absent on the last page. | |
| totalCount | No | Matches before limit and offset; present only when the call saw the whole match (offset 0 and no nextOffset, or a state has_violation search over ECHO's full violator list). | |
| limitNotice | No | Present when a smaller limit than requested applied; says why. | |
| effectiveQuery | No | The search as sent upstream, in input names: values, match modes, and result-changing defaults, "; "-joined. |