Your shortlist
open_shortlistRead-onlyIdempotent
Open the conversation’s shortlist beside the chat. Saved public property IDs are kept in app model context and refreshed before display.
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": "open_shortlist"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Search public property names, locations and approved introduction text. | |
| city | No | Specific destination locality, not a nearby radius. Resolve ambiguous names before choosing a country; use the area tools for nearby discovery. | |
| page | No | ||
| pool | No | ||
| place | No | Place key from the live filter catalog. | |
| bounds | No | Map viewport as south,west,north,east in degrees; keeps homes whose public area center is inside it. West greater than east crosses the antimeridian. | |
| guests | No | Total occupancy, adults plus children. Rentals: minimum sleeping capacity. Boutique hotels: everyone in one room for a one-room quote, priced as adults, with occupancy unconfirmed until that quote succeeds. | |
| locale | No | en | |
| region | No | Published region name. Resolve informal areas such as south of France with get_filters before searching; an invented region label can return no homes. | |
| arrival | No | ||
| country | No | Destination country established by the traveler or unambiguous trip context. Ask before choosing a country for an ambiguous place name. | |
| feature | No | Collection key from the filter catalog. | |
| children | No | How many of guests are children (under 18). guests stays total occupancy, so it must exceed children; capacity counts everyone. No reader prices child ages yet. | |
| currency | No | Preferred ISO 4217 currency, e.g. USD, EUR or NOK. Rough nightly estimates use approximate conversions (USD by default) when a fresh rate is supported; otherwise retain the host currency. Dated quotes depend on host support: always inspect the returned currency. May be supplied without dates for browsing. | |
| semantic | No | Rank indexed, eligible homes by text and photo similarity. Does not establish hard facts; no lexical fallback when unavailable. | |
| amenities | No | Comma-separated keys from: air-conditioning, wifi, workspace, parking, pets, kitchen, washer, step-free. Every requested key must be explicitly present. Other details (for example pool heating) belong in semantic preferences or requirements, not invented keys. | |
| childAges | No | Each child's age at check-out, one entry per child (exactly children entries). Retained and disclosed; the host confirms child rates. | |
| countries | No | Explicit union of ISO 3166-1 alpha-2 country/territory codes, e.g. [CR, PA]. A home must match one selected country; combines with geographicArea, country and every other filter using AND. Use available codes from get_filters; never silently substitute a narrower country for an area. | |
| departure | No | ||
| quoteMode | No | Optional price/availability enrichment. exact uses supplied dates and guests; estimate requires estimateWindowStart, estimateWindowEnd, estimateNights and guests for a clearly labeled sample within supplied flexible bounds. Search does not wait for every host or filter unknown homes out. | |
| relatedTo | No | Published property ID. Find other homes from its organization, same locality first, then region/country and other locations. Excludes the source property. Additional filters still combine with AND. | |
| minBedrooms | No | ||
| minBathrooms | No | ||
| organization | No | Exact organization slug returned on a property or in get_filters. Restricts results to that organization, across destinations. | |
| estimateNights | No | Sample-stay nights, required. Only with quoteMode:estimate. | |
| geographicArea | No | Exact geographic area key from get_filters(kind:geography), including continents and subregions. Americas includes North/Central/South America and the Caribbean. north-america includes Northern America, Central America and Caribbean; northern-america is the narrower UN M49 subregion. Filters by public ISO country/territory code; unknown locations never match. Combines with all other filters using AND. | |
| accommodationType | No | Filter by reviewed accommodation type. Hotel results represent one establishment; guest count requires a quote for one suitable room, never total hotel capacity. | |
| estimateWindowEnd | No | Latest sample departure (YYYY-MM-DD), paired with estimateWindowStart. Window must fit estimateNights (required), at most 150 days. | |
| estimateWindowStart | No | Earliest sample arrival (YYYY-MM-DD), paired with estimateWindowEnd. Only with quoteMode:estimate. Preserve the traveler's flexible month or date range. | |
| reassessPropertyIds | No | Up to four previously discussed public property IDs to reassess against this semantic request alongside fresh matches. Use when refining or comparing earlier suggestions. This reserves comparison slots only: current factual filters, indexed source ownership and every essential requirement still apply. It does not keep an old recommendation or establish fit. Omit for a new search without earlier candidates to reassess. | |
| semanticPreferences | No | Individual experiential preferences, each copied verbatim from semantic. Interpret the traveler in context: separate requested preferences without adding needs. Keep related words together when they describe one room, view or relationship. These are questions to assess, not property facts; omit for factual-only searches. | |
| semanticRequirements | No | Essential trip requirements, each copied verbatim from semantic with all relationship and provenance qualifiers. Every one must have source-backed support before a home is returned. Preserve these from the conversation; ordinary preferences belong in semanticPreferences. Omit when no essential experiential requirements were stated. Interpret semanticRequirements as conditions the accommodation or its setting must satisfy. Preserve essential support for the traveler's primary activity and access needs, including when expressed indirectly. Preserve the traveler's complete context in semantic. When the traveler states an explicit offering condition together with their own plans, circumstances or reasons, copy the complete offering condition as the essential; do not create an additional standalone proof obligation for the traveler's plan or circumstance. Keep any context necessary to understand the condition, its scope and relationships. Do not broaden a specific access requirement into proof of every aspect of the trip, and do not drop an actual offering condition because it is motivated by a traveler's circumstances. When a circumstance leaves the required accommodation or access condition ambiguous, ask one short clarifying question before searching; do not submit the circumstance itself as a property-proof requirement. If the offering condition itself is ambiguous, clarify it in the real conversation instead of inventing a stricter condition. |