Query real-time and historical water data from ~8,000 USGS stream gages and groundwater wells via MCP. STDIO or Streamable HTTP.
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add usgs-water -- npx -y @cyanheads/usgs-water-mcp-server~/.codex/config.toml
[mcp_servers.usgs-water]
command = "npx"
args = ["-y", "@cyanheads/usgs-water-mcp-server"]
# codex mcp add usgs-water -- npx -y @cyanheads/usgs-water-mcp-server~/.cursor/mcp.json
{
"mcpServers": {
"usgs-water": {
"command": "npx",
"args": [
"-y",
"@cyanheads/usgs-water-mcp-server"
]
}
}
}.vscode/mcp.json
{
"servers": {
"usgs-water": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cyanheads/usgs-water-mcp-server"
]
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"usgs-water": {
"command": "npx",
"args": [
"-y",
"@cyanheads/usgs-water-mcp-server"
]
}
}
}claude_desktop_config.json
{
"mcpServers": {
"usgs-water": {
"command": "npx",
"args": [
"-y",
"@cyanheads/usgs-water-mcp-server"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"usgs-water": {
"command": "npx",
"args": [
"-y",
"@cyanheads/usgs-water-mcp-server"
]
}
}
}Remote
claude mcp add --transport http usgs-water https://usgs-water.caseyjhand.com/mcp~/.codex/config.toml
[mcp_servers.usgs-water]
url = "https://usgs-water.caseyjhand.com/mcp"
# codex mcp add usgs-water --url https://usgs-water.caseyjhand.com/mcp~/.cursor/mcp.json
{
"mcpServers": {
"usgs-water": {
"url": "https://usgs-water.caseyjhand.com/mcp"
}
}
}.vscode/mcp.json
{
"servers": {
"usgs-water": {
"type": "http",
"url": "https://usgs-water.caseyjhand.com/mcp"
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"usgs-water": {
"httpUrl": "https://usgs-water.caseyjhand.com/mcp"
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"usgs-water": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://usgs-water.caseyjhand.com/mcp"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"usgs-water": {
"url": "https://usgs-water.caseyjhand.com/mcp"
}
}
}