add-accommodations
ChatGPTAdd hotels/stays to a draft trip by hotel name (or hotel_id). The server searches the Holicay hotel pool, including autocomplete, and saves a catalog hotel when one name matches, such as "Four Seasons Sultanahmet" for "Four Seasons Hotel Istanbul at Sultanahmet". A catalog stay is saved like a manual add: hotel photos, star rating, the hotel check-in and check-out times, and the cheapest live room quote as the rate and cost. If several hotels match, none is substituted. Otherwise the requested name is added as a custom stay at that hotel's own address when it can be found. Pass cost as the stay total for the whole party: a repeated nightly room price times the number of nights. That cost is kept only when the hotel has no live room quote. For multi-city trips, any route city missing a stay is auto-filled with a recommended hotel (or placeholder) using transfer-day check-in/out dates.
add-cities
ChatGPTAppend cities to the end of the draft trip route. Each name is resolved with city search. A city already on the route is skipped.
add-custom-expense
ChatGPTAdd a custom budget expense, or a new split bill, that is not an itinerary item. For "split 400 euros between Ashwin, Jon and me", ask for the expense name, the category, and how to split (equally, exact amounts, or percentages) when the user has not already said them. Wait for the answer. Do not invent a title or category. "me" is the signed-in member. Resolve other people by name. One person is the owner, the payer. When isSplit is true, pass typeSplit. Categories are Transportation, Accommodation, Experience, Place, Food & Beverage, and Other. After success, reply with the message.
add-days
ChatGPTExtend the trip (before/after) or insert empty days after a specific day (afterDay).
add-distances
ChatGPTAdd or update one distance leg on a draft trip. Use this when the user wants the travel mode, duration, or route length between two items. from is item A and to is item B (name, uid, or placeId). vehicle is WALKING, DRIVING, CYCLING, or PUBLIC_TRANSPORT. Walking, driving, and cycling use the straight-line distance. Walking is 5 km/h, cycling is one third of the walking time, and driving is 40 km/h up to 10 km and 80 km/h after that. That vehicle is saved even when the distance is over 2.5 km. PUBLIC_TRANSPORT calls the direction lookup once per pair. It does not check Pro. If the lookup returns an id and steps, the leg becomes PUBLIC_TRANSPORT. If both providers miss, the previous vehicle stays. Pass day when the two items share more than one date. This loads the trip, updates that leg in distances, and saves the full distances array. After success, reply with the message.
add-experiences
ChatGPTAdd experiences to a draft trip. A private guide, yacht cruise, hammam, or balloon flight belongs here, not in add-places. Pass experience_id when it is known. For a request like "add a day tour on day 3", pass query "day tour" and day 3: the tool searches that day's city pool and adds the matching product. If nothing matches, the requested name is added as a custom experience with no product id, at that place's own address when it can be found. Pass category only from this list: Day Trips, Attraction Tickets, Class / Workshop, Transportation, Guided Tours, Day Tour, Workshop/Class, Adventure, Guided Experiences, Guided Tour, Cruises, Cultural Experiences, Sports & Outdoor Activities, Attraction, Lifestyle, Entertainment, Events, Sustainability, F&B, WiFi & SIM Card, Others, Tours, Activities. A cruise is Cruises, a hammam is Lifestyle, a balloon is Adventure, and a private guide is Guided Tours. If category is omitted, the server chooses one from that list. Pass cost when the itinerary states a price. A different product is not substituted.
add-foods
ChatGPTAdd restaurants to a draft trip by name. Pass restaurant_name, the visit date and time, city when you know it, and cost when the itinerary states a meal price. The server finds the Google Maps place id from that name and loads the place details, including the street address. Do not search the web for a ChIJ place id and do not invent one. Hotels are rejected. A different restaurant is never substituted. Day 1 visits before that day’s check-in or transport are rejected so they can be retried later.
add-places
ChatGPTAdd sights and attractions to a draft trip by name. A catalog place is saved when its name matches and it is in the city. A name with a general word such as market, waterfront, square, or park uses the nearby catalog place in that city which shares the place name, for example Kadıköy Çarşı for Kadıköy Market. A place in another city is not used. Otherwise the requested name is added as a custom place at that venue's own address when it can be found. A private guide, yacht cruise, hammam, or balloon flight is an experience: those names are rejected here, so call add-experiences. Pass cost when the itinerary states a price, including 0 when it is free. Skip day totals, tips, and lines that say not included. A name that only matches another region is not added. Day 1 visits before that day’s check-in or transport are rejected so they can be retried later.
add-transportations
ChatGPTAdd transport legs to a draft trip. For a flight added by code, call check-flight-number first. matchCount 1: pass that addTransportationParams object through unchanged. matchCount 2+: wait for the user to choose, then pass only that option. Do not invent airports, times, or a productId. For a train, bus, car, taxi, ferry, or private transfer, set transport_type and the pickup and dropoff place names, not only the city. The server geocodes each end separately and sets vehicle to one of Trains, Buses, Flights, Cars, Vans, Ferries, Boats, Private Transfers. A private transfer stays Private Transfers. A taxi or Mercedes is Cars. Pass cost when the itinerary states a price. Coordinates are not copied from the other end.
auto-add-cities
ChatGPTAdd cities that are missing from the draft trip route. Each name is resolved with city search. A city already on the route is skipped.
check-flight-number
ChatGPTLook up a flight by code and YYYY-MM-DD (map Day N from the trip, or pass uid and day). Normalize codes like "TR 884" to TR884. matchCount 1: pass addTransportationParams to add-transportations. matchCount 2+: ask which flight. No match: do not add a manual flight.
check-weather
ChatGPTDaily forecast for a draft trip or one of its route cities (rain, temperature, packing). Omit city to use the first route city. Dates default to the trip range.
clear-day
ChatGPTClear items from one or more days (or all). Optionally filter by item types.
create-draft-trip
ChatGPTCreate an empty Holicay draft trip: cities, dates, and title only. Days are generated from the dates, with no places, food, stays, or transport. Use this whenever the user says create, make, start, or new trip, including when they also give cities and dates. For a pasted day-by-day itinerary that already names venues, times, and prices, call this first with those cities, dates, and the prompt currency (for example EUR), then add each line with the add tools. Do not call plan-draft-trip for that pasted itinerary. Call plan-draft-trip only when they explicitly ask to plan or generate an itinerary without listing the days. Call this at most once per user request. On the creator MCP, POST /v1/draft-trips/mcp and pass authorId or authorEmail when the author is known. The planner MCP ignores those fields. When the result includes websiteUrl, tell the user that planner link. When the result includes forwardingEmail, always tell the user that address so they can forward booking emails into the trip. Do not mention a share link, shareUrl, or linkRole unless the user asked for a share link or to change who can view or edit the trip.
delete-expense
ChatGPTDelete a budget expense by its UID, name, or amount. A number such as 400 is the expense amount. If several match, ask which one. Deleting a stay, place, food, experience, or transport expense that came from the itinerary can also remove that item from the trip. When needsClarification is true, ask that question and wait. After success, reply with the message.
delete-trip-items
ChatGPTDelete itinerary items from a draft trip by fuzzy name match (optional type filter).
explore-trips
ChatGPTExplore published Holicay community itineraries by destination/search text.
export-trip-to-pdf
ChatGPTExport a draft trip planner as a PDF. Any request with download, pdf, export, or print means this tool. Returns downloadUrl. After success, reply exactly: "Exported successfully - download a copy here:" then the downloadUrl on the next line.
get-city-experiences
ChatGPTLook up Holicay experience prices for one city. Use this when the user asks what an experience, tour, or activity costs in a city. Pass city, or uid and day to use that trip day's city. Optional query filters the pool, for example "day tour" or a product name. Each result includes price and currency from the product's first variation. Pass currency to price them in that currency; otherwise it uses the trip currency, or USD. This does not add anything to the trip.
get-draft-trip
ChatGPTFetch a Holicay draft trip by UID, including days and itinerary items. On the creator MCP this is GET /v1/draft-trips/mcp/{uid} and currentAccessRole is OWNER. When the result includes forwardingEmail, always tell the user that address so they can forward booking emails into this trip. Do not mention a share link, shareUrl, or linkRole unless the user asked for a share link or to change who can view or edit the trip. Do not call get-share-link unless they asked.
get-expense-detail
ChatGPTRead one budget expense on a draft trip. Pass the expense UID from get-trip-expenses. Settlement UIDs are not expense UIDs. Does not change the trip. After success, reply with the message.
get-featured-trip
ChatGPTGet details for a featured/published Holicay itinerary by UID.
get-forwarding-email
ChatGPTUse this when the user asks for the email forward link or forwarding address. Print the email address for forwarding bookings into a draft trip. Holicay adds forwarded confirmations to that planner. The address is trip+{uid}@in.holicay.com, or trip+{uid}@in-staging.holicay.com when the web URL is staging. After success, reply with the email address and say they can forward booking confirmations there. Do not mention a share link unless the user asked for one.
get-my-trips
ChatGPTList draft trips (planners) owned by the signed-in Holicay user. Requires Holicay login on the HTTP MCP. Does not include trips that were only shared with the user. Each trip may include plannerUrl and forwardingEmail. When the user is referring to one of these trips, tell them that planner link and, when forwardingEmail is present, that address so they can forward booking emails into it. Do not mention a share link, shareUrl, or linkRole unless the user asked for a share link or to change who can view or edit the trip. Do not call get-share-link unless they asked.
get-route-length
ChatGPTPrint route length and travel time for a draft trip. Use this when the user asks how far, how long the route is, or the travel time for a day or between two places. Pass day for one day in visit order. Pass from and to for one hop. Omit day to cover every day. Places, food, experiences, and stays need a location. Does not change the trip. After success, reply with the message.
get-share-link
ChatGPTCall this only when the user asks for the share link. Return the public share link for a draft trip and its current access. The URL is the Holicay site (holicay.com or staging.holicay.com) plus /planner/ and the get-link code. An unset role is saved as VIEWER. An existing EDITOR role stays EDITOR. After success, reply with shareUrl and say whether anyone with the link can view or edit the trip. To change that access, call update-share-link-permission. Do not call this while creating a trip, planning a trip, or looking up a trip unless they asked for the share link.
get-trip-debts
ChatGPTShow who owes whom on a draft trip. Use this when the user asks about balances, debts, or who owes money after a split. Does not change expenses. After success, reply with the message.
get-trip-expenses
ChatGPTList budget expenses and debt settlements for a draft trip. Opens the trip budget first so itinerary costs are included, then reads them. Does not change itinerary items. After success, reply with the message.
get-trip-item-attachments
ChatGPTRead attachment URLs for activities, food places, accommodations, experiences, and transportations on a draft trip. URLs come from attachments, ticket links, and purchase links. Pass types to limit the groups, or name to filter one item. Does not change the trip.
get-trip-item-notes
ChatGPTRead notes for activities, food places, accommodations, experiences, and transportations on a draft trip. Pass types to limit the groups, or name to filter one item. Does not change the trip.
get-trip-members
ChatGPTList the people added to a draft trip. Returns the count plus each email and permission (OWNER, EDITOR, or VIEWER). Use this when the user asks who is on the trip, how many people were added, or what access each person has. Does not change the trip. After success, reply with the count and each email and role.
invite-friend-to-trip
ChatGPTInvite a friend to a draft trip by email. viewer or editor in any casing already counts — pass that role (VIEWER or EDITOR). Never OWNER. The trip must already have an owner on its share list. Only treat the invite as successful when success is true and the saved role matches.
lookup-hotel-rooms
ChatGPTLook up rooms and prices for one hotel. Does not add the stay to a trip. Pass hotel_name plus a city (or lat and lng), or hotel_id when it is already known. checkin and checkout are YYYY-MM-DD. If several hotels match the name, the result lists them and does not pick one. When one hotel matches, returns stay details, the cheapest priced room as the default, and the cheapest rate for each room and meal. A different hotel is never substituted.
optimize-route-for-day
ChatGPTReorder and retime a day's places/food/experiences/hotels between a start and end point.
plan-draft-trip
ChatGPTPlan a draft trip and fill the itinerary with this server's tools: search activities and restaurants, then add places, meals, stays, and inter-city transport. Do not use this for a pasted day-by-day itinerary that already names venues, times, and prices. Create that draft and add each line with the add tools instead. Use this only when the user explicitly asks to plan the trip or generate an itinerary and has not listed the days. Cities and dates alone mean create-draft-trip, which leaves the trip empty. Before calling, if the user has not said how many people are going, ask them and wait. Pass that count as numberOfPeople. Do not guess a party size and do not default to 1. This tool creates the draft and saves the planned items before it returns. Do not pass or invent a uid. Do not add those same items again unless the user asks for changes. Call this at most once per user request. On the creator MCP, the draft is created with POST /v1/draft-trips/mcp. Pass authorId or authorEmail when the author is known. The planner MCP ignores those fields. When the result includes websiteUrl, tell the user that planner link. When the result includes forwardingEmail, always tell the user that address so they can forward booking emails into the trip. Do not mention a share link, shareUrl, or linkRole unless the user asked for a share link or to change who can view or edit the trip.
record-expense-payment
ChatGPTRecord a payment from one person on the trip to another. This reduces what the payer owes the payee. Both people must already be on the trip budget. Use the names the user said, or "me" for the signed-in member. After success, reply with the message, including any remaining balance.
remove-cities
ChatGPTRemove cities from the draft trip route by name. The trip must keep at least one city.
remove-days
ChatGPTRemove consecutive days from the trip timeline and shift later items earlier.
replace-cities
ChatGPTSet the draft trip route to this ordered list of cities. Each name is resolved with city search.
search-accommodations
ChatGPTSearch the Holicay hotel pool by name. Does not add a stay. Pass search plus a city, or lat and lng. The search is located at that city pin and calls the accommodation autocomplete. Results list each hotel id, name, address, and star rating. Several hotels are returned as a list and none is chosen. Pass a result hotel_id to lookup-hotel-rooms for a room quote, or to add-accommodations to save that hotel. Do not invent a hotel id.
search-activities
ChatGPTSearch Holicay activity/places near a location or by text.
search-cities
ChatGPTSearch Holicay cities/destinations to resolve labels and coordinates for trip routes.
search-food-places
ChatGPTLook up a restaurant by name. Pass the name in search, and label as the city when you know it. The server finds the Google Maps place id for that name and loads the Holicay place details. Do not search the web for a ChIJ place id and do not invent one. A different restaurant is not substituted. A nearby list is returned only when no place name is passed.
set-trip-dates
ChatGPTSet exact trip start/end dates; shifts items by the start delta and drops out-of-range items.
update-accommodation-rooms
ChatGPTSet the total number of rooms on a hotel stay already on the draft trip. Pass the hotel name and a room count from 1 to 9. Each room is one guests entry. Added rooms copy the first room’s adults and children. Does not look up a new rate or change the stored price. Use this when the user asks to change how many rooms a hotel has.
update-day-titles
ChatGPTSet custom titles for trip days by 1-based day index.
update-expense
ChatGPTUpdate a budget expense: who paid, the amount, or how it is split. Pass expenseUid, or the expense name, or its current amount. If several match, ask which one. Before splitting an existing expense, ask whether to split equally, by exact amounts, or by percentage, and wait. Before changing the amount of an expense that is already split, ask whether the same split ratio applies, and wait. Pass keepSplitRatio only after they answer. "Assign this to Ashwin" or "change the owner to Jon" sets owner. "me" is the signed-in member. When needsClarification is true, ask that question and wait. After success, reply with the message.
update-share-link-permission
ChatGPTChange the public share link between view and edit. When the user asks to change view access to edit, pass EDITOR. When they ask to change edit access to view, pass VIEWER. viewer or editor in any casing already counts. Never OWNER. Existing members stay on the trip. Only treat it as successful when success is true and the saved link role matches. After success, reply with shareUrl and the new access.
update-trip-currency
ChatGPTSet the trip currency and convert stored prices for activities, food places, accommodations, experiences, and transportations by the exchange rate. Use this when the user asks to change, set, or switch the trip currency.
update-trip-item-attachments
ChatGPTSave uploaded files onto one planner item as ticket links. Pass the files returned by upload-attachments, plus the trip uid and item name. Appends by default. Does not upload the file itself.
update-trip-items
ChatGPTUpdate timing or cost of existing trip items by fuzzy name match. A cost update is also written to the price the planner shows: the booking total for experiences and transport, and the stay total for hotels. Prefer passing cost on the add call when the itinerary already states the price.
update-trip-title
ChatGPTSet the title for the entire draft trip. This renames the trip, not an individual day.
upload-attachments
ChatGPTUpload files to Holicay ticket storage (POST /ticket-uploads/multiple, form field files). Each file needs a local path, an http(s) URL, or base64 contents. Returns file ids and URLs. Then call update-trip-item-attachments to save them on a planner item.