MCP server
Usgs Water MCP Server
Query real-time and historical USGS water data from ~8,000 stream gages and groundwater…
- Pricing
- Open source
- Runs
- Locally or Remotely
- Version
- 0.6.0
- Listing updated
- 4 days ago
About Usgs Water MCP Server
Usgs Water MCP Server is an open-source MCP server. It can run locally on your machine or as a hosted remote server.
Query real-time and historical USGS water data from ~8,000 stream gages and groundwater wells.
Install
Run in a terminal
claude mcp add --transport http usgs-water-mcp-server https://usgs-water.caseyjhand.com/mcpAdd to Settings → Connectors → Add custom connector
https://usgs-water.caseyjhand.com/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"usgs-water-mcp-server": {
"url": "https://usgs-water.caseyjhand.com/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"usgs-water-mcp-server": {
"type": "http",
"url": "https://usgs-water.caseyjhand.com/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"usgs-water-mcp-server": {
"serverUrl": "https://usgs-water.caseyjhand.com/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"usgs-water-mcp-server": {
"type": "http",
"url": "https://usgs-water.caseyjhand.com/mcp"
}
}
}Configuration
USGS_USER_AGENTCustom User-Agent string for USGS Water Data API requests. Defaults to a descriptive identifier including the repo URL.USGS_REQUEST_TIMEOUT_MSHTTP request timeout in milliseconds for each USGS Water Data API request. Every tool call also has a shared 45-second deadline across its requests and retries. Default: 30000.USGS_API_KEYOptional api.data.gov key for the USGS Water Data APIs, sent as the X-Api-Key header. Without one, requests share the anonymous per-IP hourly limit (1,000 requests on the OGC collections); a shared or hosted deployment should set one.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 Water Data API requests. Defaults to a descriptive identifier including the repo URL.USGS_REQUEST_TIMEOUT_MSHTTP request timeout in milliseconds for each USGS Water Data API request. Every tool call also has a shared 45-second deadline across its requests and retries. Default: 30000.USGS_API_KEYOptional api.data.gov key for the USGS Water Data APIs, sent as the X-Api-Key header. Without one, requests share the anonymous per-IP hourly limit (1,000 requests on the OGC collections); a shared or hosted deployment should set one.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').
Pricing
Open source
Usgs Water MCP Server FAQ
Is Usgs Water MCP Server free?
Yes. Usgs Water MCP Server is open source, so you can use and self-host it for free.
How do I add Usgs Water MCP Server to Claude Code?
Run this command in your terminal: claude mcp add --transport http usgs-water-mcp-server https://usgs-water.caseyjhand.com/mcp