# Canada River Levels & Flood Watch

> Real-time river and lake levels from Water Survey of Canada gauges near any postal code — trends, rise rates and multi-site flood watch for your AI agent.

Remote MCP server (Streamable HTTP): https://ca-river-levels-mcp.donniertf.workers.dev/mcp
Free tier: `river_levels` — no key, no sign-up, 20 calls/day per IP.
Pro: C$15/month, cancel anytime — all tools, unlimited.

## Tools
- river_levels (free): FREE. Latest real-time river/lake water levels and flows at gauges within 25 km of a Canadian postal code. Nearest 3.
- gauge_trend (Pro): PRO. Level/flow history for a station (up to 30 days): min, max, latest, 24h change and rise rate.
- flood_watch (Pro): PRO. For up to 25 postal codes: nearest gauge and its 24-hour level change (rising sites first).

## Buying (agents)
1. POST https://ca-river-levels-mcp.donniertf.workers.dev/checkout -> {checkout_url, session_id}. A human (or a payment-capable agent) completes Stripe Checkout at checkout_url.
2. GET https://ca-river-levels-mcp.donniertf.workers.dev/token?session_id=... -> {access_token}.
3. Send Authorization: Bearer <access_token> to https://ca-river-levels-mcp.donniertf.workers.dev/mcp (or pass access_token in tool arguments).

## Pay per call (x402, USDC on Base)
No account: POST JSON args to https://ca-river-levels-mcp.donniertf.workers.dev/x402/<tool> -> HTTP 402 with payment requirements ($0.05 USDC per call, payTo 0x02226D28e0c85AE4AdDB7fe7043Dd2b1Ff710D41). Retry with an X-PAYMENT header (x402 v1, scheme exact, network base). Manifest: https://ca-river-levels-mcp.donniertf.workers.dev/.well-known/x402. MCP clients may also send X-PAYMENT on tools/call.
Machine-readable pricing: https://ca-river-levels-mcp.donniertf.workers.dev/pricing.json · Server card: https://ca-river-levels-mcp.donniertf.workers.dev/.well-known/mcp

## Sources
- Water Survey of Canada real-time hydrometric data via ECCC MSC GeoMet OGC API (Open Government Licence – Canada)
- Zippopotam.us postal area geocoding

## Notes
Provisional real-time water levels and flows from the Water Survey of Canada (ECCC MSC GeoMet API). Data are unverified. For flood safety follow provincial flood forecasting centres and local emergency guidance.
Contact: dmorrisonwebdesign@gmail.com. More UK data MCPs: https://github.com/donniertf-hub/uk-mcp-fleet