Start a trip
start_tripCreates a real Adonde trip in the traveller's account and starts its menu of real tours, sights and food. One destination, or a multi-city route in one call: pass legs (2 to 8 dated stops, as suggest_route's next.start_trip_args gives them). Returns trip_id, the stops (legs, each with its leg_id) and a status. Writes a new trip; nothing is booked. A place we cannot find is refused with a spelling check before anything is created. Use when the place, dates and party are known; use open_trip_form to collect missing details, suggest_route when the cities are not chosen yet. Next, call get_menu one stop at a time.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"destination": "<destination>",
"start_date": "<start_date>",
"end_date": "<end_date>",
"travellers": "<travellers>"
},
"name": "start_trip"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| legs | No | Multi-city: the stops in order. Each starts the day the previous one ends (or the next day) and all sit inside start_date to end_date. Send destination and country as the first stop too. | |
| pace | No | packed = more per day, balanced = breathing room, loose = an outline. | |
| notes | No | Anything else the traveller said that the planner should know. | |
| style | No | Travel style in their words: famous or hidden, early or late, food. | |
| crowds | No | Crowd tolerance: Off the beaten path, Balanced or Big city buzz. | |
| end_at | No | Road trip: where it ends (default: back at start_from). | |
| climate | No | The weather they want, if the place is open. | |
| country | No | Country name, e.g. Portugal. Send it when known; it keeps same-named cities apart. | |
| end_date | Yes | Last day of the trip, YYYY-MM-DD (not before start_date). Long trips are fine, up to about six months. | |
| interests | No | Short interest words, e.g. food, museums, hiking. | |
| trip_mode | No | The shape of the trip. standard (default); road = a drive (no flights, stops at most 4 h apart; pass start_from and optionally end_at); weekend = 1 to 3 nights, small menu, loose pace; domestic = inside the traveller's home country, flights limited to domestic airports. | |
| trip_type | No | What kind of trip it is, e.g. Relax or Culture deep-dive. | |
| intent_ref | No | The reference at the end of a chat line an Adonde card posted, e.g. K7Q2MD from "Code: K7Q2MD." (older cards: "(ref K7Q2MD)"). Pass it on its own: the card's exact arguments load on our side. Add only what the line says is still missing (for a route, the travellers). | |
| start_date | Yes | First day of the trip, YYYY-MM-DD. | |
| start_from | No | Road trip: where the drive starts. | |
| travellers | Yes | Who is travelling: adults and children's ages. | |
| around_city | No | How they like to get around each city, e.g. Walk or Metro. | |
| destination | Yes | City or town, e.g. Lisbon. | |
| origin_city | No | Where they fly or travel from, e.g. Charleston. | |
| own_flights | No | True when they are booking their own flights, so airfare is left out. | |
| budget_level | No | Price band: budget, mid or luxury. | |
| dealbreakers | No | Things to avoid. | |
| traveling_as | No | Who is going: Solo, Couple, Family or Friends group. | |
| wants_to_see | No | Things they want to see or do (the app's 'What you want to see'). | |
| between_stops | No | How they like to get between stops (multi-city): Flight, Train, Bus, Drive, Boat, Hike. | |
| resolved_places | No | Set by the trip form: places the traveller picked from search results, already located. Leave out when calling this yourself. | |
| budget_per_night | No | What they want to spend on a stay per night, in the trip currency, if they said. |