Price range
price_rangeUse it when the person asks what a stay costs and has no exact days or yacht yet. Pass the place they named (in words, or a placeId a search_yachts or list_places answer gave), how many nights the stay is, the party, and the month when they named one. nights and party are required: ask the person when they have not said them. It answers, for the yachts there with room for the party, the range of each one's lowest price for a stay of that many nights starting that month, as the company states it for the whole stay (p25, median and p75, in minor units of the currency; no extras), how many yachts it is from and the cheapest one by its id, name and town. Say each figure with its nights; it is a weekly price only when the stay is 7 nights. With no month, the next months with prices and a note to ask which. An unknown place answers with suggestions; a name of more than one place lists them to choose. For yachts free on their days, call search_yachts. When the person picks a yacht, call request_quote (ask their email or phone first). Arguments: place, month, nights, party. Any other name is refused.
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": {
"place": "<place>",
"party": "<party>",
"nights": "<nights>"
},
"name": "price_range"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| month | No | YYYY-MM, or the month's name ("July"). Leave out when the person has not said: the answer gives the next 3 months with prices. | |
| party | Yes | How many people. | |
| place | Yes | Where, in words (a region, a country or an area inside one), or a place value as an unknown_place answer lists them. | |
| nights | Yes | How many nights each stay is: every figure is a stay of this length. Ask the person when they have not said. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| read | No | How the figures were read, in words. | |
| thin | No | true: few items, a rough figure. | |
| items | Yes | How many items the figures are from. | |
| month | No | The month the figures are for, YYYY-MM. | |
| place | No | The place answered, by BM's name (e.g. Croatia). | |
| range | No | p25, p50 (median), p75 of each item's lowest stay of the asked nights that month, for the whole stay, minor units (e.g. cents); null when too few items. | |
| months | No | Only when no month was asked: the next months with prices, each with items, range (minor units) and thin. | |
| placeId | No | That place's id, to pass back as placeId to search. | |
| browsing | No | true: answered without sign-in: the first pages only. | |
| cheapest | No | The cheapest item that fits, that month. | |
| currency | Yes | ISO 4217, as BM states it; other currencies are left out, never converted. | |
| monthNote | No | Only when no month was asked: those months in words, and to ask the person which month. |