Dreamfare MCP server

Attach one fare from search_flights to a trip as a flight stop. Pass the searchId and the fare's id exactly as returned. The stop lands on the day matching its departure date. It is a plan, not a booking: the traveler books through the stop's Book button, which opens the site that quoted the price. Returns data and a compact summary. Finish the requested planning and edits, then call display_trip once for the latest itinerary. Use display_results with display.resultId only when the traveler needs this exact saved result. Choose one display call for the final result, not both, and never display every intermediate edit.

Attach one search result to a trip as a stop: kind 'stay' / 'activity' takes the option/offer object from the matching search tool; kind 'place' takes a search_places result's itemDraft. Prefer resultId (the search's display.resultId) + optionId instead of echoing an object: kind and searched dates/guests are restored server-side. References expire after 30 minutes; changed dates or occupancy require a new search. Legacy object callers need kind and stay checkIn/checkOut. Say which day with dayIndex or date (a stay defaults to its check-in date) and, when the traveler has one in mind, the start time. The stop's bookingUrl (in this result and get_trip) is the link to present for booking. Returns data and a compact summary. Finish the requested planning and edits, then call display_trip once for the latest itinerary. Use display_results with display.resultId only when the traveler needs this exact saved result. Choose one display call for the final result, not both, and never display every intermediate edit. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.

Supply a booking confirmation as text or base64 image/PDF bytes (hotel, flight, tour, train — the email text or its key lines) and Dreamfare files it on the trip: provider, confirmation code, dates and amount are parsed, and when it clearly matches a stop that stop is marked booked. Pass stopId to link it to a specific stop instead of matching by name. This working tool returns data and a compact summary, without opening detailed visuals. When the requested work is complete or the traveler needs to choose, call display_results with this result's display.resultId to present the details. Do not display every intermediate result. Never repeat a write or paid operation to display its details. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.

Turn the traveler's library into itinerary stops WITH their pins, photos, tips and partner links intact (re-adding by name via add_stops would lose those). Pick places by id (list_saved_places), a whole folder, or everything a video import found (importId from import_video — the video's own day hints place each stop). Whole-city entries are skipped. Places land on dayIndex unless spreadAcrossDays is set. Returns data and a compact summary. Finish the requested planning and edits, then call display_trip once for the latest itinerary. Use display_results with display.resultId only when the traveler needs this exact saved result. Choose one display call for the final result, not both, and never display every intermediate edit. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.

Add stops (places, activities, meals, stays, transport) to an existing Dreamfare trip. dayIndex is 0-based; read the trip first with get_trip if unsure of its days. Returns data and a compact summary. Finish the requested planning and edits, then call display_trip once for the latest itinerary. Use display_results with display.resultId only when the traveler needs this exact saved result. Choose one display call for the final result, not both, and never display every intermediate edit. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.

Put something on a trip as stops. source says what: stops (plain stops you describe in stops), saved_places (library places with their pins, photos and links; by savedPlaceIds, folderName, or importId for everything an import found), search_result (one option from search_stays, search_activities or search_places by resultId + optionId), flight (a fare from search_flights by searchId + offerId), train (a fare from search_trains by searchId + journeyId), receipt (a booking confirmation as text or base64 image/PDF; parsed, filed on the trip, and the matching stop marked booked). Say which day with dayIndex or date; a stay defaults to its check-in date, a flight or train to its departure day. These are plans, not bookings: the traveler books through each stop's bookingUrl. Returns data plus display.resultId; call display_card to show it. presentation (optional) shapes what is shown without changing the action: compact or full layout, and only the limit, ids or sections this tool advertises.

Save an unchanged quoted train fare by searchId and journeyId to its departure day on a trip. This saves a plan, not a reservation. Requires tripId outside a trip chat. Never reconstruct price, dates or booking URLs from prose. This working tool returns data and a compact summary, without opening detailed visuals. When the requested work is complete or the traveler needs to choose, call display_results with this result's display.resultId to present the details. Do not display every intermediate result. Never repeat a write or paid operation to display its details. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.

Two to five options of one kind (stays, activities or places) in one table: price (per night / per person / total), rating and reviews, distance, duration, stops, cancellation, features — the best cell in each row is marked and `verdict` names the winners (cheapest, best rated, closest, fastest). Each is researched like get_details, so the table is exact, not a summary of the search screen. Use it whenever the traveler is weighing a few ('which of these', 'A or B', 'the cheapest that's still well rated'). Prefer resultId (the search reply’s display.resultId) + optionIds, ordered as requested. Legacy callers can echo objects unchanged in options; every column’s itemDraft/option goes to add_option_to_trip. Use criteria to focus and order the rows: stays support nightly, total, stars, rating, reviews, distance, sleeps, cancellation, features; activities support perPerson, rating, reviews, duration, category, languages, cancellation, distance, features; places support rating, reviews, priceLevel, openNow, hoursToday, distance, features. Unavailable facts are reported explicitly. This working tool returns data and a compact summary, without opening detailed visuals. When the requested work is complete or the traveler needs to choose, call display_results with this result's display.resultId to present the details. Do not display every intermediate result. Never repeat a write or paid operation to display its details. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.

Make the traveler their own editable copy of a trip: a published one (publicationId from explore_trips — keeps the creator's attribution and re-bases flights on the traveler's home airport) or one of their own trips (tripId — dates, stops and the shared packing list come along). Returns the new trip. Returns data and a compact summary. Finish the requested planning and edits, then call display_trip once for the latest itinerary. Use display_results with display.resultId only when the traveler needs this exact saved result. Choose one display call for the final result, not both, and never display every intermediate edit. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.

Save a travel plan as a Dreamfare trip the traveler can open, edit with their crew, and book. Pass the full day-by-day plan in one call via days; stops are enriched shortly after creation (photos, map pins, booking links). Use plan_trip instead when the traveler wants Dreamfare's planner to build the days. To copy a trip, pass copyFromPublicationId (a trip from explore_trips; keeps the creator's credit) or copyFromTripId (one of the traveler's own) and no days. Before planning a destination, check list_library for the traveler's saves there and ask whether to include them (add_to_trip source=saved_places keeps their pins and links). Returns the trip and its URL; always give the traveler that URL. Returns data plus display.resultId; call display_card to show it. presentation (optional) shapes what is shown without changing the action: compact or full layout, and only the limit, ids or sections this tool advertises.

Delete a trip the traveler owns (also unpublishes it from Explore). Requires echoing the exact trip title as confirmTitle; only call this after the traveler explicitly asks to delete the trip. Returns data plus display.resultId; call display_card to show it.

Show a Dreamfare card to the traveler: a trip's itinerary (tripId) or the details of an earlier result (resultId, from that tool's display.resultId). Call it once, after the requested work is done or when the traveler asks to see something; never after every intermediate call. It reads a saved snapshot retained for 30 minutes and never repeats a search, edit, import, message or charge. If a snapshot has expired, use a non-charging lookup to retain a new result; never repeat a trip/account edit, import or charge merely to display it. This is the only tool that opens a visual; every other tool returns data. presentation (optional) shapes what is shown without changing the action: compact or full layout, and only the limit, ids or sections this tool advertises.

Show the detailed visual for one previous tool result using its display.resultId. Call after completing the requested work, when the traveler needs to compare or choose, or when they ask to see details. Do not call after every intermediate lookup or mutation. This reads an account-bound snapshot retained for 30 minutes: it never repeats a search, mutation, import, message, or credit charge. Use display_trip with tripId for the latest itinerary. If a snapshot is unavailable, use a read-only lookup to refresh it; never repeat a mutation just to get a display ID. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.

Show the visual itinerary to the traveler. Call once after completing all requested planning or edits, or when they explicitly ask to see the trip. Do not call between intermediate edits. This is read-only and does not finalize or lock the trip. Returns days, stops (with stopIds for edit_trip), the packing list, and per-stop booking links. When the traveler wants to book a stop, give them its bookingUrl — bookings through it earn them commission back. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.

Change what the traveler has saved, in one call: save a place, delete places, move places into a folder or out to unsorted, rename a place, create, rename or delete folders, and add or remove travel tips. Save a place when the traveler wants it remembered without putting it on a trip yet; put library places on a trip with add_to_trip source=saved_places. Ids and folder names come from list_library. Deleting a folder keeps its places as unsorted. Returns the places shelf, plus savedPlace and tips for the parts that ran. Returns data plus display.resultId; call display_card to show it. presentation (optional) shapes what is shown without changing the action: compact or full layout, and only the limit, ids or sections this tool advertises.

Every change to an existing trip in one batched call. Structural actions: update_trip (details and notes), update_stop / remove_stop / move_stop (by stopId from get_trip), add_day / update_day / remove_day (by 0-based dayIndex). Side actions: packing (the packing list), mark_booked (record a booking the traveler made), vote_stop (crew votes), refresh_stay_prices (re-quote partner-priced stays). Stage actions, at most one per call and run last: finalize locks the trip for sharing and booking, reopen unlocks it, publish puts a finalized trip on a public link and Explore, unpublish takes it off. Omitted fields keep their value; null clears. A finalized trip rejects structural edits, so reopen it in its own call first. remove_stop and remove_day delete data. Returns data plus display.resultId; call display_card to show it. presentation (optional) shapes what is shown without changing the action: compact or full layout, and only the limit, ids or sections this tool advertises.

Trips other travelers published on Dreamfare, by destination and free text: real itineraries with stops, photos and creator credit. Give the traveler their own editable copy with create_trip copyFromPublicationId. Use it for inspiration and for how locals actually route a city, not for live prices. Continue the same search with nextOffset. Retains an account-bound result for 30 minutes for later display; does not copy, publish or change a trip. Returns data plus display.resultId; call display_card to show it. presentation (optional) shapes what is shown without changing the action: compact or full layout, and only the limit, ids or sections this tool advertises.

Everything known about ONE hotel, tour or place, researched: a photo gallery, what's good about it (editorial summary, what reviewers say), key facts (stars, guest score, capacity, cancellation and instant-book policies; duration, languages, meeting point, inclusions and exclusions, itinerary; opening hours, price level, phone, website), features/amenities, the exact location, and prices — per booking site for hotels, tours & tickets with prices at landmarks. Use it when the traveler asks about a specific option ('tell me more about…', 'is it near…', 'what's included', 'can I cancel', 'is it open Sunday') or before recommending one. Prefer resultId (the search reply’s display.resultId) + optionId to restore the exact option and search window. Legacy callers can pass the search result object as `option` (or a search_places result's placeId as `id`, or a name + destination when there is no object). Stays: pass checkIn/checkOut/guests so prices are for the traveler's dates. The reply's itemDraft/option go to add_option_to_trip unchanged. This working tool returns data and a compact summary, without opening detailed visuals. When the requested work is complete or the traveler needs to choose, call display_results with this result's display.resultId to present the details. Do not display every intermediate result. Never repeat a write or paid operation to display its details. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.

Read an existing search_flights board without another scrape. Use presentation.limit:1 or 3 for one or three fares; presentation.ids selects and orders exact offerId values before comparison. Keep the original searchId. Price, airline, stops, bags, local-time and duration filters narrow the retained candidates; sort changes their order. The original route, dates, party, cabin, currency and source constraints remain fixed. Start search_flights again to broaden the original search or change those fields. A partial board may gain fares when read again. Missing IDs and expired searches return explicit errors; never substitute another flight. bookingUrl opens the exact itinerary, itineraryUrl is its provider page, and sourceUrl is only research/search evidence. This working tool returns data and a compact summary, without opening detailed visuals. When the requested work is complete or the traveler needs to choose, call display_results with this result's display.resultId to present the details. Do not display every intermediate result. Never repeat a write or paid operation to display its details.

Status and results of a video/post import: the extracted places with their areas, notes, per-place tips, and day assignments. While status isn't 'done' (or 'failed'), poll again after ~15s. When done, add_saved_places_to_trip (importId) puts every place into a trip with its pin, photo and tips; plan_trip (savedPlaceIds) plans days around them. This working tool returns data and a compact summary, without opening detailed visuals. When the requested work is complete or the traveler needs to choose, call display_results with this result's display.resultId to present the details. Do not display every intermediate result. Never repeat a write or paid operation to display its details. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.

The traveler's Dreamfare account snapshot: profile, membership tier, Stardust credits, and wallet balance (commission earned through tracked bookings). Reading also initializes or reconciles membership and credit allowance records: expired membership can end, the monthly credit period can roll, and the grant can change with the tier. This does not spend credits, purchase travel, or change the wallet balance. Returns data plus display.resultId; call display_card to show it. presentation (optional) shapes what is shown without changing the action: compact or full layout, and only the limit, ids or sections this tool advertises.

Show the stored details of one real train fare. Pass searchId and journeyId from search_trains. Never reconstruct a fare from prose. This working tool returns data and a compact summary, without opening detailed visuals. When the requested work is complete or the traveler needs to choose, call display_results with this result's display.resultId to present the details. Do not display every intermediate result. Never repeat a write or paid operation to display its details. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.

Read a trip, or list the traveler's trips (own and shared, newest first) when tripId is omitted. A trip comes back with its days and stops (stopIds for edit_trip), the packing list, tips for the destination, the sharing state, and per-stop booking links; bookings made through a stop's bookingUrl earn the traveler commission back. include adds essentials (tracked partner links for an eSIM, rental cars and transfers), crew (members, roles, open invites), receipts (filed booking confirmations) and chat (the crew chat, newest last; chatBefore pages back). Read silently while planning; show the plan with display_card. Retains an account-bound result for 30 minutes for later display; does not edit the trip, mark chat read or make a booking. Returns data plus display.resultId; call display_card to show it.

Read a traveler-provided screenshot or travel PDF into saved places and tips. Supply raw base64 bytes (maximum 8,000,000 characters). Uses the same membership and import credits as import_video. Poll get_import using the returned id. This working tool returns data and a compact summary, without opening detailed visuals. When the requested work is complete or the traveler needs to choose, call display_results with this result's display.resultId to present the details. Do not display every intermediate result. Never repeat a write or paid operation to display its details. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.

Pull the real places and travel tips out of something the traveler shares and save them to their library. source url reads a TikTok, Instagram, YouTube, Facebook, Reddit, blog or other travel page on the Dreamfare server, subject to the source being reachable. source text reads words they pasted. source file reads a screenshot or travel PDF. Runs in the background: poll list_library with the returned importId until status is done or failed, about 20 to 90 seconds. Every place and tip is saved with its source, so list_library finds them later. Once done, add them to a trip with add_to_trip source=saved_places (importId keeps the pins, photos and tips) or plan days around them with plan_trip. General travel tips are advice, not stops. Costs Stardust credits exactly like importing in the app, and a failed import refunds them. Identical input within 10 minutes returns the same importId without another charge, including a failed job. Poll that job instead of starting it again. Use a new operationId only when the traveler explicitly asks for a fresh extraction; keep it unchanged when retrying. Returns data plus display.resultId; call display_card to show it. presentation (optional) shapes what is shown without changing the action: compact or full layout, and only the limit, ids or sections this tool advertises.

Extract the real places from text the traveler pastes — notes, a friend's list, a blog post, an itinerary email — and save them (with any tips) to their library, exactly like a video import. Runs asynchronously: poll get_import. Costs Stardust credits like importing in the app (failed imports refund). Needs at least 40 characters. This working tool returns data and a compact summary, without opening detailed visuals. When the requested work is complete or the traveler needs to choose, call display_results with this result's display.resultId to present the details. Do not display every intermediate result. Never repeat a write or paid operation to display its details. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.

Extract real places and travel tips from a TikTok, Instagram, YouTube, Facebook, Reddit, blog or other travel web page. Send the shared URL directly. The Dreamfare server reads the page or processes its video, subject to source availability. Use import_text for pasted text. Runs asynchronously: poll get_import for results. Found places and general tips are saved with recorded sources and can be found with list_saved_finds. Once done, add places to a trip with add_saved_places_to_trip (importId keeps pins, photos and tips) or plan around them with plan_trip. General travel tips are advice, not stops. Costs Stardust credits, exactly like importing in the app (failed imports refund). This working tool returns data and a compact summary, without opening detailed visuals. When the requested work is complete or the traveler needs to choose, call display_results with this result's display.resultId to present the details. Do not display every intermediate result. Never repeat a write or paid operation to display its details. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.

Create an invite link for a trip, optionally emailed to one person (they must sign in with that email to accept). Roles: editor plans with you, viewer only looks. Anyone who can edit the trip can invite; the link is what to share when no email is given. This working tool returns data and a compact summary, without opening detailed visuals. When the requested work is complete or the traveler needs to choose, call display_results with this result's display.resultId to present the details. Do not display every intermediate result. Never repeat a write or paid operation to display its details. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.

The trip's crew: owner, collaborators with their roles, and (for the owner) the open invite links. Use it before inviting, removing, or @-mentioning someone in the chat. This working tool returns data and a compact summary, without opening detailed visuals. When the requested work is complete or the traveler needs to choose, call display_results with this result's display.resultId to present the details. Do not display every intermediate result. Never repeat a write or paid operation to display its details. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.

Read what the traveler has saved: their places with folders, their travel-tips notebook, and the results of an import. Topic/area search can refresh missing or expired venue photos from public place providers without changing the saved entries. Pass importId to follow an import started by import_places: while status is neither done nor failed, call again after about 15 seconds. Pass query or area to search places and tips together, with the source each one came from. Pass folderName, type or sort to browse the places shelf itself, and offset with the returned nextOffset to continue. Tips are advice, never itinerary stops. Put library places on a trip with add_to_trip source=saved_places (by savedPlaceIds, folderName or importId), or plan days around them with plan_trip. Retains an account-bound result for 30 minutes for later display; does not start an import, spend credits or change library entries. Returns data plus display.resultId; call display_card to show it. presentation (optional) shapes what is shown without changing the action: compact or full layout, and only the limit, ids or sections this tool advertises.

Every receipt filed on a trip with its parsed facts and the stop it's linked to. This working tool returns data and a compact summary, without opening detailed visuals. When the requested work is complete or the traveler needs to choose, call display_results with this result's display.resultId to present the details. Do not display every intermediate result. Never repeat a write or paid operation to display its details. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.

Search the traveler's saved places AND travel tips together, including text, Reddit and blogs, with recorded original sources. Use area for the destination and query for a short topic such as airport train. General tips accompany area searches. Use kind only to request places or tips alone, and nextOffset to continue. This already includes both kinds; do not repeat list_travel_tips for the same request. Tips are advice, never itinerary stops. Add a place only on request using add_saved_places_to_trip with its id. This working tool returns data and a compact summary, without opening detailed visuals. When the requested work is complete or the traveler needs to choose, call display_results with this result's display.resultId to present the details. Do not display every intermediate result. Never repeat a write or paid operation to display its details. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.

For mixed saved places and tips, use list_saved_finds. The traveler's saved-places library: folders and the places in them (optionally one folder, or 'unsorted'). Put them on a trip with add_saved_places_to_trip (ids or a folder) or plan a trip around them with plan_trip. Search titles and subtitles with q, separate saved areas from individual places, sort, and continue with nextOffset. This working tool returns data and a compact summary, without opening detailed visuals. When the requested work is complete or the traveler needs to choose, call display_results with this result's display.resultId to present the details. Do not display every intermediate result. Never repeat a write or paid operation to display its details. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.

The traveler's travel-tips notebook: their own notes plus per-place advice mined by video imports ('go before 8am', 'cash only'). Optionally filter by area name. Surface relevant tips when planning a destination they cover. For mixed saved places and tips or topic search, use list_saved_finds. This working tool returns data and a compact summary, without opening detailed visuals. When the requested work is complete or the traveler needs to choose, call display_results with this result's display.resultId to present the details. Do not display every intermediate result. Never repeat a write or paid operation to display its details. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.

List the traveler's Dreamfare trips (own and shared), newest first — a lookup for trip ids. Use get_trip to read silently, or display_trip to show the itinerary after planning. This working tool returns data and a compact summary, without opening detailed visuals. When the requested work is complete or the traveler needs to choose, call display_results with this result's display.resultId to present the details. Do not display every intermediate result. Never repeat a write or paid operation to display its details.

Everything that changes who is on a trip, plus the crew chat, in one call: invite someone, change a member's role, remove a member, leave the trip, revoke an open invite, and post a message. Read the crew and the chat first with get_trip include crew and include chat: collaboratorId, invite ids and member userIds all come from there. Anyone who can edit the trip may invite and post, only the owner may set roles, remove members or revoke invites, and any member other than the owner may leave. An emailed invite leaves Dreamfare. Returns the crew, plus invite and posted for the parts that ran. Returns data plus display.resultId; call display_card to show it. presentation (optional) shapes what is shown without changing the action: compact or full layout, and only the limit, ids or sections this tool advertises.

Add, check off, uncheck, or remove packing-list items on a trip. Item ids come from get_trip's packing array (or this tool's response). Personal items are visible only to this traveler; shared items belong to the whole crew. This working tool returns data and a compact summary, without opening detailed visuals. When the requested work is complete or the traveler needs to choose, call display_results with this result's display.resultId to present the details. Do not display every intermediate result. Never repeat a write or paid operation to display its details. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.

Housekeeping for the traveler's library in one call: delete places, move places into a folder (or out to unsorted), rename a place, create/rename/delete folders (deleting a folder keeps its places as unsorted). Ids and folder names come from list_saved_places. This working tool returns data and a compact summary, without opening detailed visuals. When the requested work is complete or the traveler needs to choose, call display_results with this result's display.resultId to present the details. Do not display every intermediate result. Never repeat a write or paid operation to display its details. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.

Add or remove entries in the traveler's travel-tips notebook. Tips can be general or scoped to an area so they resurface when a trip goes there. This working tool returns data and a compact summary, without opening detailed visuals. When the requested work is complete or the traveler needs to choose, call display_results with this result's display.resultId to present the details. Do not display every intermediate result. Never repeat a write or paid operation to display its details. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.

Record that the traveler completed a booking for a stop (on the partner site or elsewhere). When they booked through the stop's tracked bookingUrl this also opens the commission credit that pays their share back once the partner reports it. This working tool returns data and a compact summary, without opening detailed visuals. When the requested work is complete or the traveler needs to choose, call display_results with this result's display.resultId to present the details. Do not display every intermediate result. Never repeat a write or paid operation to display its details. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.

Build a complete day-by-day trip in one call with Dreamfare's own planner: real venues with their opening hours, a stay, activities from partner inventory, the traveler's saved places woven in, pins, photos and booking links, all stitched server-side in about 10 seconds. Prefer it for 'plan me N days in X'. Use create_trip when the traveler dictated the stops themselves. The traveler's saved places at the destination count even when they do not mention them: pass savedPlaceIds or folderName for the ones they want in, or includeSavedPlaces (true = all of them, false = none). Leave all three out and, when they have saves there, the call returns them unbuilt and uncharged so you can ask first. Costs Stardust credits like planning in the app, and get_profile shows the balance. Give the traveler the trip URL. Returns data plus display.resultId; call display_card to show it. presentation (optional) shapes what is shown without changing the action: compact or full layout, and only the limit, ids or sections this tool advertises.

Say something to the crew in the trip's chat. Mention members by userId (list_crew). Starting the text with @dreamfare summons the in-app planner into the thread. This working tool returns data and a compact summary, without opening detailed visuals. When the requested work is complete or the traveler needs to choose, call display_results with this result's display.resultId to present the details. Do not display every intermediate result. Never repeat a write or paid operation to display its details. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.

The latest messages in a trip's crew chat (newest last), including polls. Pass `before` (an ISO timestamp) to page further back. This working tool returns data and a compact summary, without opening detailed visuals. When the requested work is complete or the traveler needs to choose, call display_results with this result's display.resultId to present the details. Do not display every intermediate result. Never repeat a write or paid operation to display its details. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.

Filter or sort an existing train search without querying sellers again. Prices and budgets are whole-party one-way integer minor units. Outbound clock filters do not apply to the return. Use a new search when route, date, currency or passengers change. This working tool returns data and a compact summary, without opening detailed visuals. When the requested work is complete or the traveler needs to choose, call display_results with this result's display.resultId to present the details. Do not display every intermediate result. Never repeat a write or paid operation to display its details. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.

Re-quote every upcoming partner-priced stay on the trip against live rates and report what moved (previous → current). At most once per stay per day. Returns the refreshed trip. Returns data and a compact summary. Finish the requested planning and edits, then call display_trip once for the latest itinerary. Use display_results with display.resultId only when the traveler needs this exact saved result. Choose one display call for the final result, not both, and never display every intermediate edit. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.

Research options from an earlier search: one in depth, or two to five side by side. Pass resultId (that search reply's display.resultId) with optionIds. One id returns everything known about that option: photos, an editorial summary and what reviewers say, key facts (stars, guest score, capacity, cancellation and instant-book policies, duration, languages, meeting point, inclusions, itinerary, opening hours, price level, phone, website), features, the exact location, and prices per booking site for stays plus tours and tickets at landmarks. Two to five ids return one table: price, rating and reviews, distance, duration, cancellation and features, with the best cell in each row marked and verdict naming the winners. Use it when the traveler asks about one option ('tell me more', 'is it near', 'what's included', 'can I cancel', 'is it open Sunday'), when they are weighing a few ('which of these', 'A or B', 'the cheapest that is still well rated'), and before recommending one. Every option is researched fresh, so the answer is exact rather than a summary of the search screen. Stays: pass checkIn, checkOut and guests so prices cover the traveler's dates. Legacy callers without a resultId can echo search objects in option or options, pass a search_places placeId as id, or a name with destination. Attach what the traveler picks with add_to_trip source 'search_result', reusing the same resultId and optionId. Retains an account-bound research result for 30 minutes for later display. Does not reserve, purchase or spend credits. Returns data plus display.resultId; call display_card to show it. presentation (optional) shapes what is shown without changing the action: compact or full layout, and only the limit, ids or sections this tool advertises.

Save a place to the traveler's library without putting it on a trip yet — 'remember this for my next Lisbon trip'. Optionally file it into a named folder (created if new). Saved places go onto any trip later via add_saved_places_to_trip. This working tool returns data and a compact summary, without opening detailed visuals. When the requested work is complete or the traveler needs to choose, call display_results with this result's display.resultId to present the details. Do not display every intermediate result. Never repeat a write or paid operation to display its details. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.

Search bookable activities, tours and experiences for a destination. Say what kind with q ('food tour', 'sunset cruise', 'day trip to Sintra') and narrow with category, flags, tags, duration or minRating. Default order is partner relevance: for a budget or a 'cheaper' ask set maxPrice or minPrice and sort cheapest instead of repeating the search, and read priceRange for what was found. Each result carries tags, flags and a short description. Plain activity stops added with add_to_trip source 'stops' are matched to partners automatically, so search here only when the traveler wants options. Research one, or weigh two to five, with research_options using this reply's display.resultId and each productId; attach the pick with add_to_trip source 'search_result'. Retains an account-bound result for 30 minutes for later display, research or attachment. Does not purchase or spend credits. Returns data plus display.resultId; call display_card to show it. presentation (optional) shapes what is shown without changing the action: compact or full layout, and only the limit, ids or sections this tool advertises.

Resolve a city or airport name to IATA codes for search_flights ('Lisbon' → LIS; 'London' → LON, the metro code covering LHR/LGW/STN/LTN, plus each airport). Call it whenever the traveler names a place rather than a code — never guess a code. A city (kind 'city') code searches every airport in that city and is the right pick unless a specific airport was named. This working tool returns data and a compact summary, without opening detailed visuals. When the requested work is complete or the traveler needs to choose, call display_results with this result's display.resultId to present the details. Do not display every intermediate result. Never repeat a write or paid operation to display its details.

Search Trip.com rental cars for an airport pickup and drop-off, with exact local dates and times, the driver's age and the licence's issuing country. Ask for a missing age or licence country; never guess either. Trip.com quotes a 30 to 60 driver-age band for that range, while supplier eligibility uses the real age. Returned prices are rental totals, not daily rates, and deposits sit outside them. Links open a search the traveler completes: they confirm the vehicle, the policies and the final price there. There is no in-app booking, and a failed source never means no cars exist. Retains an account-bound result for 30 minutes for later display. Does not reserve a car or spend credits. Returns data plus display.resultId; call display_card to show it. presentation (optional) shapes what is shown without changing the action: compact or full layout, and only the limit, ids or sections this tool advertises.

Search and compare real flights for a route and dates, or re-read an earlier board. A fresh search starts a server-side provider search job and retains its board; it does not book or purchase a flight. origin and destination take an IATA airport or metro code, or a plain city or airport name that is resolved here; when several cities match or none does, the reply is an error carrying candidates, so ask the traveler and search again with a code. Pass searchId to filter, sort or re-read a board without another scrape; a partial board can gain fares when read again. Every fare carries the quote of each site that answered. Never imply a site that did not answer was searched. Returned amounts, minTotalAmount and maxTotalAmount are whole-party integer minor units; maxTotal and minTotal take normal currency units and priceBasis says whether they mean the party or a seat. Lead with the per-seat price and its seats multiplier when the party buys more than one seat, then name the whole-party total once. Clock filters are local to each departure or arrival airport. For a deadline such as home by Sunday evening resolve the exact date and use returnArriveBy; arriveBy is the outbound equivalent. bookingUrl opens the exact itinerary on bookOn, itineraryUrl is that provider's own page, sourceUrl is research evidence only. Attach a fare with add_to_trip source 'flight', this searchId and the fare's offerId. Prices are indicative until the traveler books. Returns data plus display.resultId; call display_card to show it.

Find real venues for a destination: restaurants, activities, hotels, landmarks and shopping, with ratings, pins and photos, from partner inventory plus cached Google Places. Use it to ground a plan in real places. For hotels pass checkIn and checkOut, or use search_stays: without them prices cover a sample window a month out and the reply says so in pricedWindow, and a hotel added to a day is re-dated and re-quoted. Narrow with openNow or openAt, priceLevels, minRating, and near with radiusKm. minRating reads each source's own scale: hotels run 0 to 10, Google places and tours 0 to 5. Research a result, or weigh two to five, with research_options using this reply's display.resultId and the result's id; attach the pick with add_to_trip source 'search_result', which keeps its pin, photo and any partner bookability. Retains an account-bound result for 30 minutes for later display, research or attachment. Does not save library entries, edit trips or spend credits. Returns data plus display.resultId; call display_card to show it. presentation (optional) shapes what is shown without changing the action: compact or full layout, and only the limit, ids or sections this tool advertises.

Search stays for a city and exact dates. Prices include taxes and fees for the quoted accommodation, and guests is the party sharing it, not a room count. Use budget {amount, currency, basis:'per_night'} or maxNightlyAmount in integer minor units (USD 15000 is $150), and sort cheapest when the traveler wants cheaper. Set constraintMode strict for real requirements; prefer allows labeled alternatives. near searches around a landmark, name finds one named property, and keywords matches style words in listing names. For hotels near food, galleries or other interests pass interests: each one is resolved to real places at the destination and matched by verified straight-line distance. Never call that distance a walking time, and claim no match without verified places. Property type is inferred from listing evidence, not certified by the supplier. No matches and a provider failure are different answers; never invent a matching quote. Research a property with research_options using this reply's display.resultId and the property's propertyId, attach it with add_to_trip source 'search_result', and present the returned bookingUrl for booking. Retains an account-bound result for 30 minutes for later display, research or attachment. Does not reserve, book or spend credits. Returns data plus display.resultId; call display_card to show it. presentation (optional) shapes what is shown without changing the action: compact or full layout, and only the limit, ids or sections this tool advertises.

Search real dated train fares for a route, or re-read an earlier search. Results carry departures, arrivals, operators, durations and changes. Prices cover the requested adults, and returnOptions are separate one-way quotes. Pass searchId alone to filter or sort a search without asking the sellers again; pass searchId with journeyId for one fare's stored details. Start a fresh search when the route, date, currency or passenger count changes. A source failure does not mean no trains run. Never substitute a promotional from-price, a seller search page or a generic listing for an individual fare. Attach a fare with add_to_trip source 'train', this searchId and the unchanged journeyId. Stores fresh quotes under searchId for later refinement or attachment and retains an account-bound display result for 30 minutes. Does not reserve a seat, issue tickets or spend credits. Returns data plus display.resultId; call display_card to show it. presentation (optional) shapes what is shown without changing the action: compact or full layout, and only the limit, ids or sections this tool advertises.

Publish a finalized trip to a public link (dreamfare.app/p/…) and Explore, republish it after edits, or unpublish it. Owner only. With no action it just reports the current share state and link. Bookings made from the public copy earn the author. This working tool returns data and a compact summary, without opening detailed visuals. When the requested work is complete or the traveler needs to choose, call display_results with this result's display.resultId to present the details. Do not display every intermediate result. Never repeat a write or paid operation to display its details. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.

Tracked partner links for the trip's destination country: a travel eSIM (data the moment they land), rental cars, airport pickup and private transfers. Booking through these links earns the traveler's commission share, like stops. This working tool returns data and a compact summary, without opening detailed visuals. When the requested work is complete or the traveler needs to choose, call display_results with this result's display.resultId to present the details. Do not display every intermediate result. Never repeat a write or paid operation to display its details. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.

Update profile fields: display name, bio, home currency, nationality, and the visited-countries list. Omitted fields keep their value. visitedCountries replaces the whole list, so read get_profile first when adding to it. Returns data plus display.resultId; call display_card to show it. presentation (optional) shapes what is shown without changing the action: compact or full layout, and only the limit, ids or sections this tool advertises.

Thumbs up (1) or down (-1) on a stop the crew is deciding about, or 0 to take a vote back. Tallies appear on get_trip stops as votes {up, down, mine}. This working tool returns data and a compact summary, without opening detailed visuals. When the requested work is complete or the traveler needs to choose, call display_results with this result's display.resultId to present the details. Do not display every intermediate result. Never repeat a write or paid operation to display its details. Optional presentation controls customize the visible result without changing the action; use compact/full layout and only the sections or result selection advertised by this tool.