Usgs Water Tools

Configuration File: usgs_water_tools.json Tool Type: Local Tools Count: 3

This page contains all tools defined in the usgs_water_tools.json configuration file.

Available Tools

USGSWater_get_streamflow (Type: BaseRESTTool)

Get real-time streamflow (discharge) data from USGS water monitoring stations. Returns instantane…

USGSWater_get_streamflow tool specification

Tool Information:

  • Name: USGSWater_get_streamflow

  • Type: BaseRESTTool

  • Description: Get real-time streamflow (discharge) data from USGS water monitoring stations. Returns instantaneous values for water flow rate in cubic feet per second (ft3/s) including site name, location coordinates, and recent measurements. The USGS monitors over 10,000 stream gauges across the United States.

Parameters:

  • sites (string) (required) USGS site number(s), comma-separated (e.g., ‘01646500’ for Potomac River near Washington DC, ‘09380000’ for Colorado River at Lees Ferry)

  • period ([‘string’, ‘null’]) (optional) Time period for data in ISO 8601 duration format (e.g., ‘PT2H’ for 2 hours, ‘P1D’ for 1 day, ‘P7D’ for 7 days). Default: ‘P1D’

Example Usage:

query = {
    "name": "USGSWater_get_streamflow",
    "arguments": {
        "sites": "example_value"
    }
}
result = tu.run(query)

USGSWater_get_water_level (Type: BaseRESTTool)

Get real-time water level (gage height) data from USGS monitoring stations. Returns water surface…

USGSWater_get_water_level tool specification

Tool Information:

  • Name: USGSWater_get_water_level

  • Type: BaseRESTTool

  • Description: Get real-time water level (gage height) data from USGS monitoring stations. Returns water surface elevation in feet above a reference datum. Useful for monitoring river/lake levels, flood conditions, and drought assessment.

Parameters:

  • sites (string) (required) USGS site number(s), comma-separated (e.g., ‘01646500’ for Potomac River)

  • period ([‘string’, ‘null’]) (optional) Time period in ISO 8601 format (e.g., ‘PT2H’, ‘P1D’, ‘P7D’). Default: ‘P1D’

Example Usage:

query = {
    "name": "USGSWater_get_water_level",
    "arguments": {
        "sites": "example_value"
    }
}
result = tu.run(query)

USGSWater_get_water_temperature (Type: BaseRESTTool)

Get real-time water temperature data from USGS monitoring stations. Returns water temperature in …

USGSWater_get_water_temperature tool specification

Tool Information:

  • Name: USGSWater_get_water_temperature

  • Type: BaseRESTTool

  • Description: Get real-time water temperature data from USGS monitoring stations. Returns water temperature in degrees Celsius. Useful for ecological monitoring, aquatic habitat assessment, and water quality analysis.

Parameters:

  • sites (string) (required) USGS site number(s), comma-separated

  • period ([‘string’, ‘null’]) (optional) Time period in ISO 8601 format (e.g., ‘PT2H’, ‘P1D’, ‘P7D’). Default: ‘P1D’

Example Usage:

query = {
    "name": "USGSWater_get_water_temperature",
    "arguments": {
        "sites": "example_value"
    }
}
result = tu.run(query)