MCP server

Usgs Water

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

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

Source

At a glance

Type

MCP server

Publisher

Not verified

Status

Working at last check

Tools

8

Token cost

About 4,886 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.usgs-water-mcp-server]
url = "https://usgs-water.caseyjhand.com/mcp"

Gemini CLI

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

Cursor

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

VS Code

{"servers":{"usgs-water-mcp-server":{"type":"http","url":"https://usgs-water.caseyjhand.com/mcp"}}}

Antigravity

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

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"usgs-water-mcp-server","server_url":"https://usgs-water.caseyjhand.com/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"usgs-water-mcp-server","server_url":"https://usgs-water.caseyjhand.com/mcp"}

Tools

• water_dataframe_describe ~250 tokens
  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 to discover the exact table name and column types before writing a query. Then pass the table name to water_dataframe_query, or to water_da
• water_dataframe_query ~426 tokens
  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_find_sites (get canvas_id + table_name) → water_dataframe_describe (confirm the table and its columns) → water_dataframe_query (SQL analysis),
• water_find_sites ~1210 tokens
  Find USGS water monitoring sites by bounding box, state, county, or HUC watershed code, filtered by site type and parameter availability. Returns site numbers, names, coordinates, types, altitude, and (in expanded mode) drainage area. Call this first — water_get_readings, water_get_series, and water
• water_get_conditions ~476 tokens
  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" percentileClass (record-high to record-low), not a flood-stage or drought determination (this tool fetches no authoritative thresholds). The reading i
• water_get_readings ~639 tokens
  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 provisional/approved qualifiers. Omitting parameterCd returns every parameter each site publishes. A site measuring one parameter with seve
• water_get_series ~967 tokens
  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 query — one per daily statistic (mean, maximum, minimum) and one per sensor (method); this returns one, reporting its statCd and methodId, a
• water_get_site_data_catalog ~458 tokens
  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 is a distinct series; metadata bounds may contain gaps and lag observations. For water_get_series, take YYYY-MM-DD from beginDate/endDate,
• water_list_parameters ~460 tokens
  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, and thematic group, from a built-in table (no network call): 00060 = "Discharge" (ft³/s), 00065 = "Gage height" (ft), 00010 = "Temperature,

Browse

• GitHub tools
• Calendars
• GitHub and code hosting
• Databases
• Government and public data

Related MCP servers

• USGS Water Monitoring
  Real-time water levels and flow rates from USGS stream gauges
• Usgs Water
  USGS Water Services (NWIS) MCP.
• Tollbooth
  37 paid x402 MCP tools for OSINT, prediction markets, web intel, and agent security on Base USDC.
• Cdec Ca
  CDEC (California Data Exchange Center) MCP. Keyless.
• DeepMap AI -- Earth Grounding
  Verifiable Earth ground truth for AI agents: water, hazard, ground stability, resource, with proof.
• Theaslangroupllc Pulsenetwork
  914 paid market-data & token-safety endpoints — keyless x402 USDC: Base, Solana, XRPL, +8 chains
• Nasa Firms
  NASA FIRMS MCP — active-fire / thermal-anomaly detections from MODIS and VIIRS.
• Gisgp
  GIS tools for AI agents: 65 free tools + 8 paid (hazard/site-scouting/GeoJSON export)

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.cyanheads/usgs-water-mcp-server.svg)](https://aptlynx.net/servers/io.github.cyanheads/usgs-water-mcp-server)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents