KaiCast DEVELOPERS OpenAPI llms.txt kaicast.com Connect MCP

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 (or the list_coverage MCP tool). The map and table below are rendered from it.

LIVEfrom GET /api/v1/coverage

Loading coverage…

Regions today #

RegionIdDecisionsNotes
Oʻahuus-hi-oahuFullLargest spot set; south, west and north shores
Mauius-hi-mauiFullIncludes Molokini
Kauaʻius-hi-kauaiFull
Hawaiʻi Islandus-hi-hawaiiFullKona and Kohala coasts
Molokaʻius-hi-molokaiFullOne spot

Decision support levels #

LevelMeaning
FullCalibrated visibility model plus the composite condition score. recommend_spot / best_day rank here.
Conditions onlyWind, 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 coveredNo 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:

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 — demand from agent builders shapes where coverage goes next.