Skip to content
MCP server

River Level MCP

Live US river stage, streamflow and NWS flood forecasts from USGS gauges

Pricing
Free
Platforms
API, self-hosted, CLI
Runs
Remotely
Version
1.0.0
Listing updated
3 days ago

About River Level MCP

River Level MCP is a free MCP server for health and science. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://river-level-mcp.lipmichal.workers.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "river-level-mcp": {
      "url": "https://river-level-mcp.lipmichal.workers.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Free

Free hosted endpoint; no key

Prices change. Check lakelevelnow.com before you buy.

River Level MCP 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 to River Level MCP

  1. Tooluniverse

    MCP server

    MCP server giving AI agents access to thousands of scientific research tools

    Runs locally
    • Open source
    • 1.8K GitHub stars
    • Health and science
  2. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  3. Tutu eSIM

    MCP server

    Live travel eSIM plans, prices and roaming costs for 190+ countries

    • 5 tools
    • Remote
    • Paid
    • Maps and travel
  4. Later Stages

    MCP server

    California senior living and care provider records from state licensing and Medicare

    • 6 tools
    • Remote
    • Free
    • Health and science
  5. Curated places, walking routes and areas in Shanghai, Jiangsu and Zhejiang

    • 9 tools
    • Remote
    • Free
    • Maps and travel
  6. Read-only local index of medical-device standards with official links, no standard text

    Runs locally
    • 4 tools
    • Free
    • Legal and government