Gullivr

Delete an expense from a trip. This action is permanent. Use get_expenses to find expense IDs.

Delete a flight from a trip.

Delete a hotel break from a day.

Delete a packing category and all its items. This is destructive — all items in the category are permanently removed.

Delete an item from a packing category.

Delete a trip and all its days and places.

Get all accommodations for a trip, sorted by check-in date. Lighter than get_trip when you only need accommodation info. To search for new accommodations with real-time pricing, use search_accommodations instead.

Get the daily itinerary overview. Returns days with their places, accommodations active on each day (based on check-in/check-out overlap), and flights. If dayId is provided, returns only that day's details including its places, accommodations, and flights. To also get travel distances between places, call get_route_distances for the day.

List all expenses for a trip with a budget summary. Returns the raw expense list (each with tag_id if set), available tags for reference, and an aggregated summary with total, currency, breakdown by category/tag, breakdown by day, and expense count. Use add_expense to add new expenses.

Get all flights for a trip, sorted by departure time. Lighter than get_trip when you only need flight info.

Get the packing list for a trip. Returns categories with nested items, ordered by position. Each category has a name, color, and position. Each item has a name, quantity, packed status, and position.

Get full details of a place including description, opening_hours, photo, Wikipedia/TripAdvisor links, official website, and categories. Use this when you need enrichment data not returned by get_trip.

List all expense category tags for a trip. Default tags (e.g. Must See, Food & Drink, Culture) are auto-created per trip. Use tagId with add_expense or update_expense to categorize expenses.

Get route distances and travel times between consecutive stops in a day's itinerary. Returns segments for each pair of consecutive places, plus accommodation-to-first-place and last-place-to-accommodation if bookend accommodations exist (checkout or mid-day hotel at top, check-in or mid-day hotel at bottom).

Get trip overview: metadata, days with places (id, name, address, category, opening_hours, notes), unassigned places, accommodations, flights. Places are lightweight — use get_place for full details (description, photo, Wikipedia, TripAdvisor, website, categories). Use opening_hours to plan visit order.

Get the URL to view a trip in the browser. Returns the authenticated trip URL and, if sharing is enabled, the public share URL.

List all of the user's trips with place counts. Returns a lightweight list of all trips with place counts. For full trip details (days, places, flights, accommodations), use get_trip instead.

Get places added to a trip but not yet assigned to any day. Use assign_place to assign them to specific days, then reorder_day_items to optimize the visiting order.

Check if the MCP server is running and your access token is valid

Remove a place from a trip entirely.

Reorder all items (places and hotel breaks) within a day. Provide the items in the desired order with their IDs and types. Consider opening_hours when ordering — places with early closing times should be visited first. After reordering, call get_route_distances to verify the new route is efficient. Tip: use get_route_distances first to analyze current distances before deciding on a new order.

Search for available accommodations with real-time pricing. Returns hotels, apartments, or hostels with prices, ratings, photos, and booking links. Use the results with add_accommodation to add a selected option to a trip.

Search places by text query. Returns results with placeId, name, address, coordinates, rating, photoUrl, and primaryType. Uses Geoapify autocomplete. Use this before add_place to get accurate placeId and coordinates. After add_place, the place is automatically enriched with opening_hours, description, Wikipedia link, and official website from Geoapify + Wikidata.

Seed the packing list with default categories and common items (Clothing, Toiletries, Electronics, Documents, Health, Accessories). Only works if no categories exist yet for this trip.

Set or clear the description for a day. Pass null to remove the description.

Set or clear the notes for a day. Pass null to remove the notes.

Set or clear the notes for a place. Pass null to remove the notes.

Set the photo for a place by searching for it. Searches by query and updates the photo_url. Use this to fix or update the photo on an existing place. For new places, prefer search_places + add_place which includes the photo automatically.

Set or clear the description for a trip. Pass null to remove the description.

Set or clear the notes for a trip. Pass null to remove the notes.

Mark a packing item as packed or unpacked.

Update an accommodation's details. Accommodations are separate entities with check-in/check-out dates — they cannot be assigned to days as activities. Note: checkInDate and checkOutDate must always be provided together when updating dates — you cannot update only one. Use this to update pricing after calling search_accommodations.

Update an existing expense. Only the fields you provide will be changed. Use get_expenses to find expense IDs. Prefer tagId (from get_place_tags) over category.

Update a flight's details. Flights have a departure/return structure — update dates via this tool, do not move flights between days. Note: departureTime and arrivalTime must always be provided together — you cannot update only one.

Update a place's notes or category. To fix wrong place data, remove and re-add using search_places + add_place instead.

Update trip details. If dates change, days are automatically adjusted.