PlanYourTrip

Quickest path: give a COUNTRY and get a complete, curated multi-city round trip as a shareable planner link — no manual city selection needed. Use for requests like "plan a road trip through Turkey" or "a 10-day tour of Japan". Country names may be in any language. For hand-picked routes or regions spanning countries, use list_destinations + create_trip_link instead. Always show the returned link.

create_roundtrip

Turn an ordered list of waypoints into a shareable planyourtrip link. Open it to see the trip on an interactive map and refine dates, stops and costs. Use this after you have composed a route (e.g. via list_destinations / suggest_next_cities). Coordinates are resolved server-side — never invent them. Always show the returned link.

create_trip_link

Return the most-traveled cities for a COUNTRY or a REGION, with coordinates and typical nights per stay. Use this to discover which real places to include in a trip, then pass the ones you choose to create_trip_link. Country names may be in any language ("Türkei", "Allemagne"). Region examples: "Southeast Asia", "Balkans", "Western Europe". Provide either country or region.

list_destinations

Given cities already chosen, suggest additional cities that travelers commonly combine with them (co-visitation). Use to grow or round out a route. Returns cities with coordinates and typical nights.

suggest_next_cities