# RiverWatch: USGS river levels & stream-flow gauges — per query

> RiverWatch: USGS river levels & stream-flow gauges — per query is a freemium MCP server for weather. MCP server returning USGS river levels and stream-flow gauge readings, pay-per-query. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API
- **Website:** https://a2awire.com/data/riverwatch-usgs-river-levels-stream-flow-gauges-dc094e
- **Repository:** https://github.com/ee324/a2awire
- **MCP Registry name:** com.a2awire/data-river-level-stream-flow-flood-alert-gauge
- **Categories:** weather
- **Listing updated:** 2026-11-18

## About

The registry entry describes RiverWatch as a river level and flood alert service built on USGS gauge data. It is offered as a remote MCP server over streamable HTTP, so an AI client connects to a URL rather than installing a local package.

Billing is per query, with the registry listing a price of $0.01 per call. The registry text also mentions free testnet funds for a first call, which suggests a pay-as-you-go model settled through the vendor's own A2A wire platform.

It suits developers and agent builders who want an assistant to check current stream conditions or flood-related readings without wiring up USGS endpoints themselves.

## Features

- **USGS gauge data:** Pulls river level and stream-flow readings from U.S. Geological Survey gauges.
- **Remote streamable HTTP:** Connects to AI clients over a hosted endpoint without a local install.
- **Pay-per-query pricing:** Each query is billed at a listed per-call rate of $0.01.
- **Flood alert focus:** Positioned around flood-level monitoring alongside stream-flow data.

## Good for

- Checking current river levels before planning a paddling or fishing trip
- Monitoring stream-flow readings for a flood-watch assistant
- Adding USGS gauge lookups to an AI agent workflow
- Getting quick flood-level context for a specific river gauge

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http data-river-level-stream-flow-flood-alert-gauge https://a2awire.com/mcp/data/riverwatch-usgs-river-levels-stream-flow-gauges-dc094e/http
```

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

```sh
https://a2awire.com/mcp/data/riverwatch-usgs-river-levels-stream-flow-gauges-dc094e/http
```

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

```json
{
  "mcpServers": {
    "data-river-level-stream-flow-flood-alert-gauge": {
      "url": "https://a2awire.com/mcp/data/riverwatch-usgs-river-levels-stream-flow-gauges-dc094e/http"
    }
  }
}
```

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

```json
{
  "servers": {
    "data-river-level-stream-flow-flood-alert-gauge": {
      "type": "http",
      "url": "https://a2awire.com/mcp/data/riverwatch-usgs-river-levels-stream-flow-gauges-dc094e/http"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "data-river-level-stream-flow-flood-alert-gauge": {
      "serverUrl": "https://a2awire.com/mcp/data/riverwatch-usgs-river-levels-stream-flow-gauges-dc094e/http"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "data-river-level-stream-flow-flood-alert-gauge": {
      "type": "http",
      "url": "https://a2awire.com/mcp/data/riverwatch-usgs-river-levels-stream-flow-gauges-dc094e/http"
    }
  }
}
```

## FAQ

### How much does each query cost?

The registry entry lists a price of $0.01 per query.

### How do I connect to it?

It is offered as a streamable HTTP MCP endpoint at the URL given in the registry entry.

### Is there a free option?

The registry entry mentions free testnet funds for a first call.

### Is RiverWatch: USGS river levels & stream-flow gauges — per query free?

RiverWatch: USGS river levels & stream-flow gauges — per query has a free plan, with paid plans for more usage or features.

### How do I add RiverWatch: USGS river levels & stream-flow gauges — per query to Claude Code?

Run this command in your terminal: claude mcp add --transport http data-river-level-stream-flow-flood-alert-gauge https://a2awire.com/mcp/data/riverwatch-usgs-river-levels-stream-flow-gauges-dc094e/http

### What are the best alternatives to RiverWatch: USGS river levels & stream-flow gauges — per query?

The closest alternatives to RiverWatch: USGS river levels & stream-flow gauges — per query are Weatherbit MCP by usefulapi, WeatherLink MCP by usefulapi, FieldClimate MCP by usefulapi, Weather With Attitude and Faceabot Weather.

## Where this comes from

- Description: written from its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Weatherbit MCP by usefulapi](https://ai-powered.com/mcp/weatherbit-mcp-by-usefulapi): Weatherbit MCP by usefulapi is a freemium MCP server for weather.
- [WeatherLink MCP by usefulapi](https://ai-powered.com/mcp/weatherlink-mcp-by-usefulapi): WeatherLink MCP by usefulapi is a freemium MCP server for weather.
- [FieldClimate MCP by usefulapi](https://ai-powered.com/mcp/fieldclimate-mcp-by-usefulapi): FieldClimate MCP by usefulapi is a freemium MCP server for agriculture.
- [Weather With Attitude](https://ai-powered.com/mcp/weather-with-attitude): Weather With Attitude is a free MCP server for maps and travel.
- [Faceabot Weather](https://ai-powered.com/mcp/faceabot-weather): Faceabot Weather is a free MCP server for maps and travel.
- [Smarter Weather](https://ai-powered.com/mcp/smarter-weather): Smarter Weather is a freemium MCP server for maps and travel.
- [Precip](https://ai-powered.com/mcp/precip): Precip is a freemium MCP server for maps and travel.
- [US Weather Alerts (NWS Warnings & Watches) — buy per-query in-session (usweather)](https://ai-powered.com/mcp/us-weather-alerts-nws-warnings-and-watches-buy-per-query-in): US Weather Alerts (NWS Warnings & Watches) — buy per-query in-session (usweather) is a paid MCP server for maps and travel.

---
Source: https://ai-powered.com/mcp/riverwatch-usgs-river-levels-and-stream-flow-gauges-per-quer
