USGS Water Services MCP Server
Connect your agent to USGS Water Services for streamflow, flood-stage context, and peak events when building river or flood analytics features.
Overview
USGS Water Services MCP (io.github.mansurjisan/usgs-mcp) is a Build-phase MCP server that queries streamflow, flood stages, and peak events from waterservices.usgs.gov through agent tools.
What is this MCP server?
- USGS Water Services streamflow queries via MCP
- Flood stage and gauge context for agent-driven explanations
- Peak event retrieval for historical flood analysis
- stdio server usgs-mcp v0.1.0 installable with uvx
- Fits alongside STOFS surge and WW3 wave MCP tools for multi-hazard apps
- Package usgs-mcp version 0.1.0 on PyPI
- stdio transport, uvx runtimeHint
- GitHub source: mansurjisan/ocean-mcp
What problem does it solve?
USGS Water Services endpoints are well documented but tedious to wire repeatedly, which slows indie builders adding live river data to apps.
Who is it for?
Solo builders creating flood trackers, outdoor SaaS, municipal informatics prototypes, or research tools grounded in USGS gauge networks.
Skip if: Teams building products with no surface-water or USGS dependency, or environments that block calls to federal hydrology APIs.
What do I get? / Deliverables
After adding usgs-mcp, your agent can fetch hydro data and peak events on demand so you implement dashboards and APIs with fewer manual API experiments.
- Streamflow and gauge queries callable from the agent
- Flood-stage and peak-event context for feature code
- Faster USGS-backed API or dashboard scaffolding
Recommended MCP Servers
Journey fit
How it compares
MCP façade over USGS Water Services, not a commercial flood intelligence platform or embedded GIS SDK.
Common Questions / FAQ
Who is usgs-mcp for?
Developers who want AI agents to query USGS streamflow, flood stages, and peak events while building hydrology features.
When should I use usgs-mcp?
Use it during Build integrations when you need live or historical gauge data, peak events, or flood-stage context in code the agent is writing.
How do I add usgs-mcp to my agent?
Add stdio MCP config running uvx usgs-mcp (PyPI 0.1.0), allow HTTPS to waterservices.usgs.gov, and verify tools in your MCP client.