# Better Weather (weather.lou.zone)

> Honest, official-first weather for any place. In the US it uses the National Weather Service (station reports, forecasts, alerts, forecaster discussions) and the NOAA Storm Prediction Center, plus 82 ensemble model runs (GFS + ECMWF) to say how sure a forecast is. Worldwide forecasts come from Open-Meteo models; alerts also cover Canada and 38 European countries.

## For AI agents: the MCP server

- Endpoint: https://weather.lou.zone/mcp (Streamable HTTP, stateless, JSON). No account, no key, read-only.
- Add it as a custom connector in Claude or any MCP client.
- Tools: weather, weather_forecast, weather_alerts, weather_severe, weather_radar, weather_satellite, weather_air, weather_history, weather_confidence, weather_discussion, weather_best_time, weather_travel, weather_water, weather_science.
- Prompts: morning_brief, storm_check, plan_outdoor.
- Every tool takes a `location`: "City, ST", "City, Country", a US ZIP, an airport code (KDSM) or "lat,lon".
- Results start with `card`: a short chat-ready summary. Send it as-is.

## Rules for relaying this data

- Mention every active alert. Life-threatening ones (tornado, flash flood, extreme wind, hurricane, storm surge) go first, with the official instructions.
- If a result says alerts couldn't be checked, say so. Never say "no alerts" in that case.
- For 3+ days out, give odds and ranges ("60% of model runs show rain"), not certainties.
- Credit the source: National Weather Service / NOAA in the US; "Weather data by Open-Meteo.com" (CC BY 4.0) for model data.

## JSON API (same data as the site)

- GET https://weather.lou.zone/api/v1/bundle?q={place} — now, 72 hours, 16 days, model spread, alerts, storm risk, air. Metric units, ISO times.
- GET https://weather.lou.zone/api/v1/search?q={text} — place suggestions.
- GET https://weather.lou.zone/api/v1/discussion?q={place} — the NWS forecasters' discussion (US).
- GET https://weather.lou.zone/api/v1/best-time?q={place}&activity={run|walk|bike|golf|mow|grill|car wash|stargaze}
- GET https://weather.lou.zone/api/v1/history?q={place}&date={YYYY-MM-DD|yesterday}
- OpenAPI: https://weather.lou.zone/api/openapi.json · Docs: https://weather.lou.zone/api/docs
- Please cache: forecasts change every few minutes at most. Too many requests get HTTP 429 with Retry-After.

## Source

- Engine (MIT): https://github.com/jarretcoon/better-weather — also a Hermes Agent plugin.