Find a place
places_searchResolve a town, beach, harbour or cove name to Peskio placeIds (Europe, North Africa and US coasts). Call this first whenever the user names a place, then pass the placeId to the other tools. candidates[0] is the best match: when ambiguous is false, use it without asking (a harbour or beach listed after a town of the same name is part of that place). Ask which one the user means only when ambiguous is true (the same name in different regions). Never ask the user for coordinates.
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": {
"query": "<query>"
},
"name": "places_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | The user's language (ISO 639-1; one of Peskio's 15, otherwise 'en'). Picks the peskio.com page language and local place names; answer in the user's language yourself. | en |
| limit | No | ||
| query | Yes | The place name as the user wrote it, optionally with its region. | |
| country | No | ISO 3166-1 alpha-2 code, lower case, to restrict to one country. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| exact | Yes | A candidate carries the searched name (in any of its languages) and it is candidates[0]. false = Peskio does not have that place; candidates are only similar names. | |
| schema | Yes | ||
| ambiguous | Yes | true = ask the user which candidate they mean (same name in different regions, or no exact match). | |
| candidates | Yes | ||
| attribution | Yes |