Usgs Water MCP server

online · 100% uptime

by cyanheads·io.github.cyanheads/usgs-water-mcp-server·v0.5.0·1 stars

No reviews yet

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

B83/100grade B

Write a review Run it

What users say

No reviews yet

Be the first

Safety scan

B83/100

not scanned yet

Adoption

Growing

1 stars128 downloads/wk

Reviews

Write one

Nobody has reviewed Usgs Water yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Usgs Water tools

Tool list not cached yet. `describe` through the gateway fetches it live.

Not scanned yet. New listings are scanned within a day or two of arriving.

How Usgs Water compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 83/100; higher than 65% of 48,255 servers
Uptime: 100%; of our recent checks; the typical remote server answers 100%
Response time: 501 ms; faster than 29% of 30,031 servers
GitHub stars: 1; more than 65% of 28,688 servers
Downloads a week: 128; more than 68% of 12,191 servers with a package

Release history: 7 versions in the registry since 2026-08-22, latest 2026-10-29, typically one every 9 days.

Install Usgs Water in Claude Code, Cursor or VS Code

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

Add to Cursor

What the publisher says

From the Usgs Water repository's README, as published. We do not edit it. Read it on GitHub

@cyanheads/usgs-water-mcp-server Query real-time and historical water data from ~8,000 USGS stream gages and groundwater wells via MCP. STDIO or Streamable HTTP. 7 Tools • 2 Resources

Public Hosted Server: https://usgs-water.caseyjhand.com/mcp

Overview

USGS NWIS water data — ~8,000 active stream gages and groundwater wells across the US and territories. Find monitoring sites, pull the latest readings or a historical time series, and rank current conditions against decades of percentile records from any MCP client. Runs as a stdio process, a local Streamable HTTP server, or the public hosted endpoint above.

Tools

Resources

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Grade history

2026-10-15downgradeA → Bscore 83: Write-action tools reachable without authentication

Usgs Water: common questions

Is Usgs Water MCP server safe?: Mostly: it is graded B (83/100). Read the Usgs Water safety report
How do I install Usgs Water?: It runs remotely at usgs-water.caseyjhand.com. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
Does Usgs Water need an API key?: No secret keys are declared. It reads 13 settings from the environment.
Is Usgs Water maintained?: The last commit was 31 days ago (2026-10-04). The latest release is v0.5.0.
Is Usgs Water up?: 100% of our last 28 checks got an answer. We check remote servers about four times a day.
How does Usgs Water compare with other MCP servers?: safety score 83/100 (higher than 65% of 48,255 servers); uptime 100% (of our recent checks; the typical remote server answers 100%); response time 501 ms (faster than 29% of 30,031 servers). Full comparison.

Run it through the gateway

With the gateway added, ask your agent for it by name:

agent prompt

call io.github.cyanheads/usgs-water-mcp-server → <tool>

Free per call. Metered, capped by your key, logged for reliability.

Add the gateway (gw.mcp.market)

Rating: —
Safety grade: B · 83/100
Stars: 1
Downloads/wk: 128
Price: Free
Licence: Apache-2.0
Transport: Remote · mixed
Uptime: 100% · 28/28 checks
Version: 0.5.0
Category: Everything else
Last release: 2026-10-04

Credentials it needs

USGS_USER_AGENTCustom User-Agent string for USGS NWIS and OGC discovery endpoints. Defaults to a descriptive identifier including the repo URL.
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').
MCP_TRANSPORT_TYPESelects the HTTP transport.
USGS_USER_AGENTCustom User-Agent string for USGS NWIS and OGC discovery endpoints. Defaults to a descriptive identifier including the repo URL.
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_HTTP_HOSTThe hostname for the HTTP server.
MCP_HTTP_PORTThe port to run the HTTP server on.
MCP_HTTP_ENDPOINT_PATHThe endpoint path for the MCP server.
MCP_AUTH_MODEAuthentication mode to use: 'none', 'jwt', or 'oauth'.
MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').

Endpoint

https://usgs-water.caseyjhand.com/mcp

streamable-http

Own this server?

Claim it to keep the listing current and reply to reviews. Claiming never changes the grade or hides a review.

Claim listing

Badge for your README

Shows the safety grade and links back to this page. It updates itself after every scan and review.

[![mcp.market](https://mcp.market/badge/cyanheads-usgs-water-mcp-server.svg)](https://mcp.market/server/cyanheads-usgs-water-mcp-server)

How the badge works