<div align="center">

# ☀️ Eighty & Sunny

**A colorful, weather-reactive MCP app.** Rich weather widgets that render right
inside your MCP host — backed by [Open-Meteo](https://open-meteo.com), with
**no API key required**.

![Python](https://img.shields.io/badge/Python-3.11+-3776AB?logo=python&logoColor=white)
![MCP App](https://img.shields.io/badge/MCP-Apps-7C3AED)
![Open-Meteo](https://img.shields.io/badge/Open--Meteo-no%20API%20key-22C55E)
![Deploy](https://img.shields.io/badge/Deploy-Render%20%7C%20Docker-0EA5E9)

</div>

---

The background reacts to **two things at once** — the time of day and the
weather. The sky palette follows each city's real sunrise/sunset (🌅 dawn glows
peach, ☀️ day is blue-and-gold, 🌆 dusk turns purple-orange, 🌙 night dims to
indigo), and the weather tints it on top (🌧️ rain cools it blue, ❄️ snow turns
icy, ⛈️ storms go deep purple, ☁️ overcast mutes to grey). It cross-fades when
you switch cities.

## ✨ Widgets

| Tool | Shows |
|------|-------|
| `show_weather` | Current-conditions card — big temp, animated icon, feels-like, today's high/low, 6-stat grid |
| `show_weather_forecast` | 7-day grid with icons, precip chance and high→low range bars |
| `show_weather_hourly` | Next-24h strip with an SVG temperature curve |
| `show_weather_dashboard` | Everything at once — current + hourly + 7-day + extra stats |
| `get_weather` | Plain JSON (current + hourly + daily), no widget |

Every widget has city **chips** to switch locations instantly and a live
**°F / °C** toggle.

## 🚀 Run it

```bash
uv sync
uv run python server/server.py        # → http://localhost:8778/mcp
```

Point your MCP host at `http://localhost:8778/mcp`. No key, no signup.

## ⚙️ Configure (all optional)

| Env var | Default | Meaning |
|---------|---------|---------|
| `WEATHER_CITIES` | `San Francisco,New York,London,Tokyo,Sydney,Paris` | The city chips |
| `WEATHER_UNITS` | `imperial` | Default units (`imperial` / `metric`) |
| `WEATHER_CACHE_TTL` | `600` | Forecast cache seconds (`0` disables) |
| `WEATHER_PREFETCH` | _off_ | `all` = fetch every city up front |

> One tool call fetches only the **active** city (≤2 requests) and caches it, so
> you stay well under Open-Meteo's free rate limit. Other chips warm from cache.

## ☁️ Deploy

**Render** — push to GitHub, then **New → Blueprint** (uses the bundled
`render.yaml`). No env vars needed.

**Docker**
```bash
docker build -t es-weather-mcp . && docker run -p 8080:8080 es-weather-mcp
```

**Azure Container Apps** — one command via the bundled Bicep (`infra/`) +
`azure.yaml`:
```bash
azd up        # provision + build + deploy  →  prints the /mcp URL
```
No secrets required; tweak cities/units in the Azure dashboard or via
`azd env set WEATHER_UNITS metric`.

---

<div align="center">

Weather by [Open-Meteo](https://open-meteo.com) · Built as an
[MCP App](https://modelcontextprotocol.io)

`#MCP` `#ModelContextProtocol` `#Weather` `#OpenMeteo` `#WeatherApp`
`#Python` `#FastMCP` `#Claude` `#AIagents` `#OpenSource`

</div>