usgs-water-mcp-server
Query real-time and historical USGS water data from ~8,000 stream gages and groundwater wells
Reviews
No review yet. Used usgs-water-mcp-server? Be the first to help others choose.What it does
usgs-water-mcp-server is an MCP server, a connector that lets an AI assistant use it as a tool. It can be used hosted (nothing to install) or installed locally.
No capability identified yet from its description.
Facts come from the Official MCP Registry, as declared by the publisher. Capabilities are matched automatically (low confidence). None of this is a test of the tool.
At a glance
How to connect
As declared in the Official MCP Registry · hosted endpoint tested by Electra Index 1d ago (live check)Hosted endpoint
https://usgs-water.caseyjhand.com/mcpstreamable-http
In Claude Code: claude mcp add --transport http usgs-water-mcp-server https://usgs-water.caseyjhand.com/mcp
Install packages
- NPM
@cyanheads/usgs-water-mcp-serverv0.6.0 · runs locally (stdio) - NPM
@cyanheads/usgs-water-mcp-serverv0.6.0 · runs as a server (streamable-http)
MCP settings (Claude Desktop, Cursor and other MCP clients)
{
"mcpServers": {
"usgs-water-mcp-server": {
"url": "https://usgs-water.caseyjhand.com/mcp"
}
}
}Live check
Electra Index connected to the hosted endpoint 1d agoONLINE usgs-water-mcp-server answered an MCP connection on 16 Nov 2026 and introduced itself as usgs-water-mcp-server 0.6.0 (MCP protocol 2025-06-18).
8 tools offered to AI assistants
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 table (no network call): 00060 = "Dischargewater_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, the UTC time each site last reported (lastOwater_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. Omitting parameterCd returns every parameter ewater_get_series· Get a daily or instantaneous time series for one USGS site and parameter over a date range, as time-ordered value records. A site can hold several series for one query — one per daily statistic (mean, maximum, minimum) and one per sensor (mwater_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 may contain gaps and lag observations. Fowater_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 flood-stage or drought determination (twater_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) → water_dataframe_describe (confirm the tabwater_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 column types before writing a query. Then
What "online" means: the server answered an MCP connection at the time of the check. It is not a guarantee of security, quality or continuous uptime. How we test: we open an MCP session and ask for the tool list, as an AI assistant would. We never run a tool and never send a key. Checked every few days. Method
Is this your server? Monitoring Pro: a check every 30 minutes and an email within the hour when it stops answering. Launch offer: $39.99 once, for life.
Facts & evidence
Each fact shows where it was seen and when.| Fact | Value | Evidence | Source | Last confirmed |
|---|---|---|---|---|
| Install package | @cyanheads/usgs-water-mcp-server, @cyanheads/usgs-water-mcp-server | DECLARED | SRC-001 Official MCP Registry | 1d ago |
| Version | 0.6.0 | DECLARED | SRC-001 Official MCP Registry | 1d ago |
| Hosted endpoint | https://usgs-water.caseyjhand.com/mcp | DECLARED | SRC-001 Official MCP Registry | 1d ago |
| Package registries | npm | DECLARED | SRC-001 Official MCP Registry | 1d ago |
| Local install (package) | yes | DECLARED | SRC-001 Official MCP Registry | 1d ago |
| Remote access (hosted) | yes | DECLARED | SRC-001 Official MCP Registry | 1d ago |
| Repository | https://github.com/cyanheads/usgs-water-mcp-server | DECLARED | SRC-001 Official MCP Registry | 1d ago |
| Registry status | active | DECLARED | SRC-001 Official MCP Registry | 1d ago |
| MCP server | yes | DECLARED | SRC-001 Official MCP Registry | 1d ago |
Change history
- VERSION11 Nov 20260.5.0 → 0.6.0
- VERSION29 Oct 20260.4.0 → 0.5.0
- VERSION20 Oct 20260.3.0 → 0.4.0
- VERSION04 Oct 20260.2.6 → 0.3.0
Is this page accurate?
Flag it and our robot re-checks the official source. Reports never change a score.Is usgs-water-mcp-server still online?
Free alerts · no account▲ 0Do you run usgs-water-mcp-server? Know when it stops answering
For publishers · optionalIts hosted endpoint can be monitored. Monitoring Pro connects every 30 minutes like an AI assistant, emails you within the hour when it stops answering, keeps a 90-day availability history and adds your answer rate to your badge.
Monitoring never changes a score or a rank.
Questions about usgs-water-mcp-server
How do I connect usgs-water-mcp-server?
Use the hosted endpoint https://usgs-water.caseyjhand.com/mcp in your assistant's MCP settings. The exact settings are in "How to connect" above, as declared in the Official MCP Registry.
What tools does usgs-water-mcp-server offer?
When Electra Index connected on 16 Nov 2026, it listed 8 tools: water_list_parameters, water_find_sites, water_get_readings, water_get_series, water_get_site_data_catalog, water_get_conditions, water_dataframe_query, water_dataframe_describe. The full list is in "Live check" above.
Is usgs-water-mcp-server online?
Yes. Its hosted endpoint answered an MCP connection from Electra Index 1d ago.