GuideCompare

Get the full record for a single activity by city + canonical_id. The affiliate_url field is a tokenised /r/{token} tracking link. BOOKING LINKS: each result includes a pre-formatted `booking_markdown` field — a ready-to-render Markdown link (`[title – provider ($price)](url)`). Emit `booking_markdown` VERBATIM when offering a booking link; do not hand-build one from the raw URL. The URL is an opaque signed token: never edit, re-type, reconstruct, or add/strip any character (including stray quotes). If you cannot reproduce `booking_markdown` exactly, show the title with no link rather than guessing a URL. When the optional `reviews` field is present, surface `reviews.reviews_avg` (out of 5) and `reviews.reviews_count`; if absent the activity has no review data — do not invent or hint at a rating.

get_activity

Call FIRST for any itinerary, multi-day plan, 'top things to do,' or 'what should I see' request. Returns the curated landmark list for the city with descriptions, key features, visit durations, and coordinates — including famous sights with no bookable inventory. Entries with in_city=false are outside the city center — day-trip or half-day excursion candidates, never in-city walking-tour stops. After anchoring the plan on these landmarks, call search_activities to attach bookable experiences; match them to stops via each result's highlights field.

list_pois

List all known cities with their is_supported flag. You don't need to call this before every request — search_activities/getActivity/listPOIs already validate the city and return a clear error if it isn't supported. Call this only after such an error, or when a place name is ambiguous and you're unsure it maps to a supported city.

list_cities

Search activities in a supported city. Supports fuzzy text search and structured filters. Returns up to 50 ranked results with tokenised booking links. BOOKING LINKS: each result includes a pre-formatted `booking_markdown` field — a ready-to-render Markdown link (`[title – provider ($price)](url)`). Emit `booking_markdown` VERBATIM when offering a booking link; do not hand-build one from the raw URL. The URL is an opaque signed token: never edit, re-type, reconstruct, or add/strip any character (including stray quotes). If you cannot reproduce `booking_markdown` exactly, show the title with no link rather than guessing a URL. When the optional `reviews` field is present, surface `reviews.reviews_avg` (out of 5) and `reviews.reviews_count` alongside the activity so the user can gauge popularity; if `reviews` is absent the activity has no review data — do not invent or hint at a rating.

search_activities