USGS Water MCP
Overview
This MCP server provides access to real-time water data from the USGS Water Services API. It allows you to fetch instantaneous water measurements including stream flow, gage height, temperature, and other water quality parameters from thousands of monitoring stations across the United States.
Sample Output
Here's an example of fetching stream flow data for the Potomac River:
Installation
Installing via pip
Manual Installation
- Clone this repository
- Install dependencies:
Connecting with Claude Desktop
- Edit your Claude Desktop configuration file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%/Claude/claude_desktop_config.json
- macOS:
- Add the server configuration:
- Restart Claude Desktop
Available Tools
fetch_usgs_data
Fetch instantaneous water data from USGS monitoring stations.
Parameters:
sites
(required): Comma-separated site numbers (e.g., "01646500" or "01646500,01647000")parameter_codes
(optional): Comma-separated parameter codes (e.g., "00060,00065")start_date
(optional): Start date in ISO format (YYYY-MM-DD or YYYY-MM-DDTHH)end_date
(optional): End date in ISO formatperiod
(optional): Period code (e.g., "P7D" for 7 days)
Common Parameter Codes:
00060
: Discharge (stream flow)00065
: Gage height00010
: Temperature, water00300
: Dissolved oxygen00400
: pH
Example Usage:
Troubleshooting
Common Issues
- API Connection Errors: Ensure you have an active internet connection and the USGS API is accessible
- Invalid Site Numbers: Verify site numbers exist using the USGS Water Data for the Nation website
- No Data Available: Some sites may not have data for the requested time period or parameters
- Rate Limiting: The USGS API has usage limits; avoid making too many requests in quick succession
Finding Site Numbers
Use the USGS Water Data for the Nation website to find monitoring station site numbers in your area of interest.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Provides access to real-time water data from the USGS Water Services API, allowing users to fetch instantaneous measurements like stream flow, gage height, temperature, and water quality parameters from thousands of monitoring stations across the US.
Related MCP Servers
- AsecurityFlicenseAqualityProvides access to the Australian Bureau of Statistics (ABS) Data API. This server allows AI assistants to query and analyze ABS statistical data.Last updated -14TypeScript
- -securityFlicense-qualityFacilitates retrieval of National Park Services data using the NPS API, allowing users to list national parks by state and access detailed information about specific parks.Last updated -35,3231TypeScript
- -securityAlicense-qualityProvides real-time information about U.S. National Parks through the NPS API, enabling users to search parks, check details, alerts, visitor centers, campgrounds, and upcoming events.Last updated -2617TypeScriptMIT License
- -securityAlicense-qualityReal-time hydrological information retrieval service that provides water level, precipitation, dam discharge data, and observatory location information.Last updated -PythonApache 2.0