Dreamfare MCP server

Attach one search result to a trip as a stop: kind 'stay' / 'flight' / 'activity' takes the option/offer object from the matching search tool; kind 'place' takes a search_places result's itemDraft. Echo objects exactly as returned. Stays need 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.

Paste a booking confirmation (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.

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.

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.

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.

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), so re-read with get_trip if the traveler asks to book. Returns the trip and its URL — always give the traveler that URL.

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.

Edit anything on a trip in one batched call: trip details and notes (update_trip), stops (update_stop / remove_stop / move_stop, by stopId from get_trip), days (add_day / update_day / remove_day, by 0-based dayIndex), and the planning stage (finalize locks the trip for sharing and booking; reopen unlocks it). Omitted fields keep their value; null clears. finalize/reopen run AFTER the other actions — a finalized trip rejects edits, so reopen it in its own call first.

Trips other travelers published on Dreamfare, by destination and/or free text — real itineraries with stops, photos and creator credit. Copy one into the traveler's account with copy_trip (publicationId). Sort 'popular' or 'newest'.

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.

The traveler's Dreamfare account snapshot: profile, membership tier, AI credits, and wallet balance (commission earned through tracked bookings).

Read one Dreamfare trip: 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.

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.

Extract the real places from a TikTok, Instagram, YouTube, Facebook, or Reddit travel link — watched, transcribed, and geocoded. When the traveler shares such a link, call this tool with the URL directly: the DREAMFARE SERVER fetches and watches the video, so never claim you cannot open links or ask for an upload. Runs asynchronously (~30–90s): poll get_import for the results. Found places (with their tips) land in the traveler's saved-places library; once done, drop them into a trip with add_saved_places_to_trip (importId — keeps pins, photos and tips) or plan around them with plan_trip. Costs Stardust credits, exactly like importing in the app (failed imports refund).

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.

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.

Every receipt filed on a trip with its parsed facts and the stop it's linked to.

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.

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.

List the traveler's Dreamfare trips (own and shared), newest first — a lookup for trip ids. To show a trip, follow with get_trip, which renders the trip card.

Owner-only crew housekeeping in one call: change a member's role, remove a member, or revoke an open invite. A member may remove themselves (leave) without being the owner. Ids come from list_crew (collaboratorId, invite id).

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.

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.

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.

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.

Build a complete day-by-day trip in one call using Dreamfare's own planner: real venues (with opening hours), a stay, activities and flights from partner inventory, the traveler's saved places woven in, pins, photos and booking links — all server-side, in about 10 seconds. Costs Stardust credits like planning in the app (get_profile shows the balance). Prefer this for 'plan me N days in X' requests; use create_trip when the traveler has dictated the exact stops themselves. Give the traveler the trip URL.

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.

The latest messages in a trip's crew chat (newest last), including polls. Pass `before` (an ISO timestamp) to page further back.

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.

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.

Bookable activities, tours and experiences for a destination. Attach one with add_option_to_trip (kind 'activity'). Plain activity stops added via add_stops also get matched to partners automatically, so search here only when the traveler wants options.

Flight offers between two airports (IATA codes). Attach a chosen offer to a trip with add_option_to_trip (kind 'flight', echoing the offer unchanged) to make it a bookable stop. Fares are exact-date cached airline data, so some routes (especially long-haul) return no offers — report that honestly and keep planning; flight stops added by name via add_stops still get partner booking links automatically.

Real venues for a destination — restaurants, activities, hotels, landmarks, shopping — with ratings, pins, and photos (partner inventory + cached Google Places, the app's own Explore surface). Use it to ground a plan in real places. Each result carries an itemDraft: attach one to a trip with add_option_to_trip (kind 'place', echoing the itemDraft unchanged) to keep its pin, photo, and any partner bookability.

Live hotel/stay inventory with real prices for a destination and date window. To make an option bookable, attach it to a trip with add_option_to_trip (kind 'stay', echoing the option object unchanged) — the stop then carries the tracked booking link.

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.

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.

Update profile fields: display name, bio, home currency, nationality, and the visited-countries list (a FULL replacement — read get_profile first when adding to it). Omitted fields keep their value.

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}.