USGS Water Services

USGS Water Services MCP Connector for Claude

A+

Access real-time and historical water data from the USGS, including streamflow, groundwater levels, and site metadata across the US.

5 tools Official Updated Jun 28, 2026 Official Vinkius Partner

Connect to the USGS Water Services to retrieve comprehensive hydrological data directly from the United States Geological Survey. Monitor environmental conditions, analyze historical trends, and discover monitoring stations through natural language.

What you can do

  • Real-time Monitoring — Use get_instantaneous_values to fetch near real-time data (15-minute intervals) for streamflow, water levels, and quality.
  • Historical Analysis — Retrieve daily summaries (mean, median, max, min) using get_daily_values for long-term trend analysis.
  • Site Discovery — Search for monitoring stations using get_sites filtered by state, county, hydrologic unit (HUC), or geographic bounding box.
  • Statistical Reports — Generate daily, monthly, or annual statistics with get_statistics to understand hydrological patterns.
  • Groundwater Tracking — Access specialized groundwater level data using get_groundwater_levels for aquifer monitoring.

How it works

  1. Subscribe to this server
  2. This service accesses public USGS data; simply enter 'PUBLIC' as your access key to initialize
  3. Start querying water data from Claude, Cursor, or any MCP-compatible client

Who is this for?

  • Environmental Scientists — quickly gather field data and historical records for research and reporting
  • Engineers & Hydrologists — monitor streamflow and groundwater levels for infrastructure and flood planning
  • Outdoor Enthusiasts — check real-time river conditions for fishing, boating, or safety before heading out
hydrologyenvironmental-datawater-monitoringreal-time-datageospatial-dataclimate-science

5 tools expose this connector's capabilities to your AI agent.

get_daily_values

You MUST provide at least one major filter. Retrieve historical summarized daily data (mean, median, max, min)

get_groundwater_levels

You MUST provide at least one major filter. Retrieve historical manually-recorded groundwater levels

get_instantaneous_values

You MUST provide at least one major filter: sites, stateCd, huc, bBox, or countyCd. Retrieve near real-time water data (usually 15-minute intervals)

get_sites

Multiple major filters can be combined (AND logic). Search for USGS sites and metadata

get_statistics

Retrieve daily, monthly, or annual statistics based on approved data

See how to talk to your AI agent using USGS Water Services.

Search for all active USGS water monitoring sites in Florida.

I've found several active sites in Florida. For example, site 02236000 (ST. JOHNS RIVER NEAR COCOA, FL) and site 02248000 (ST. JOHNS RIVER NEAR DE LAND, FL). Would you like to see the full list or details for a specific one?

Get the last 7 days of water level data for site 08313000.

Retrieving data for site 08313000 (RIO GRANDE AT OTOWI BRIDGE, NM)... Over the last 7 days, the gage height has fluctuated between 3.12 and 3.45 feet. Would you like a more detailed breakdown of the 15-minute intervals?

What are the daily mean statistics for discharge at site 01646500?

For site 01646500 (POTOMAC RIVER NEAR WASH, DC), the daily mean discharge for today's date historically is 12,400 cubic feet per second (cfs). The record high for this day was 85,000 cfs in 1996.

Use the `get_sites` tool and provide the 2-digit USPS state code (e.g., 'CA' for California) in the `stateCd` parameter. This will return a list of sites and their metadata for that state.

Related Connectors