mcp · United States

USGS Water MCP

Query real-time and historical water data from ~8,000 USGS stream gages and groundwater wells via MCP. STDIO or Streamable HTTP.

Claim this listing

Represent USGS Water MCP? Send a claim for review so we can discuss listing updates. Claims do not automatically grant ownership or verification.

Data offered docs-verified: real-time instantaneous values (~15 min) for up to 100 sites · daily and instantaneous time series over a date range · current conditions ranked against period-of-record percentiles · site discovery by bounding box, state, county or HUC · site metadata (drainage area, altitude, HUC, coordinates) · groundwater depth to water level (parameter 72019) · discharge (00060) and gage height (00065) parameter codes · USGS parameter code catalog (~19,600 codes)
Coverage docs-verified: United States and territories
Resolution docs-verified: Temporal: ~15 min for instantaneous values; one value per day for daily series
Update frequency docs-verified: ~15 min real-time for instantaneous readings
Formats docs-verified: MCP JSON (structuredContent) · markdown (rendered tool text) · application/json (resources) · DuckDB table (DataCanvas spillover) · MCP stdio · MCP streamable HTTP
Access docs-verified: Free and public; no API key required. Licence: Apache-2.0. Self-hosting needs a local install (bunx, npx or Docker); a public hosted endpoint is also listed.

Use cases llm-inferred: FRA baseline flows from nearest gauge: find sites by bbox, then pull daily mean discharge (00060) for the baseline period · Current conditions check at gauges during a flood or drought review, using percentile ranking as indicative only · Groundwater depth baseline from monitoring wells via parameter 72019 · Monitoring site inventory for a catchment by HUC code, filtered to sites with instantaneous data
Audience llm-inferred: hydrologists · flood risk consultants · drainage engineers · GIS analysts · ecologists (groundwater and surface water baselines)

Constraints llm-inferred: Covers US and territories only; no UK data · Percentile ranking is approximate and is not a flood-stage or drought determination · Readings return up to 100 sites per call, with at most 100 series and the 10 most recent records per series · Series inline output is capped at 500 records; larger results need CANVAS_PROVIDER_TYPE=duckdb · Dataframe tools and spillover require CANVAS_PROVIDER_TYPE=duckdb; table drop is opt-in via WATER_DATAFRAME_DROP_ENABLED · Pre-1.0 release (v0.3.0), so the interface may change · Relies on the USGS NWIS service being available; upstream failures are returned as retryable errors · Public hosted endpoint is not operated by USGS and has no stated uptime guarantee

Licence: Apache-2.0
Authentication: No API key required (repository README; check upstream requirements)
GitHub stars: 1
Last commit: 04/10/2026
Last successful page check: 14/10/2026
Page health: healthy
Package: Not recorded
Verification: Not independently verified

Auto-extracted, unverified fields: tools, install. Check upstream documentation.

GitHub metadata observed via gh api. Authentication unknown unless README explicitly states it; review upstream access.

Metadata observed 14/10/2026 · editorial seed