io.github.cyanheads/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.

View repository →

Connect this server

Add this to your MCP client config — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor).Suits: Claude Desktop · Cursor.

{
  "mcpServers": {
    "usgs-water-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/usgs-water-mcp-server@0.5.0"
      ],
      "env": {
        "USGS_REQUEST_TIMEOUT_MS": "30000",
        "WATER_DATAFRAME_DROP_ENABLED": "false",
        "MCP_LOG_LEVEL": "info"
      }
    }
  }
}
Environment variables
  • USGS_REQUEST_TIMEOUT_MSHTTP request timeout in milliseconds for USGS NWIS and OGC calls. Site-series discovery also has a shared 45-second deadline. Default: 30000.
  • WATER_DATAFRAME_DROP_ENABLEDSet to true to make water_dataframe_drop callable — it removes one staged table from a DataCanvas. Off by default, which lists the tool as disabled. Needs CANVAS_PROVIDER_TYPE=duckdb to have anything to drop.
  • MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Developer Tools
Version
0.5.0
Registry
active
Published
10/29/2026

Remotes

  • streamable-httphttps://usgs-water.caseyjhand.com/mcp

More Developer Tools servers

Browse all Developer Tools →

io.github.cyanheads/usitc-tariffs-mcp-server

cyanheads

Search USITC tariff schedules, inspect heading trees, and look up published duty rates.

Developer ToolsAdded 2 weeks ago

io.github.cyanheads/uspto-mcp-server

cyanheads

Search USPTO patent applications, PTAB trial proceedings, and petition decisions.

Developer ToolsAdded 5 months ago

io.github.cyanheads/wakeonlan-mcp-server

cyanheads

Wake LAN machines with Wake-on-LAN magic packets from host profiles, then confirm they came up.

Developer ToolsAdded 1 week ago

io.github.cyanheads/who-gho-mcp-server

cyanheads

WHO Global Health Observatory — 3,102 indicators across 194 member states.

Developer ToolsAdded 2 weeks ago

io.github.cyanheads/whois-mcp-server

cyanheads

Domain registry records and status, DNS records, and IP/ASN resolution over RDAP and DoH.

Developer ToolsAdded 3 weeks ago

io.github.cyanheads/wikidata-mcp-server

cyanheads

Search and fetch Wikidata entities, execute SPARQL queries, and resolve external identifiers.

Developer ToolsAdded 1 week ago

Add the badge to your site

Show visitors that io.github.cyanheads/usgs-water-mcp-server is listed here — it’s also the link we check for a free listing.

io.github.cyanheads/usgs-water-mcp-server — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-cyanheads-usgs-water-mcp-server?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="io.github.cyanheads/usgs-water-mcp-server — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![io.github.cyanheads/usgs-water-mcp-server — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-cyanheads-usgs-water-mcp-server?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.