io.github.cyanheads/usgs-water-mcp-server

up checked 2026-11-11T05:38:11.500Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided description

Query real-time and historical USGS water data from ~8,000 stream gages and groundwater wells.

Summary by lookupd

Queries USGS stream gage and groundwater well data: current readings, historical series, site search, and SQL over staged results.

Install

Claude Code, remote (streamable-http)

claude mcp add --transport http usgs-water-mcp-server https://usgs-water.caseyjhand.com/mcp

Claude Code, npm package (stdio)

claude mcp add usgs-water-mcp-server -- npx -y @cyanheads/usgs-water-mcp-server

Claude Code, npm package (stdio)

claude mcp add usgs-water-mcp-server -- npx -y @cyanheads/usgs-water-mcp-server

Codex, remote (streamable-http)

codex mcp add usgs-water-mcp-server --url https://usgs-water.caseyjhand.com/mcp

Codex, npm package (stdio)

codex mcp add usgs-water-mcp-server -- npx -y @cyanheads/usgs-water-mcp-server

Codex, npm package (stdio)

codex mcp add usgs-water-mcp-server -- npx -y @cyanheads/usgs-water-mcp-server

Cursor, remote (streamable-http) → .cursor/mcp.json

{
  "mcpServers": {
    "usgs-water-mcp-server": {
      "url": "https://usgs-water.caseyjhand.com/mcp"
    }
  }
}

Cursor, npm package (stdio) → .cursor/mcp.json

{
  "mcpServers": {
    "usgs-water-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/usgs-water-mcp-server"
      ]
    }
  }
}

Cursor, npm package (stdio) → .cursor/mcp.json

{
  "mcpServers": {
    "usgs-water-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/usgs-water-mcp-server"
      ]
    }
  }
}

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (8 tools)

Publisher-provided text

• 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,
• water_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,
• water_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
• water_get_series Get a daily or instantaneous time series for one USGS site and parameter over a date range, as time-ordered value records. NWIS can hold several series for one
• water_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
• water_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" percentile
• water_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_fin
• water_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

Changes

Newest first, as lookupd saw them

• 2026-11-11: version 0.5.0 → 0.6.0

Details

• Version: 0.6.0
• Transports: streamable-http, stdio
• Uptime (7 days): 100%
• Median latency: 611 ms
• First indexed: 2026-11-01T09:26:44.633Z
• Last seen in registry: 2026-11-11T13:17:24.161Z
• Repository: https://github.com/cyanheads/usgs-water-mcp-server

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.github.cyanheads/usgs-water-mcp-server.svg)](https://lookupd.com/servers/io.github.cyanheads/usgs-water-mcp-server)

• 62141 servers
• Last crawl: 2026-11-11T18:39:04.612Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp