io.github.cyanheads/usgs-water-mcp-server MCP Server
io.github.cyanheads/usgs-water-mcp-server
What this kind of tool is for
- Query, inspect, or seed a database without writing a one-off script.
- Let your agent look up schema details before it writes migration code.
- Move a small dataset between tools without leaving the terminal.
How to compare servers like this
- Engine match:
- Confirm it speaks your exact database and version, not just the family.
- Access scope:
- Read-only connections are the safe default — start there before granting writes.
- Safety rails:
- Check whether destructive statements need an explicit confirmation before they run.
- Maintenance signal:
- Database drivers change; a recently updated tool is less likely to break mid-query.
This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.
What is the io.github.cyanheads/usgs-water-mcp-server MCP server?
Query real-time and historical USGS water data from ~8,000 stream gages and groundwater wells.
How to install io.github.cyanheads/usgs-water-mcp-server
Copy-paste configuration for popular MCP clients.
USGS_USER_AGENTCustom User-Agent string for USGS requests (NWIS and the parameter-code catalog). Defaults to a descriptive identifier including the repo URL.
USGS_REQUEST_TIMEOUT_MSHTTP request timeout in milliseconds for USGS calls (NWIS and the parameter-code catalog). Default: 30000.
MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
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'.
{
"mcpServers": {
"usgs-water-mcp-server": {
"command": "bun",
"args": [
"-y",
"@cyanheads/usgs-water-mcp-server",
"run",
"start:stdio"
],
"env": {
"USGS_USER_AGENT": "<YOUR_USGS_USER_AGENT>",
"USGS_REQUEST_TIMEOUT_MS": "<YOUR_USGS_REQUEST_TIMEOUT_MS>",
"MCP_LOG_LEVEL": "<YOUR_MCP_LOG_LEVEL>",
"MCP_HTTP_HOST": "<YOUR_MCP_HTTP_HOST>",
"MCP_HTTP_PORT": "<YOUR_MCP_HTTP_PORT>",
"MCP_HTTP_ENDPOINT_PATH": "<YOUR_MCP_HTTP_ENDPOINT_PATH>",
"MCP_AUTH_MODE": "<YOUR_MCP_AUTH_MODE>"
}
}
}
}Related MCP servers
Wake LAN machines with Wake-on-LAN magic packets from host profiles, then confirm they came up.
WHO Global Health Observatory — 3,059 indicators across 194 member states.
Domain registration, availability, DNS records, and IP/ASN resolution via RDAP and DNS-over-HTTPS.
Search and fetch Wikidata entities, execute SPARQL queries, and resolve external identifiers.
Search Wikipedia, read summaries and full text, target sections, find nearby pages, list languages.
Store, query, and create YAML workflow playbooks for LLM agents via MCP.
