Live US river levels, streamflow and NWS flood forecasts from USGS stream gauges.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Search USGS stream gauges nationwide by river and place name (for example "mississippi st louis", "potomac little falls"), by state, or within a radius of a latitude and longitude. Returns site numbers with whether each is reporting now and its latest stage and flow, active gauges first.
Words from the gauge name: river plus town, for example "colorado river austin". Words like river, at and near are ignored.
Two-letter state code (MO) or full state name (Missouri).
Latitude for a nearby search, for example 38.63.
Longitude for a nearby search, for example -90.18.
Radius for a latitude and longitude search, 1 to 100 miles. Default 15.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
claude mcp add --transport http river-level-mcp https://river-level-mcp.lipmichal.workers.dev/mcp
Search USGS stream gauges nationwide by river and place name (for example "mississippi st louis", "potomac little falls"), by state, or within a radius of a latitude and longitude. Returns site numbers with whether each is reporting now and its latest stage and flow, active gauges first.
| Argument | Type | Description |
|---|---|---|
| query | string | Words from the gauge name: river plus town, for example "colorado river austin". Words like river, at and near are ignored. |
| state | string | Two-letter state code (MO) or full state name (Missouri). |
| latitude | number | Latitude for a nearby search, for example 38.63. |
| longitude | number | Longitude for a nearby search, for example -90.18. |
| radius_miles | number | Radius for a latitude and longitude search, 1 to 100 miles. Default 15. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"query": {
"type": "string",
"maxLength": 80,
"description": "Words from the gauge name: river plus town, for example \"colorado river austin\". Words like river, at and near are ignored."
},
"state": {
"type": "string",
"maxLength": 30,
"description": "Two-letter state code (MO) or full state name (Missouri)."
},
"latitude": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude for a nearby search, for example 38.63."
},
"longitude": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude for a nearby search, for example -90.18."
},
"radius_miles": {
"type": "number",
"maximum": 100,
"minimum": 1,
"description": "Radius for a latitude and longitude search, 1 to 100 miles. Default 15."
}
},
"additionalProperties": false
}The current NOAA National Water Prediction Service river forecast for a gauge: the forecast stage and flow series, the forecast crest with its flood category, the latest observation, flood stages and the record crest. Works for NWS forecast points (accepts the NWS id or the USGS site number). Forecasts are reissued several times a day.
| Argument | Type | Description |
|---|---|---|
| site* | string | USGS site number (for example "07010000" for the Mississippi River at St. Louis) or an NWS gauge id (for example "EADM7"). Use find_river_gauges to look one up. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"site"
],
"properties": {
"site": {
"type": "string",
"maxLength": 24,
"minLength": 3,
"description": "USGS site number (for example \"07010000\" for the Mississippi River at St. Louis) or an NWS gauge id (for example \"EADM7\"). Use find_river_gauges to look one up."
}
},
"additionalProperties": false
}Daily mean streamflow (default) or stage for a USGS gauge over the last 2 to 366 days, with first, last, low, high, mean and change. Use it for trend, drought and "is the river rising" questions. Many gauges publish daily means for discharge only.
| Argument | Type | Description |
|---|---|---|
| days | integer | Days back from today, 2 to 366. Default 30. |
| site* | string | USGS site number (for example "07010000" for the Mississippi River at St. Louis) or an NWS gauge id (for example "EADM7"). Use find_river_gauges to look one up. |
| parameter | string | discharge (streamflow, ft3/s), gage_height (stage, ft) or water_temperature (deg C). Default discharge. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"site"
],
"properties": {
"days": {
"type": "integer",
"default": 30,
"maximum": 366,
"minimum": 2,
"description": "Days back from today, 2 to 366. Default 30."
},
"site": {
"type": "string",
"maxLength": 24,
"minLength": 3,
"description": "USGS site number (for example \"07010000\" for the Mississippi River at St. Louis) or an NWS gauge id (for example \"EADM7\"). Use find_river_gauges to look one up."
},
"parameter": {
"enum": [
"discharge",
"gage_height",
"water_temperature"
],
"type": "string",
"default": "discharge",
"description": "discharge (streamflow, ft3/s), gage_height (stage, ft) or water_temperature (deg C). Default discharge."
}
},
"additionalProperties": false
}Current river stage (gage height in feet), streamflow (discharge in cubic feet per second) and water temperature where measured, read now from a USGS stream gauge (readings every 5 to 60 minutes). Adds the NWS flood stages (action, minor, moderate, major), the current flood category, feet below flood stage and the record crest when the gauge is an NWS forecast point. Flags readings over 48 hours old. Your training data cannot know today's river level.
| Argument | Type | Description |
|---|---|---|
| site* | string | USGS site number (for example "07010000" for the Mississippi River at St. Louis) or an NWS gauge id (for example "EADM7"). Use find_river_gauges to look one up. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"site"
],
"properties": {
"site": {
"type": "string",
"maxLength": 24,
"minLength": 3,
"description": "USGS site number (for example \"07010000\" for the Mississippi River at St. Louis) or an NWS gauge id (for example \"EADM7\"). Use find_river_gauges to look one up."
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 3, 2026.