# Coverage

KaiCast forecasts named **spots** — dive and snorkel sites with a calibrated location on the water — grouped into **regions** with global ids (`{country}-{admin1}-{area}`, e.g. `us-hi-oahu`). Location is always a parameter, and coverage grows region by region; anywhere not listed is **not covered yet**, and every endpoint says so explicitly instead of guessing.

The live list is always at [`GET /api/v1/coverage`](https://kaicast.com/api/v1/coverage) (or the `list_coverage` MCP tool). The map and table below are rendered from it.

> Live list: https://kaicast.com/api/v1/coverage (JSON).

## Regions today

| Region | Id | Decisions | Notes |
|---|---|---|---|
| Oʻahu | `us-hi-oahu` | Full | Largest spot set; south, west and north shores |
| Maui | `us-hi-maui` | Full | Includes Molokini |
| Kauaʻi | `us-hi-kauai` | Full | |
| Hawaiʻi Island | `us-hi-hawaii` | Full | Kona and Kohala coasts |
| Molokaʻi | `us-hi-molokai` | Full | One spot |

## Decision support levels

| Level | Meaning |
|---|---|
| **Full** | Calibrated visibility model plus the composite condition score. `recommend_spot` / `best_day` rank here. |
| **Conditions only** | Wind, swell, tide and temperature are published, but there's no credible clarity model yet, so decision tools decline with `status: "conditions_only"` and point to the facts. Any newly published region starts here. |
| **Not covered** | No public data. Decision tools return `status: "not_covered"` with the nearest covered spot and its distance; `get_conditions` returns `no_spot_nearby`. |

## Data quality, per answer

Quality isn't uniform even inside a covered region, so every answer says what it's built on:

- **`visibility_source`** — `satellite` when a recent satellite water-clarity reading feeds the estimate; `heuristic` when visibility is estimated from wind, swell, rain and tide alone (satellite ocean color is often clouded out). Decisions add a `visibility_estimated` caveat and lower confidence for heuristic estimates.
- **`freshness`** — `live`, `recent`, `aging`, `stale` or `none`, for the model's inputs. Stale inputs add a `stale_inputs` caveat.
- **`confidence`** — per period (0–1), from the model.
- **Calibration** — visibility predictions are corrected nightly against divers' logged observations (bias per spot and condition bucket). Spots with more logged dives are better calibrated.

## Inputs

NOAA NDBC buoys and CO-OPS tides, PacIOOS ROMS and WaveWatch III ocean models, Open-Meteo Marine, OpenWeather, NOAA CoastWatch satellite ocean color (Kd490, chlorophyll), USGS stream gauges and Hawaiʻi DOH advisories for runoff, CUDEM bathymetry for exposure. Each conditions response lists the `sources` that fed it.

## Forecast horizon

7 days, in 3-hour periods, refreshed hourly. No historical conditions are served.

## Requesting a region

Building for somewhere KaiCast doesn't cover yet? Tell us where and what you need at [dawson@kaicast.com](mailto:dawson@kaicast.com) — demand from agent builders shapes where coverage goes next.
