Usgs Water Mcp Server
Pull real-time and historical USGS streamgage and groundwater data into agent-driven maps, alerts, or environmental side projects.
Overview
USGS Water MCP server is a Build-phase MCP integration that queries real-time and historical USGS NWIS data from about 8,000 gages and wells.
What is this MCP server?
- Query ~8,000 USGS stream gages and groundwater wells
- Real-time and historical USGS NWIS water data from the agent
- Hosted streamable-http remote at usgs-water.caseyjhand.com/mcp
- Local stdio via @cyanheads/usgs-water-mcp-server (Bun)
- USGS_USER_AGENT and USGS_REQUEST_TIMEOUT_MS tuning for NWIS etiquette
- Covers on the order of ~8,000 USGS stream gages and groundwater wells
- Default NWIS HTTP timeout 30000 ms; package version 0.1.4
What problem does it solve?
Environmental and mapping side projects bog down when agents cannot reliably pull USGS water time series without custom NWIS client code.
Who is it for?
Builders embedding USGS hydrology in dashboards, outdoor tools, or research-backed prototypes.
Skip if: Teams that need proprietary hydrology models or non-USGS global water datasets only.
What do I get? / Deliverables
You register the remote or stdio server and get gage and well data in chat for charts, alerts, or API prototypes.
- Agent-fetched USGS site time series for prototyping
- Configurable NWIS request timeouts via USGS_REQUEST_TIMEOUT_MS
- Choice of hosted remote MCP or local stdio deployment
Recommended MCP Servers
Journey fit
Water telemetry is wired into products during implementation; the server is an external data bridge for build-time feature work. NWIS queries belong under integrations when agents fetch hydrology series for dashboards or automation.
How it compares
Public NWIS data MCP, not application error monitoring or APM.
Common Questions / FAQ
Who is USGS Water MCP server for?
Solo developers and small teams who want agents to fetch USGS stream and groundwater measurements while building data products or maps.
When should I use USGS Water MCP server?
Use it during build when you need live or historical water levels from USGS sites without hand-writing NWIS requests each session.
How do I add USGS Water MCP server to my agent?
Add the remote URL https://usgs-water.caseyjhand.com/mcp for streamable-http, or install @cyanheads/usgs-water-mcp-server and run start:stdio with optional USGS_USER_AGENT.