Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http usgs-water-mcp-server https://usgs-water-mcp-server--cyanheads.run.tools
Open on GitHub

What 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 CO that report streamflow.
  • Get the latest water-level readings for USGS site siteId.
  • Compare current conditions at site siteId with 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.tools

Step 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.

Similar MCP servers

All MCP servers for Science and research →

Project sponsors

Companies that keep this analytics open