usgs-water-mcp-server — Claude Code MCP server: features and setup
The usgs-water-mcp-server MCP server for Claude Code finds USGS monitoring sites and retrieves current or past water data for streamflow and groundwater analysis in the United States.
Apache-2.0 1,402 installs ★ 3 updated 2026-10-20
claude mcp add --transport http usgs-water-mcp-server https://usgs-water-mcp-server--cyanheads.run.toolsWhat usgs-water-mcp-server does
This MCP server gives an agent access to observations from about 8,000 USGS stream gages and groundwater wells. It can locate sites by state, county, watershed, or bounding box, fetch recent readings, and retrieve time-series data. Other tools list measurement parameters and rank present hydrologic conditions against historical percentiles.
Each site search must use one geographic scope, such as a state or watershed. Requests with no scope or multiple scopes are rejected, so choose the area before adding filters. Large site matches and time series can be staged in DataCanvas and queried with read-only SQL SELECT statements. Connect the server over HTTP; the setup command below is for Claude Code.
What it helps with
- locate USGS monitoring sites in a state or watershed
- retrieve recent streamflow or water-level readings
- fetch a site's measurements over a date range
- compare present conditions with historical percentiles
- check which parameters a monitoring site reports
Example prompts for the agent
- Find USGS sites in state
COthat report streamflow. - Get the latest water-level readings for USGS site
siteId. - Compare current conditions at site
siteIdwith its historical percentiles.
How to install usgs-water-mcp-server
Platform CLI: remote server
claude mcp add --transport http usgs-water-mcp-server https://usgs-water-mcp-server--cyanheads.run.toolsPlatform CLI: remote server
codex mcp add usgs-water-mcp-server --url https://usgs-water-mcp-server--cyanheads.run.toolsConfig file
{
"mcpServers": {
"usgs-water-mcp-server": {
"url": "https://usgs-water-mcp-server--cyanheads.run.tools"
}
}
}Config file
{
"servers": {
"usgs-water-mcp-server": {
"type": "http",
"url": "https://usgs-water-mcp-server--cyanheads.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http usgs-water-mcp-server https://usgs-water-mcp-server--cyanheads.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about usgs-water-mcp-server
How do I install usgs-water-mcp-server in Claude Code?
Run claude mcp add --transport http usgs-water-mcp-server https://usgs-water-mcp-server--cyanheads.run.tools. The server connects over HTTP.
What does usgs-water-mcp-server do?
It lets an agent find USGS monitoring sites and retrieve recent readings, historical series, and hydrologic condition rankings.
What data can I query with the server?
It provides stream-gage and groundwater observations, including recent measurements and historical series. You can also search measurement parameters by name or description.