Back to search
100
MCP live MCP 2026-07-28 http

usgs-water-mcp-server

io.github.cyanheads/usgs-water-mcp-server

Query real-time and historical USGS water data from ~8,000 stream gages and groundwater wells.

Watch this dependency

Get before/after evidence when observed tools, schemas, authentication access, availability or the endpoint changes.

Inspect evidence and set up a watch Share public evidence report
Uptime
100.0%
4 direct probes · 30d
Response
1231ms
last probe
Tools
8
callable
Resources
4
readable
Prompts
0
available
Primary URL
https://usgs-water.caseyjhand.com/mcp
Score: 100/100
Handshake verified by our own probe.
why this score
pass Answers the MCP handshake 50/50
The handshake and the list calls succeeded on the primary URL.
pass Lists tools, resources or prompts 30/30
8 tools, 4 resources, 0 prompts returned.
pass 3 or more catalogue items 10/10
12 items in total; 3 or more earns these points.
pass Describes itself 10/10
94 characters; more than 30 earns these points.

Tools · 8

water_list_parameters

Look up USGS parameter codes — the 5-digit codes every other tool's parameterCd takes. With no query, lists a curated set of well-known codes with names, units, and thematic group, from a built-in tab…

water_find_sites

Find USGS water monitoring sites by bounding box, state, county, or HUC watershed code, filtered by site type and parameter availability. Returns site numbers, names, coordinates, types, altitude, and…

water_get_readings

Get the latest instantaneous (~15-min, real-time) values for up to 100 USGS sites in one call — per-site, per-parameter records with timestamp, value, unit, and provisional/approved qualifiers. Omitti…

water_get_series

Get a daily or instantaneous time series for one USGS site and parameter over a date range, as time-ordered value records. NWIS can hold several series for one query — one per daily statistic (mean, m…

water_get_site_data_catalog

Discover a USGS site’s parameters, sensors, statistics, and UTC record bounds before calling water_get_series. Find site numbers with water_find_sites. Each row is a distinct series; metadata bounds m…

water_get_conditions

Get a USGS site's current reading ranked against its full period-of-record daily-mean percentiles for the same calendar day — a "how unusual is this" percentileClass (record-high to record-low), not a…

water_dataframe_query

Run a read-only SQL SELECT against water data tables staged on a DataCanvas by water_get_series or water_find_sites. Workflow: run water_get_series or water_find_sites (get canvas_id + table_name) → w…

water_dataframe_describe

List tables and columns staged on a DataCanvas by water_get_series or water_find_sites. Call this after water_get_series or water_find_sites returns a canvas_id to discover the exact table name and co…

Resources · 4

usgs-water-parameters

Curated table of well-known USGS parameter codes — the codes most requests use (discharge, gage height, water temperature, groundwater levels, common water-quality measures), with human-readable names…

usgs-water://parameters
Potomac River at Little Falls, MD

Site metadata for a USGS monitoring site: name, coordinates, type, HUC watershed code, state, county, drainage area, and altitude. Use water_find_sites to discover site numbers.

usgs-water://site/01646500
Willamette River at Portland, OR

Site metadata for a USGS monitoring site: name, coordinates, type, HUC watershed code, state, county, drainage area, and altitude. Use water_find_sites to discover site numbers.

usgs-water://site/14211720
Colorado River at Lees Ferry, AZ

Site metadata for a USGS monitoring site: name, coordinates, type, HUC watershed code, state, county, drainage area, and altitude. Use water_find_sites to discover site numbers.

usgs-water://site/09380000

How to use

Add to your Claude Desktop / Cursor / Cline MCP config:

{
  "mcpServers": {
    "usgs-water-mcp-server": {
      "url": "https://usgs-water.caseyjhand.com/mcp",
      "transport": "http"
    }
  }
}