USGS Water Conditions
Create or update a recurring USGS water conditions feed
Custom Streaming + One-shot
Create or update a recurring USGS water conditions feed. Useful for tracking real-time streamflow or gage height changes. Same arguments as usgs/get_water_conditions.
Technical details
Authentication ▾
Contact us for setup details.
Ingestion ▾
Mode: Streaming + One-shot
Tools exposed (2) ▾
upsert_bento_get_water_conditions
Create or update a recurring USGS water conditions feed. Useful for tracking real-time streamflow or gage height changes. Same arguments as usgs/get_water_conditions.
usgs/get_water_conditions
Fetches real-time water data (streamflow, gage height, etc.) from the USGS Water Services API (NWIS).
Inputs ▾
upsert_bento_get_water_conditions
| Name | Type | Required | Description |
|---|---|---|---|
| dashboardId | string | no | Target dashboard/initiative ID. Omit to use the current dashboard. |
| stateCd | string | no | Two-letter state code to filter sites by (e.g., "CA", "NY"). |
| sites | string | no | Comma-separated list of USGS site numbers (max 100). |
| huc | string | no | Hydrologic unit code(s). 1 major (2-digit) or up to 10 minor (8-digit), comma-separated. |
| bBox | string | no | Bounding box: "westLon,southLat,eastLon,northLat". Max 25 degrees span. |
| countyCd | string | no | Comma-separated FIPS county codes (5-digit, max 20). |
| period | string | no | Period of record (ISO 8601 duration, e.g. "P1D", "P7D"). Default: "P1D". Max: P30D for IV data. |
| startDT | string | no | Start date/time (ISO 8601). Use with endDT instead of period for exact ranges. |
| endDT | string | no | End date/time (ISO 8601). Required if startDT is specified. |
| modifiedSince | string | no | ISO 8601 duration. Only return values changed within this period (e.g. "PT1H"). Useful for polling. |
| parameterCd | string | no | Comma-separated parameter codes (max 100). Common: "00060" (discharge), "00065" (gage height), "00010" (water temp). |
| siteType | string | no | Site type filter. Common: "ST" (stream), "LK" (lake), "GW" (groundwater), "SP" (spring). |
| siteStatus | string | no | Site status filter. Default: "all". all active inactive |
| altMin | number | no | Minimum altitude in feet. |
| altMax | number | no | Maximum altitude in feet. |
| drainAreaMin | number | no | Minimum drainage area in square miles. |
| drainAreaMax | number | no | Maximum drainage area in square miles. |
| limit | number | no | Number of sites to return (default 20). |
| offset | number | no | Offset for pagination (default 0). |
| summary_only | boolean | no | If true, returns only site metadata/IDs without time-series values. Use this to discover sites. |
| filter_paths | string[] | no | Optional: Glob patterns to filter output and reduce context usage (e.g. ['value.timeSeries[*].values']). |
| polling_frequency | string | yes | How often to check for new data (e.g. '15m', '1h'). |
| description | string | no | Human-readable description of what this connector monitors. Shown to analysts in future sessions. |
| connectorId | string | no | If provided, updates the existing connector instead of creating a new one. |
usgs/get_water_conditions
| Name | Type | Required | Description |
|---|---|---|---|
| dashboardId | string | no | Target dashboard/initiative ID. Omit to use the current dashboard. |
| stateCd | string | no | Two-letter state code to filter sites by (e.g., "CA", "NY"). |
| sites | string | no | Comma-separated list of USGS site numbers (max 100). |
| huc | string | no | Hydrologic unit code(s). 1 major (2-digit) or up to 10 minor (8-digit), comma-separated. |
| bBox | string | no | Bounding box: "westLon,southLat,eastLon,northLat". Max 25 degrees span. |
| countyCd | string | no | Comma-separated FIPS county codes (5-digit, max 20). |
| period | string | no | Period of record (ISO 8601 duration, e.g. "P1D", "P7D"). Default: "P1D". Max: P30D for IV data. |
| startDT | string | no | Start date/time (ISO 8601). Use with endDT instead of period for exact ranges. |
| endDT | string | no | End date/time (ISO 8601). Required if startDT is specified. |
| modifiedSince | string | no | ISO 8601 duration. Only return values changed within this period (e.g. "PT1H"). Useful for polling. |
| parameterCd | string | no | Comma-separated parameter codes (max 100). Common: "00060" (discharge), "00065" (gage height), "00010" (water temp). |
| siteType | string | no | Site type filter. Common: "ST" (stream), "LK" (lake), "GW" (groundwater), "SP" (spring). |
| siteStatus | string | no | Site status filter. Default: "all". all active inactive |
| altMin | number | no | Minimum altitude in feet. |
| altMax | number | no | Maximum altitude in feet. |
| drainAreaMin | number | no | Minimum drainage area in square miles. |
| drainAreaMax | number | no | Maximum drainage area in square miles. |
| limit | number | no | Number of sites to return (default 20). |
| offset | number | no | Offset for pagination (default 0). |
| summary_only | boolean | no | If true, returns only site metadata/IDs without time-series values. Use this to discover sites. |
| filter_paths | string[] | no | Optional: Glob patterns to filter output and reduce context usage (e.g. ['value.timeSeries[*].values']). |