WQP Tools Reference

Complete reference for EPA Water Quality Portal MCP tools.

Available Tools

The WQP service provides the following MCP tools:

• wqp.station_search — Search monitoring stations (sites) by location, characteristic, or site id
• wqp.result_search — Search sample results by location, characteristic, or date range

Tool Details

wqp.station_search

Search water quality monitoring stations. At least one search parameter is required.

Arguments:

• bBox (optional): Bounding box — west,south,east,north decimal degrees WGS84
• statecode (optional): FIPS state (e.g. US:40 for Oklahoma)
• countycode (optional): FIPS county (e.g. US:40:109)
• countrycode (optional): FIPS country code
• siteid (optional): Agency-siteId (e.g. USGS-07144100)
• characteristicName (optional): e.g. Atrazine
• characteristicType (optional): e.g. Nutrient
• mimeType (optional): Default csv
• providers (optional): Comma-separated or array — e.g. NWIS, STORET
• data_format (optional): "cleaned" (default) or "raw"

Returns: With data_format: "cleaned" — { rows: [...], count: N, source_url }. With "raw" — { raw: "<csv string>", mimeType, source_url }.

wqp.result_search

Search water quality sample results. At least one search parameter is required.

Arguments:

• bBox (optional): Bounding box — west,south,east,north decimal degrees WGS84
• statecode (optional): FIPS state (e.g. US:40)
• countycode (optional): FIPS county (e.g. US:40:109)
• countrycode (optional): FIPS country code
• siteid (optional): Agency-siteId
• characteristicName (optional): e.g. Caffeine
• characteristicType (optional): e.g. Nutrient
• startDateLo (optional): Start date MM-DD-YYYY
• startDateHi (optional): End date MM-DD-YYYY
• mimeType (optional): Default csv
• providers (optional): NWIS, STORET
• dataProfile (optional): e.g. fullPhysChem, narrow, biological
• data_format (optional): "cleaned" (default) or "raw"

Returns: Same structure as wqp.station_search — cleaned rows or raw CSV.

Examples

See the WQP Examples page for usage examples.