{"ok":true,"site":"waterdata-usgs","host":"waterdata.usgs.gov","about":"USGS Water Data for the Nation: find stream, lake and groundwater monitoring locations and fetch their real-time readings, field measurements, time-series metadata, daily statistics, basins and flowlines using the public USGS Water Data APIs.","commands":[{"command":"search-monitoring-locations","summary":"Full-text search for monitoring locations by water body, place name or ID (e.g. 'Potomac River').","params":[{"name":"q","type":"string","required":true,"description":"Free-text query: water body, city, location name or number"},{"name":"api_limit","type":"number","description":"Maximum number of results (sent to the site as \"limit\"; clify's own --limit only shapes the output)","default":10}],"exampleUrl":"https://clify-dev.netlify.app/waterdata-usgs/search-monitoring-locations?q=Potomac+River"},{"command":"get-monitoring-location","summary":"Get summary metadata for one monitoring location: name, coordinates, elevation, drainage area and description.","params":[{"name":"id","type":"string","required":true,"description":"Monitoring location ID with agency prefix, e.g. USGS-01646500"}],"exampleUrl":"https://clify-dev.netlify.app/waterdata-usgs/get-monitoring-location"},{"command":"list-monitoring-locations-in-bbox","summary":"List monitoring locations inside a bounding box (the Explore map). Filter by data type, site type, parameter code and recent activity.","params":[{"name":"boundingBox","type":"string","required":true,"description":"minLon,minLat,maxLon,maxLat in WGS84 degrees"},{"name":"dataType","type":"string","description":"Only locations that record this data collection category","oneOf":["Continuous values","Daily values"]},{"name":"siteTypeCode","type":"string","description":"Site type code, e.g. ST (stream), LK (lake), ES (estuary), OC (ocean), GW (well)"},{"name":"usgsPCode","type":"string","description":"USGS parameter code observed at the location, e.g. 00060 (discharge) or 00065 (gage height)"},{"name":"dataCollectedSinceDatetime","type":"string","description":"Only locations with data collected since this date (YYYY-MM-DD)"},{"name":"pageSize","type":"number","description":"Maximum number of locations returned","default":1000}],"exampleUrl":"https://clify-dev.netlify.app/waterdata-usgs/list-monitoring-locations-in-bbox?boundingBox=-77.60810852050783%2C39.03945298873317%2C-76.92832946777345%2C39.22587043822116&dataType=Continuous+values"},{"command":"list-time-series","summary":"List the time series at a monitoring location: series ID, parameter, period of record and description. Needed for the data and statistics commands.","params":[{"name":"monitoring_location_id","type":"string","required":true,"description":"Monitoring location ID, e.g. USGS-01646500"},{"name":"statistic_id","type":"string","description":"Statistic code: 00003 = daily mean, 00011 = instantaneous (continuous)"},{"name":"parameter_code","type":"string","description":"Parameter code, e.g. 00060 (discharge, ft^3/s) or 00065 (gage height, ft)"}],"exampleUrl":"https://clify-dev.netlify.app/waterdata-usgs/list-time-series?monitoring_location_id=USGS-01646500"},{"command":"get-continuous-data","summary":"Get continuous (instantaneous, ~15-minute) readings for a time series or for a location and parameter over a recent period.","params":[{"name":"time_series_id","type":"string","description":"Time series ID from list-time-series (statistic 00011)"},{"name":"monitoring_location_id","type":"string","description":"Alternative to time_series_id: monitoring location ID, e.g. USGS-01646500"},{"name":"parameter_code","type":"string","description":"Parameter code to use with monitoring_location_id, e.g. 00060 or 00065"},{"name":"time","type":"string","description":"ISO 8601 duration back from now (P7D, P30D) or an interval start/end","default":"P7D"}],"exampleUrl":"https://clify-dev.netlify.app/waterdata-usgs/get-continuous-data?time_series_id=8a83eb3a3cbc4087b0c201cf07c0c76d&time=P7D"},{"command":"get-field-measurements","summary":"Get manual field measurements (e.g. measured discharge or gage height) at a monitoring location.","params":[{"name":"monitoring_location_id","type":"string","required":true,"description":"Monitoring location ID, e.g. USGS-01646500"},{"name":"parameter_code","type":"string","description":"Parameter code, e.g. 00060 (discharge) or 00065 (gage height)"},{"name":"time","type":"string","description":"ISO 8601 interval start/end, e.g. 2026-09-18T00:00:00Z/2026-10-18T00:00:00Z, or a duration like P1Y"}],"exampleUrl":"https://clify-dev.netlify.app/waterdata-usgs/get-field-measurements?monitoring_location_id=USGS-01646500&parameter_code=00060"},{"command":"get-daily-normals","summary":"Get day-of-year statistics (median, mean, percentiles) for a daily time series, optionally for a calendar-day range.","params":[{"name":"parent_time_series_id","type":"string","required":true,"description":"Daily time series ID from list-time-series (statistic_id 00003)"},{"name":"start_date","type":"string","description":"Calendar day MM-DD, e.g. 10-18"},{"name":"end_date","type":"string","description":"Calendar day MM-DD, e.g. 10-18"},{"name":"computation_type","type":"string","description":"Statistic to compute","oneOf":["median","arithmetic_mean"]},{"name":"approval_status","type":"string","description":"Restrict to approved data","oneOf":["approved"]}],"exampleUrl":"https://clify-dev.netlify.app/waterdata-usgs/get-daily-normals?parent_time_series_id=de8e9d3cfb0f465c9282f6a25d6f37ec&start_date=10-18&end_date=10-18"},{"command":"get-observation-intervals","summary":"Get monthly and yearly aggregate statistics (e.g. arithmetic mean per month) for daily time series.","params":[{"name":"parent_time_series_id","type":"string","required":true,"description":"Daily time series ID from list-time-series (statistic_id 00003)"},{"name":"computation_type","type":"string","description":"Statistic to compute","oneOf":["arithmetic_mean","median"],"default":"arithmetic_mean"},{"name":"approval_status","type":"string","description":"Restrict to approved data","oneOf":["approved"],"default":"approved"}],"exampleUrl":"https://clify-dev.netlify.app/waterdata-usgs/get-observation-intervals?parent_time_series_id=2cf409b0d9694c01828f5d4ff14586a5"},{"command":"search-parameter-codes","summary":"Find USGS parameter codes whose description contains a keyword, case-insensitive (e.g. 'discharge' → 00060).","params":[{"name":"keyword","type":"string","required":true,"description":"Word to look for in the parameter description"}],"exampleUrl":"https://clify-dev.netlify.app/waterdata-usgs/search-parameter-codes"},{"command":"get-states","summary":"Look up US states/territories by FIPS-based ID (e.g. US-24 → MD), or list them all.","params":[{"name":"id","type":"string","description":"State ID as US-<2-digit FIPS>, e.g. US-24"}],"exampleUrl":"https://clify-dev.netlify.app/waterdata-usgs/get-states?id=US-24"},{"command":"get-hydrologic-unit","summary":"Get the name of a hydrologic unit (HUC watershed) from its code.","params":[{"name":"huc","type":"string","required":true,"description":"Hydrologic unit code (2-12 digits), e.g. 020700081005"}],"exampleUrl":"https://clify-dev.netlify.app/waterdata-usgs/get-hydrologic-unit"},{"command":"get-flood-stage","summary":"Get NWS flood-stage thresholds (action/minor/moderate/major) for a site; returns {} when none are defined.","params":[{"name":"site_number","type":"string","required":true,"description":"USGS site number without the 'USGS-' prefix, e.g. 01646500"}],"exampleUrl":"https://clify-dev.netlify.app/waterdata-usgs/get-flood-stage"},{"command":"get-basin","summary":"Get the upstream drainage basin polygon (GeoJSON) for a monitoring location from the NLDI.","params":[{"name":"id","type":"string","required":true,"description":"Monitoring location ID, e.g. USGS-01646500"}],"exampleUrl":"https://clify-dev.netlify.app/waterdata-usgs/get-basin"},{"command":"navigate-flowlines","summary":"Get the NHDPlus river flowlines upstream (UM) or downstream (DM) along the main stem from a monitoring location.","params":[{"name":"id","type":"string","required":true,"description":"Monitoring location ID, e.g. USGS-01646500"},{"name":"mode","type":"string","required":true,"description":"UM = upstream main stem, DM = downstream main stem","oneOf":["UM","DM"]},{"name":"distance","type":"number","description":"Navigation distance in kilometers","default":322}],"exampleUrl":"https://clify-dev.netlify.app/waterdata-usgs/navigate-flowlines?distance=322"},{"command":"list-states","summary":"List the states and territories of a country, with their browse URLs (the state codes are FIPS).","params":[{"name":"country","type":"string","required":true,"description":"Country code"}],"exampleUrl":"https://clify-dev.netlify.app/waterdata-usgs/list-states"},{"command":"list-counties","summary":"List the counties in a state, with their browse URLs (the county codes are FIPS).","params":[{"name":"state_code","type":"string","required":true,"description":"2-digit state FIPS code, e.g. 24 for Maryland"}],"exampleUrl":"https://clify-dev.netlify.app/waterdata-usgs/list-counties"},{"command":"list-county-monitoring-locations","summary":"List every monitoring location in a county, by name and ID.","params":[{"name":"state_code","type":"string","required":true,"description":"2-digit state FIPS code, e.g. 24"},{"name":"county_code","type":"string","required":true,"description":"3-digit county FIPS code, e.g. 031 (Montgomery County, MD)"}],"exampleUrl":"https://clify-dev.netlify.app/waterdata-usgs/list-county-monitoring-locations"}]}