River flow and levels near a place

usgs_water.readings_near

FreeLive now

Latest readings from USGS stream gauges near a U.S. location: streamflow (ft3/s) or gage height (ft), nearest first, with site names and links.

Inputs

Name	Type	Description
`lat`required	number	Latitude in decimal degreesrange: -90 to 90
`lon`required	number	Longitude in decimal degreesrange: -180 to 180
`radius_km`	number	Search radius in kmdefault: 25; range: 1 to 50
`measure`	string	Streamflow or water levelone of: discharge, gage_height; default: "discharge"
`limit`	integer	default: 8; range: 1 to 15

Example output

{"query":{"lat":38.95,"lon":-77.13,"radius_km":20,"measure":"discharge"},"measure":"Streamflow (discharge)","count":3,"sites":[{"id":"USGS-01646500","name":"POTOMAC RIVER NEAR WASH, DC LITTLE FALLS PUMP STA","state":"Maryland","distance_km":0.2,"lat":38.94978,"lon":-77.12764,"value":2210,"unit":"ft^3/s","time":"2026-11-01T23:50:00+00:00","approval":"Provisional","page":"https://waterdata.usgs.gov/monitoring-location/01646500/"},{"id":"USGS-01646305","name":"DEAD RUN AT WHANN AVENUE NEAR MCLEAN, VA","state":"Virginia","distance_km":4.1,"lat":38.95978,"lon":-77.17567,"value":0.59,"unit":"ft^3...

Data license

Public domain · Water data from the U.S. Geological Survey (public domain); recent data are provisional. Credit: U.S. Geological Survey. Source

Try it

…

Call it

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "usgs_water.readings_near",
    "arguments": {
      "lat": 38.95,
      "lon": -77.13,
      "radius_km": 20,
      "limit": 3
    }
  }
}

curl -sS -X POST https://www.realworldmcp.com/api/call/usgs_water.readings_near \
  -H 'content-type: application/json' \
  -d '{"lat": 38.95, "lon": -77.13, "radius_km": 20, "limit": 3}'

const res = await fetch("https://www.realworldmcp.com/api/call/usgs_water.readings_near", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({"lat": 38.95, "lon": -77.13, "radius_km": 20, "limit": 3})
});
console.log(await res.json());