TravelPal

Search Places

Search TravelPal's curated places catalog — hotels, restaurants, attractions, neighborhoods, destinations — backed by Google Places text search plus a database enriched with Wikipedia, Viator, and Unsplash data. Pass a SHORT, natural phrase in `query` — the way you'd type into Google Maps — and put the CITY right IN the query. Aim for ~3–6 words: the ONE or TWO strongest descriptors + the category + the city. Two rules: • Do NOT keyword-stuff. Piling on adjectives retu

Get Place Details

Fetch full details for a single place — richer than what search_places returns — and render them in the place-details widget (photo gallery, map, highlights, tips, reviews). Use when the user asks about a specific result from a prior search ("tell me more about La Réserve", "what's the vibe at Bulgari?", "when is the Jardin du Luxembourg open?"). `place_id` is the integer `id` from any `search_places` result. Returns `{"place": {...}, "pricing": {...}|null}` as structur

Search Activities

Find bookable experiences (tours, day trips, tickets, food tours, cooking classes, etc.) for a destination. Backed by Viator via TravelPal's affiliate partnership — `booking_url` is affiliate-tagged and credits TravelPal. Use this when the user asks "what should I do in X", "activities in X", "tours in X", "day trips from X", "food tour in X", "tickets for X". Preferred: pass `city` (+ `country_code`) directly — the destination is resolved server-side, so this is a SING

Create Itinerary

Build a day-by-day travel itinerary and render it in the itinerary widget. This SAVES a real TravelPal trip (returns a shareable link) — use it once you've gathered the places for a plan, not for a bare list of options. USE THIS ONLY TO CREATE A NEW TRIP. If the user already has a trip on screen and wants to CHANGE it — "remove the Colosseum", "make this hotel cheaper", "swap the restaurant", "add a rooftop bar to day 2" — do NOT call create_itinerary again. Use remove_s

Get Itinerary

Re-open a saved TravelPal itinerary by its `trip_id` (from a prior create_itinerary result) and render it in the itinerary widget. Use when the user wants to see their trip again or continue planning it. Returns the same structuredContent shape as create_itinerary. If the trip doesn't exist, returns an empty itinerary (no days).

Remove Stop

Remove a stop from a saved itinerary and re-render it. Use for "drop the Colosseum", "remove day 2's dinner", etc. `trip_id` is from the create_itinerary result. `item_id` is the stop's `id` field in the itinerary structuredContent — match it by the stop the user named. Returns the updated itinerary for the widget. Note: only works on a trip you can edit (the environment's service auth).

Replace Stop

Swap one stop for a different place and re-render the itinerary. Use for "make this hotel cheaper", "replace with something more boutique", "put a different restaurant here". `item_id` is the stop's `id` from the itinerary. Provide EITHER: - `new_place_id` — a place id you already found via search_places (best when you searched for the alternative, e.g. a budget hotel), OR - `replacement` — a short description ("a budget hotel", "a rooftop bar") the tool

Add Stop

Add a stop to a day of a saved itinerary and re-render it. Use for "add a rooftop bar to day 2", "put the Borghese Gallery on day 3". `trip_id` from create_itinerary; `day_number` is the target day. Identify the place with EITHER `place_id`/`viator_product_code` (from a search) or a real `place` name the tool grounds (category from `type`). Optional `start_time`/`end_time` ("HH:MM") and a one-line `note`. Appended to the day.