Skip to content
MCP server

Usgs Water MCP Server

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

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://usgs-water.caseyjhand.com/mcp
Install 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