# River Level MCP

> River Level MCP is a free MCP server for health and science. Live US river stage, streamflow and NWS flood forecasts from USGS gauges. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, self-hosted, CLI
- **Website:** https://lakelevelnow.com
- **Repository:** https://github.com/theluckystrike/river-level-mcp
- **MCP Registry name:** io.github.theluckystrike/river-level-mcp
- **Categories:** health and science, maps and travel
- **Listing updated:** 2026-11-14

## About

A river can rise ten feet in a day, so a model's months-old training data is no use for flood questions. This server reads the USGS Water Data API and the NOAA National Water Prediction Service when you ask, with no API key. Gauges report every 5 to 60 minutes, and readings older than 48 hours are flagged. USGS real-time data are provisional, and the tools say so.

You can search gauges by river, place, state or coordinates, get stage, streamflow and water temperature where measured, review daily means over 2 to 366 days, and see the current NWS forecast with its crest and flood category. Results include flood stages, feet below flood stage and the record crest. The README notes the legacy USGS waterservices endpoint shuts down on 22 February 2027, and this server already uses the new API.

A hosted Workers URL needs no token, or run locally with Node 20+. The hosted server caches readings for a few minutes.

## Features

- **Find gauges:** Search active gauges by name, state or coordinates.
- **Current level:** Stage, flow, temperature and flood category.
- **River history:** Daily means over 2 to 366 days with summary stats.
- **Flood forecast:** NWS forecast series with crest and category.
- **Stale-reading flag:** Warns when a reading is over 48 hours old.
- **New USGS API:** Uses api.waterdata.usgs.gov, not the legacy service.

## Good for

- Check whether a river is near flood stage
- Find gauges within 10 miles of a point
- See how streamflow changed over 90 days
- Look up when a river is forecast to crest

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http river-level-mcp https://river-level-mcp.lipmichal.workers.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://river-level-mcp.lipmichal.workers.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "river-level-mcp": {
      "url": "https://river-level-mcp.lipmichal.workers.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "river-level-mcp": {
      "type": "http",
      "url": "https://river-level-mcp.lipmichal.workers.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "river-level-mcp": {
      "serverUrl": "https://river-level-mcp.lipmichal.workers.dev/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "river-level-mcp": {
      "type": "http",
      "url": "https://river-level-mcp.lipmichal.workers.dev/mcp"
    }
  }
}
```

## Tools

- `find_river_gauges`: Active USGS gauges by river, place, state or coordinates with latest stage and flow
- `get_river_level`: Current stage, flow, temperature, flood stages and category
- `get_river_history`: Daily mean flow or stage for 2 to 366 days
- `get_flood_forecast`: Current NWS forecast with crest and flood category

## FAQ

### Where do the readings come from?

USGS Water Data API and the NOAA National Water Prediction Service.

### Is a key needed?

No.

### Are the readings final?

No. USGS real-time data are provisional and can be revised.

### How fresh is the data?

It is read at call time; the hosted server caches for a few minutes.

### Is River Level MCP free?

Yes. River Level MCP is free to use.

### How do I add River Level MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http river-level-mcp https://river-level-mcp.lipmichal.workers.dev/mcp

### What are the best alternatives to River Level MCP?

The closest alternatives to River Level MCP are Tooluniverse, Oya Browser, Tutu eSIM, Later Stages and Shanghai Streets Travel Guide.

## Alternatives

- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [Later Stages](https://ai-powered.com/mcp/later-stages): Later Stages is a free MCP server for health and science.
- [Shanghai Streets Travel Guide](https://ai-powered.com/mcp/shanghai-streets-travel-guide): Shanghai Streets Travel Guide is a free MCP server for maps and travel.
- [MedXpert 标准检索连接器](https://ai-powered.com/mcp/medxpert-2): MedXpert 标准检索连接器 is a free MCP server for legal and government.
- [MedXpert 全球法规连接器 (reg-connector)](https://ai-powered.com/mcp/medxpert-reg-connector): MedXpert 全球法规连接器 (reg-connector) is a free MCP server for legal and government.
- [Fifty Asks](https://ai-powered.com/mcp/fifty-asks): Fifty Asks is a free MCP server for maps and travel.

---
Source: https://ai-powered.com/mcp/river-level-mcp
