Find the best surf
find_best_surfUse this when the person asks where or when to surf around a place. when is in the person's words (tomorrow morning, Saturday, this weekend); default the next 24 hours. Not for one spot's full hours: use get_surf_forecast. Answers surf spots near the place, ranked for the time asked (today, tomorrow, tomorrow morning, this weekend, a date): each spot's best window in that time with its wave height, period, wind and why it ranks there, and the spots with nothing good in that time last; within radius_km (default 30, at most 100).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "find_best_surf"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | ||
| lon | No | ||
| near | No | a town, a coast or a spot: Lisbon, Hossegor, Supertubos | |
| when | No | in people's words: today, tomorrow morning, this weekend, Saturday, 2026-11-28 | |
| limit | No | ||
| radius_km | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | ||
| from | Yes | ||
| near | Yes | ||
| spots | Yes |