protogrid

Search / io.github.theluckystrike/river-level-mcp

River Level MCP

R0· no sign-in

Live US river levels, streamflow and NWS flood forecasts from USGS stream gauges.

v1.0.0 · active · repository · website · descriptor JSON · versions

An agent can connect right now, no human step.Remote endpoint, no authentication, reachable on the last probe.
Quality89new
Trust96of 100
Uptime, 30 days94%
Latency p50314 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "river-level-mcp": {
      "type": "http",
      "url": "https://river-level-mcp.lipmichal.workers.dev/mcp"
    }
  }
}
claude mcp add --transport http river-level-mcp https://river-level-mcp.lipmichal.workers.dev/mcp
[mcp_servers.river-level-mcp]
url = "https://river-level-mcp.lipmichal.workers.dev/mcp"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "river-level-mcp": {
      "type": "remote",
      "url": "https://river-level-mcp.lipmichal.workers.dev/mcp",
      "enabled": true
    }
  }
}
{
  "mcpServers": {
    "river-level-mcp": {
      "type": "http",
      "url": "https://river-level-mcp.lipmichal.workers.dev/mcp"
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=river-level-mcp&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vcml2ZXItbGV2ZWwtbWNwLmxpcG1pY2hhbC53b3JrZXJzLmRldi9tY3AifQ%3D%3D"
}
{
  "servers": {
    "river-level-mcp": {
      "type": "http",
      "url": "https://river-level-mcp.lipmichal.workers.dev/mcp"
    }
  }
}
{
  "mcpServers": {
    "river-level-mcp": {
      "httpUrl": "https://river-level-mcp.lipmichal.workers.dev/mcp"
    }
  }
}
extensions:
  "river-level-mcp":
    enabled: true
    name: "river-level-mcp"
    type: streamable_http
    uri: "https://river-level-mcp.lipmichal.workers.dev/mcp"
    timeout: 300

Quality 89 / 100new

protocol75 · weight 25
  • warn
    protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
  • n/a
    protocol.statelessonly applies to 2026-07-28 servers
  • pass
    protocol.transportstreamable HTTP
  • n/a
    protocol.list_ttlonly applies to 2026-07-28 servers
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene100 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • pass
    tools.description_lengthdescriptions are concise
  • pass
    tools.schemasevery tool has an object input schema
  • pass
    tools.annotations4 of 4 tools declare readOnlyHint or destructiveHint
  • pass
    tools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
  • pass
    tools.token_costabout 1,030 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stabilityn/a · weight 15
  • n/a
    stability.changes, stability.rug_pulltool history recorded for 4 of the 7 days needed
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

4 tools, about 1,030 tokens to load them all · tool set 8154f2796253 · checked 2026-11-07 17:28 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 96 / 100

provenance90
liveness98
freshness100
hygiene100

+repository +namespace-matches-repo +website +reachable +uptime-94% +updated-4d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://river-level-mcp.lipmichal.workers.dev/mcp streamable-httpnoneyes94%314 ms2025-11-252026-11-07

Tools (4)

find_river_gaugesread-onlySearch 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.
get_flood_forecastread-onlyThe 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.
get_river_historyread-onlyDaily 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.
get_river_levelread-onlyCurrent 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.

Schemas: list_tools.

Similar MCP servers

More from io.github.theluckystrike

And 298 more from this publisher.

Official server.json
{
  "name": "io.github.theluckystrike/river-level-mcp",
  "title": "River Level MCP",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://river-level-mcp.lipmichal.workers.dev/mcp",
      "type": "streamable-http"
    }
  ],
  "version": "1.0.0",
  "repository": {
    "url": "https://github.com/theluckystrike/river-level-mcp",
    "source": "github"
  },
  "websiteUrl": "https://lakelevelnow.com",
  "description": "Live US river levels, streamflow and NWS flood forecasts from USGS stream gauges."
}