# usgs-water-mcp-server

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 1402 installs · ★ 3 repo stars
- Author: cyanheads
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cyanheads/usgs-water-mcp-server
- Updated: 2026-10-20
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/usgs-water-mcp-server

## What it 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.

## Requirements
- Remote server: `https://usgs-water-mcp-server--cyanheads.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http usgs-water-mcp-server https://usgs-water-mcp-server--cyanheads.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add usgs-water-mcp-server --url https://usgs-water-mcp-server--cyanheads.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "usgs-water-mcp-server": {
            "url": "https://usgs-water-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "usgs-water-mcp-server": {
            "type": "http",
            "url": "https://usgs-water-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http usgs-water-mcp-server https://usgs-water-mcp-server--cyanheads.run.tools
```

## When to use it
- 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
- 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.

## Similar
- [water-conditions](https://affpapa.org/en/nevibecode/mcp/water-conditions.md) — MCP server · 277 installs
- [TapWaterMap](https://affpapa.org/en/nevibecode/mcp/tapwatermap.md) — MCP server · 1707 installs
- [mineral-intel-benchmark](https://affpapa.org/en/nevibecode/mcp/mineral-intel-benchmark.md) — MCP server · 2167 installs
- [Weather & Geo Intel MCP](https://affpapa.org/en/nevibecode/mcp/weather-geo-intel-mcp.md) — MCP server
- [web-wave-designer](https://affpapa.org/en/nevibecode/skills/web-wave-designer.md) — skill · 214 installs
- [3d-ultra-realistic-water](https://affpapa.org/en/nevibecode/skills/3d-ultra-realistic-water.md) — skill · 771 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
