# Chloe tool reference

Every tool the Dyme MCP server (https://mcp.dyme.earth/api/mcp) shows a connected assistant, read from the live server at 2026-11-07T22:19:00.611Z. Machine-readable: https://mcp.dyme.earth/docs/tools.json

## Hotels

### compare_rate_plans

**Rate plans at one hotel.** Reads only. 2 points a call.

Shows what each rate plan at one hotel adds, such as breakfast, free cancellation or a bigger room.

Arguments: `trip_id` (required), `hotel_id` (required).

### find_hotel

**Find a specific hotel by name.** Reads only. 1 point a call.

Finds one hotel by its name.

Arguments: `name` (required), `city`.

### get_hotel_details

**Get hotel details.** Reads only. 2 points a call. Drawn as a card.

Shows one hotel in full: photos, amenities, description, sustainability details and the neighbourhood.

Arguments: `hotel_id` (required), `checkin`, `checkout`, `adults`, `children`, `personal`, `trip_id`.

### get_hotel_rates

**Get room types and rates.** Reads only. 2 points a call. Drawn as a card.

Lists a hotel's rooms and rates for given dates, with a booking link for each.

Arguments: `hotel_id` (required), `hotel_name`, `checkin` (required), `checkout` (required), `adults`, `children`, `currency`, `guest_nationality`, `max_rooms`, `trip_id`, `personal`.

### get_hotel_reviews

**Get guest reviews.** Reads only. 2 points a call.

Returns guest reviews for a hotel.

Arguments: `hotel_id` (required), `hotel_name`.

### hotel_date_options

**Hotels on nearby dates.** Reads only. 20 points a call.

Prices the same hotel stay on nearby start dates.

Arguments: `destination` (required), `near`, `checkin` (required), `checkout` (required), `days_either_side`, `adults`, `children`, `currency`, `min_stars`, `min_rating`, `max_price_per_night`, `meal_plan`, `free_cancellation_only`, `must_haves`, `personal`.

### refine_hotels

**Refine a previous hotel search.** Reads only. 0 points a call. Drawn as a card.

Narrows or re-sorts an earlier hotel search by price, stars, rating, free cancellation or name, without searching again.

Arguments: `trip_id` (required), `min_stars`, `min_rating`, `max_price_per_night`, `free_cancellation`, `hotel_name`, `sort`, `max_results`, `personal`.

### resolve_place

**Find a destination.** Reads only. 1 point a call.

Turns a place name into a destination Dyme can search.

Arguments: `query` (required).

### search_hotels

**Search hotels on Dyme.** Reads only. 5 points a call. Drawn as a card.

Searches hotels near a place for given dates and guests, with live prices, photos, ratings, distance and cancellation terms.

Arguments: `destination` (required), `near`, `checkin` (required), `checkout` (required), `adults`, `children`, `min_stars`, `min_rating`, `max_price_per_night`, `currency`, `hotel_name`, `amenities`, `preferences`, `must_haves`, `meal_plan`, `free_cancellation_only`, `min_reviews`, `radius_km`, `guest_nationality`, `sort_by`, `rooms`, `max_results`, `personal`.

## Flights

### airline_facts

**An airline's alliance.** Reads only. 0 points a call.

Says which alliance an airline belongs to.

Arguments: `airline` (required).

### compare_fare_options

**Fares on the same flights.** Reads only. 5 points a call.

Shows every fare sold on the same flights, with bags, change and refund terms.

Arguments: `trip_id` (required), `offer_id` (required), `flight_numbers`.

### compare_routings

**Stopovers and cheaper starting points.** Reads only. 25 points a call.

Prices stopovers and starting from a nearby airport.

Arguments: `from` (required), `to` (required), `depart_date` (required), `via`, `stop_nights`, `positioning_from`, `adults` (required), `child_ages`, `cabin_class`, `currency`, `personal`, `airlines`.

### compare_ticketing

**One ticket or separate tickets.** Reads only. 10 points a call.

Compares one ticket with separate tickets for the same trip.

Arguments: `flights` (required), `adults` (required), `child_ages`, `cabin_class`, `currency`, `personal`, `airlines`, `checked_bags_per_person`, `compare_airlines`.

### passenger_rights

**What an airline owes.** Reads only. 1 point a call.

Says what an airline owes a passenger when a flight is delayed or cancelled.

Arguments: `from` (required), `to` (required), `airline` (required), `situation` (required), `arrival_delay_hours`, `departure_delay_hours`, `notice_days`, `reroute_departed_earlier_hours`, `reroute_arrived_later_hours`, `change_hours`, `airport_changed`, `connection_added`, `downgraded`, `bag_hours`, `cause`.

### refine_flights

**Refine a previous flight search.** Reads only. 0 points a call. Drawn as a card.

Narrows or re-sorts an earlier flight search by stops, times, layovers, airline or price, without searching again.

Arguments: `trip_id` (required), `nonstop`, `max_stops`, `max_price`, `airlines`, `exclude_airlines`, `depart_after`, `depart_before`, `arrive_before`, `return_depart_after`, `return_depart_before`, `return_arrive_before`, `max_layover_minutes`, `min_layover_minutes`, `sort`, `max_results`, `personal`.

### resolve_airport

**Find an airport code.** Reads only. 1 point a call.

Finds the airport or city code for a place.

Arguments: `query` (required), `max_results`.

### search_flights

**Search flights on Dyme.** Reads only. 5 points a call. Drawn as a card.

Searches one-way, round-trip and multi-city flights with live fares.

Arguments: `from` (required), `to` (required), `depart_date` (required), `flights`, `return_date`, `adults`, `children`, `cabin_class`, `nonstop`, `max_stops`, `currency`, `airlines`, `exclude_airlines`, `exclude_alliance`, `depart_after`, `depart_before`, `arrive_after`, `arrive_before`, `min_layover_minutes`, `max_layover_minutes`, `max_duration_minutes`, `refundable_only`, `airlines_only`, `infants`, `child_ages`, `sort_by`, `max_results`, `personal`.

### verify_flight_offer

**Check a flight fare is still available.** Reads only. 1 point a call.

Checks that a fare from an earlier search is still on sale.

Arguments: `offer_id` (required), `quoted_price`.

## Planning and checks

### check_trip_request

**Read a travel request before searching.** Reads only. 0 points a call.

Reads a travel request in the traveller's words and works out the dates and what is still missing.

Arguments: `request` (required), `kind` (required), `from`, `to`, `destination`, `dates`, `adults`, `children_ages`, `rooms`, `cabin`, `one_way`.

### get_travel_context

**Check whether company travel rules apply.** Reads only. 1 point a call.

Checks whether the traveller's company travel policy applies to a trip.

### recommend_alternatives

**Chloe's take: alternatives to a search.** Reads only. 8 points a call.

Chloe's deeper look: other dates, airports and tickets for flights, and cheaper rooms on the same terms for hotels.

Arguments: `trip_id` (required), `kind`.

### review_booking

**Review a hotel or flight before booking.** Reads only. 1 point a call. Drawn as a card.

Checks the price of a chosen hotel room or flight again and shows a review with one button into Dyme's checkout.

Arguments: `trip_id` (required), `hotel_id`, `room_name`, `offer_id`, `flight_numbers`.

### send_options_email

**Email the options from a search to the traveller.** Sends or starts something. 1 point a call.

Emails the traveller up to three options from a search.

Arguments: `trip_id` (required), `options`.

### trip_total

**Add up a trip, or fit it to a budget.** Reads only. 0 points a call.

Adds up a trip's prices, or fits a trip to a budget.

Arguments: `flight_trip_id`, `offer_id`, `flight_numbers`, `hotel_trip_id`, `hotel_id`, `checked_bags_per_person`, `budget`.

## Price comparison

### compare_fares

**Compare a fare with other sites.** Reads only. 10 points a call. Drawn as a card.

Compares Dyme's price for a flight with airlines and major booking sites.

Arguments: `trip_id` (required), `offer_id`, `flight_numbers`, `departure_time`, `currency`.

### compare_prices

**Compare a hotel's price with the other sites.** Reads only. 10 points a call. Drawn as a card.

Compares Dyme's price for a hotel stay with major booking sites.

Arguments: `trip_id` (required), `hotel_id` (required), `currency`, `public_only`.

### request_price_match

**Request a price match.** Sends or starts something. 10 points a call. Drawn as a card.

Sends a price match request to the Dyme team.

Arguments: `trip_id` (required), `hotel_id` (required), `currency`.

## Price watches

### list_price_watches

**List price watches.** Reads only. 0 points a call.

Lists the traveller's price watches.

### stop_price_watch

**Stop a price watch.** Removes something. 0 points a call.

Stops a price watch.

Arguments: `watch_id` (required).

### watch_flight_price

**Watch a flight route's price.** Sends or starts something. 1 point a call.

Watches Dyme's price for a flight route on exact dates and emails the traveller if it drops.

Arguments: `from` (required), `to` (required), `depart_date` (required), `return_date`, `cabin`, `adults`, `children`, `nonstop`, `airlines`, `exclude_airlines`, `flight_numbers`, `currency`, `target_price`.

### watch_hotel_price

**Watch a hotel's price.** Sends or starts something. 1 point a call.

Watches Dyme's price for a hotel stay and emails the traveller if it drops.

Arguments: `trip_id` (required), `hotel_id` (required), `target_price`.

### watch_my_booking

**Watch a booking made elsewhere.** Sends or starts something. 1 point a call.

Watches Dyme's price for a trip the traveller booked elsewhere.

Arguments: `kind` (required), `booked_via` (required), `paid_total` (required), `currency` (required), `refundable`, `hotel_id`, `hotel_name`, `checkin`, `checkout`, `adults`, `child_ages`, `room_name`, `board`, `free_cancel_until`, `from`, `to`, `depart_date`, `return_date`, `cabin`, `children`, `flight_numbers`, `change_fee`.

## The traveller's account

### dyme_help

**Answer a question about Dyme.** Reads only. 1 point a call.

Answers questions about Dyme: Miles, gift cards, referrals, business accounts and support.

Arguments: `topic` (required), `question` (required), `brand`.

### get_miles_balance

**Your Dyme Miles balance.** Reads only. 1 point a call.

Shows the traveller's Dyme Miles balance.

### get_my_trips

**Your Dyme trips.** Reads only. 1 point a call.

Lists the traveller's Dyme trips.

### start_sign_in

**Sign in to Dyme.** Reads only. 0 points a call.

Asks the traveller to sign in to Dyme.

Arguments: `via`.

## Requests to the Dyme team

### request_callback

**Ask the Dyme team to get back to the traveller.** Sends or starts something. 1 point a call.

Asks the Dyme team to get back to the traveller.

Arguments: `phone` (required), `email`, `topic` (required), `best_time`, `trip_ids`.

### request_cancellation

**Ask the Dyme team to cancel a booking.** Sends or starts something. 1 point a call.

Asks the Dyme team to cancel a booking. A person checks and cancels it.

Arguments: `booking_id` (required), `reason`.

### request_change

**Ask the Dyme team to change a booking.** Sends or starts something. 1 point a call.

Asks the Dyme team to change a booking. A person checks and makes the change.

Arguments: `kind` (required), `booking_id`, `details` (required), `trip_id`, `option_id`, `flight_numbers`, `call_back_on`.

### request_trip_approval

**Ask the company to approve this trip.** Sends or starts something. 1 point a call.

Asks the traveller's company to approve a trip outside its travel policy.

Arguments: `trip_id` (required), `option_id` (required), `note`.

## Used by the cards

Called only by the result cards inside the assistant. The assistant's model never sees these.

### get_hotel_page

**Hotel page (card only).** Reads only. 2 points a call.

Loads a hotel's page inside the results card.

Arguments: `hotel_id` (required).

### get_hotel_photos

**Hotel photo gallery (card only).** Reads only. 1 point a call.

Loads a hotel's photo gallery inside a card.

Arguments: `hotel_id` (required).

### get_hotel_rooms

**Rooms and rates for the card.** Reads only. 2 points a call.

Loads a hotel's rooms and rates inside a card.

Arguments: `trip_id`, `hotel_id` (required), `hotel_name`, `checkin`, `checkout`, `adults`, `children`, `personal`, `currency`.

### get_price_compare

**Comparison result for the card.** Reads only. 0 points a call.

Loads a price comparison's result into its card.

Arguments: `kind` (required), `args` (required).

### get_recommendation

**Chloe's take for the card.** Reads only. 1 point a call.

Loads Chloe's take into a results card.

Arguments: `kind` (required), `trip_id` (required), `start_if_missing`.

### get_results_map

**Map of hotel results (card only).** Reads only. 1 point a call.

Loads the map of hotel results inside a card.

Arguments: `trip_id` (required), `hotel_ids` (required).

HTML version: https://dyme.earth/ai/docs/tools
