Search Venues
PREREQUISITE: countryCodesIso2 must contain at least one specific country, UNLESS you are searching by venueName. If the user has not named a country (or has only mentioned a continent/broad region like "Europe" or "Southeast Asia" without committing to specific countries), call recommend-destinations first to help them pick — never call this tool with no country, with a guessed country, or to "search broadly". Vibe, group size, budget, and climate hints alone are not destination signal. Calling
Help List
List all help-article metadata (title, slug, whenToUse, exampleQuestions, tags) without full content.
Use this as the FIRST step whenever the user asks about how the platform works, the retreat booking flow, proposals, contracts, payments, company policies, account/billing, or wants to contact support or talk to a human.
Always call this before help-get.
Flow:
1. Call help-list to retrieve all article metadata.
2. Match the user's intent against each article'
Help Get
Fetch the full content of a help article by its slug. Call help-list first to pick the right slug.
You may (and should) call help-get multiple times in parallel within the same turn when several articles appear relevant to the user's question.
Help articles are INTERNAL REFERENCE ONLY — use the returned content to compose your own concise answer. NEVER link to the article itself, NEVER mention the article by title or filename, and NEVER offer to "share the help doc" or "walk throug
Get Filters
Fetch available filter options for venue searches. Returns a list of valid values that can be passed to search-venues as amenities or environments filters. Call this before presenting filter options to the user via ask-user-questions (if available).
Recommend Destinations
Recommend destination countries for a group retreat, scored by budget, safety, visa-friendliness, accommodation cost, and optionally travel distance.
Call this tool when the user wants help choosing a destination country (not a specific venue). ALSO call it whenever the user asks about venues but has NOT named a specific country (e.g. "find me a venue", "a beachfront villa for 20 people", "somewhere warm for our team") — destination must be resolved before search-venues can run. Vibe, group size
Count Venues
Count how many published venues we have in a batch of places — countries, states and cities, mixed freely in one call. This is the ONLY way to know where inventory actually is; never answer an inventory question, pick a destination, or name an alternative from your own world knowledge.
WHEN TO USE — four distinct jobs, not just the pre-search gate:
1. ANSWERING AN INVENTORY QUESTION DIRECTLY — "how many venues do you have in Portugal?", "do you cover Croatia?", "where in Spain do you have the m
Lookup City
Resolve a place the user named into a specific city record. Returns an identifier, never a coordinate — search-venues accepts a city uuid as a radius centre point or as an exclusion and accepts nothing else, so this call is the only way a radius search gets a centre. You cannot pass a latitude, a longitude, or a place name in its stead.
WHEN TO CALL: the user wants venues a distance or a drive time from somewhere ("within 100 km of Geneva", "a couple of hours from Tokyo"), or wants a place left
