Flood

liveEnvironmentWeather

River discharge and flood forecasts via the Open-Meteo Flood API

2tools
0msauth
free tier50 calls/day

Tools

get_river_dischargerequired: latitude, longitude

Get daily river discharge forecast in cubic meters per second for a location. Returns discharge values with timestamps. Use to monitor water flow rates for flood risk assessment.

Parameters
NameTypeDescription
latitudereqnumberLatitude of the location in decimal degrees.
longitudereqnumberLongitude of the location in decimal degrees.
forecast_daysoptnumberNumber of forecast days to retrieve (1–92). Defaults to 7.
▶Try it
get_flood_forecastrequired: latitude, longitude

Get multi-day flood forecast for a location with current, mean, and peak river discharge projections. Returns discharge statistics and severity assessment. Use to evaluate flood risk and timeline.

Parameters
NameTypeDescription
latitudereqnumberLatitude of the location in decimal degrees.
longitudereqnumberLongitude of the location in decimal degrees.
forecast_daysoptnumberNumber of forecast days to retrieve (1–92). Defaults to 16.
▶Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/flood/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/flood/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_river_discharge","arguments":{"latitude": 37.7749, "longitude": -122.4194}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("get_river_discharge", {"latitude":"example","longitude":"example"});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("river discharge and flood forecasts via the open-meteo flood api");