Recommend spots
recommend_spotRanked top picks (max 5) for an activity in one area on one day — by region id, or lat+lon with a radius. Each pick has the best daylight window, why (from the published conditions), a confidence score with its factors, caveats, and a KaiCast spot card. Returns status "not_covered" / "conditions_only" / "activity_not_modeled" honestly instead of guessing. Activities: snorkel (native model), dive, freedive, spearfish (proxy model; spots in water closed to spearfishing are excluded), surf (not modeled). Free during early access.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"activity": "<activity>"
},
"name": "recommend_spot"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | Latitude, decimal degrees. Use with lon. | |
| lon | No | Longitude, decimal degrees. Use with lat. | |
| date | No | Spot-local day to plan for. Default: today, or tomorrow once today's daylight has passed. Up to 6 days ahead. | |
| spot | No | Spot id, e.g. "hanauma-bay". | |
| limit | No | How many picks (default 3, max 5). | |
| region | No | Region id, e.g. "us-hi-oahu". | |
| activity | Yes | What the user wants to do. | |
| radius_km | No | Search radius around lat/lon in km (default 40, max 100). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| picks | Yes | ||
| schema | Yes | ||
| source | Yes | ||
| status | Yes | ||
| message | No | ||
| coverage | Yes | ||
| disclaimer | Yes |