Inspect current US sensor readings with parameter codes, time stamps and quality flags. Compare listed sources, access requirements and evidence for us nwis instantaneous values.
3 sources · For GIS analysts, hydrologists, drainage engineers, ecologists (groundwater and surface water baselines), environmental scientists, flood consultants, flood risk consultants, water quality specialists. Enrichment describes potential applications; review source evidence and limitations.
Legacy NWIS access may differ from modern water-data APIs; verify the current service before integration.
Discover sources with MCP
Add this server to an HTTP-compatible MCP client, then call get_source to inspect the first source. The tool call is shown separately from the client configuration. Review upstream access details before requesting data.
USGS water observations and monitoring-location metadata through modern water-data APIs.
What's in it
Data offered docs-verified
continuous sensor measurements · daily values · time series metadata · monitoring-location metadata · water quality samples · discrete water-quality data (Water Quality Portal) · gaging-station imagery (NIMS) · daily, monthly and annual statistics
Coverage llm-inferred
United States
Formats docs-verified
OGC API · STAC
Access docs-verified
Free to use; API key optional for higher rate limits. Licence not stated.
Useful for
Use cases llm-inferred
Baseline river flow and gauge record review for FRA inputs from nearest USGS gauge (US sites only) · Flood event analysis from continuous sensor records at gauged catchments · Water quality baseline sampling review for environmental assessment (US sites only) · Gauge camera imagery for site visit verification and condition checks
Covers United States monitoring locations only; not applicable to UK sites · Rate limits apply without an API key · Licence not specified in catalogue metadata · Multiple API families (OGC, STAC, legacy Water Services, NIMS) may require different query patterns · NIMS imagery requires constructing full image URLs from camera base paths and returned filenames
Query real-time and historical water data from ~8,000 USGS stream gages and groundwater wells via MCP. STDIO or Streamable HTTP.
What's in it
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
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.
Useful for
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)
Limitations
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
Which listed sources support US NWIS instantaneous values?
Start with USGS NWIS Instantaneous Values, USGS Water Data API, USGS Water MCP. Inspect current US sensor readings with parameter codes, time stamps and quality flags.
What should I check before using these sources for us nwis instantaneous values?
Legacy NWIS access may differ from modern water-data APIs; verify the current service before integration.
How do I inspect USGS NWIS Instantaneous Values through MCP?
Connect an MCP client to https://terramcp.earth/mcp and call get_source with slug usgs-nwis-instantaneous-values. Review its provenance, access requirements and limitations before contacting the upstream service. Discovery does not make every listed source directly executable through the router.
Are these sources free and independently verified?
Access and licence terms belong to each upstream provider; some products require registration or payment. Open each listing for evidence, health status and enrichment provenance. A wrapper and its underlying API can refer to the same dataset and are not independent observations.