Best months for an activity or species
best_monthsRanks the calendar months for one thing at one place: an activity (dive, snorkel, freedive, whale_swim), a species (e.g. manta, whale shark), or calm seas / warm water / clear water. Says whether the ranking comes from multi-year data or curated research seasons, with confidence and caveats. A decision call: metered, 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": {
"for": "<for>"
},
"name": "best_months"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| for | Yes | What to plan for: an activity (dive, snorkel, freedive, whale_swim), a species word (e.g. "manta", "whale shark"), or calm / warm / clear. | |
| lat | No | Latitude; resolves to the nearest covered area within 50 km. Use with lon. | |
| lon | No | Longitude; use with lat. | |
| area | No | Trip-planning area id, e.g. "us-hi-oahu". | |
| spot | No | Spot id; resolves to the area containing it. | |
| limit | No | How many months (default 3). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| for | Yes | ||
| area | Yes | ||
| basis | Yes | ||
| months | Yes | ||
| schema | Yes | ||
| source | Yes | ||
| status | Yes |