Servers Playground How we check Add a server Log in

PriceWin

Working · 3.5 s

win.price/pricewinv1.19.0 Domain verified

Live hotel and flight prices compared across Booking.com, Agoda, Trip.com and Traveloka, in USD.

Maps & Travel

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.price.win/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

cancel_booking Destructive

Second of two steps to cancel a booking: cancels it and starts any refund due. Irreversible. Requires the confirmation code and the single-use token that request_cancel_token emailed to the guest; a missing, expired or already-used token is rejected. get_cancellation_policy shows the refund terms that apply.

reasonstring, required

Guest-provided cancellation reason (at least 3 characters)

cancelTokenstring, required

Single-use cancellation token from the email request_cancel_token sent to the guest.

confirmationCodestring, required

8-char booking confirmation code, e.g. K7X9M2P4

The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.

I understand, run it anyway

PriceWin MCP server | mcptry

Tools (13)

Tool list last changed Oct 25, 2026.

cancel_booking

destructive

Argument	Type	Description
reason*	string	Guest-provided cancellation reason (at least 3 characters)
cancelToken*	string	Single-use cancellation token from the email request_cancel_token sent to the guest.
confirmationCode*	string	8-char booking confirmation code, e.g. K7X9M2P4

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "confirmationCode",
    "cancelToken",
    "reason"
  ],
  "properties": {
    "reason": {
      "type": "string",
      "minLength": 3,
      "description": "Guest-provided cancellation reason (at least 3 characters)"
    },
    "cancelToken": {
      "type": "string",
      "minLength": 1,
      "description": "Single-use cancellation token from the email request_cancel_token sent to the guest."
    },
    "confirmationCode": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{4,32}$",
      "description": "8-char booking confirmation code, e.g. K7X9M2P4"
    }
  },
  "additionalProperties": false
}

check_booking_status

Returns the current status of a booking request (waiting for the hotel, confirmed or cancelled) by the confirmation code request_booking returned.

read-only

Argument	Type	Description
language	string	Response language
confirmationCode*	string	confirmationCode from request_booking structuredContent (e.g. 'K7X9M2P4')

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "confirmationCode"
  ],
  "properties": {
    "language": {
      "enum": [
        "en",
        "vi"
      ],
      "type": "string",
      "default": "en",
      "description": "Response language"
    },
    "confirmationCode": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{4,32}$",
      "description": "confirmationCode from request_booking structuredContent (e.g. 'K7X9M2P4')"
    }
  },
  "additionalProperties": false
}

compare_hotel_link

Compares prices for the one hotel behind a link from Booking.com, Agoda, Traveloka, Trip.com, Hotels.com or Airbnb: finds the same hotel on the other sites and lists each site's price for the whole stay, cheapest first, with a link to each. The dates and guests in the link are used when it has them, otherwise checkIn, checkOut and adults. Share links and links inside pasted text work too. Takes about 10-30 seconds.

Argument	Type	Description
url*	string	The hotel link as the user pasted it, e.g. 'https://www.agoda.com/radisson-hotel-danang/hotel/da-nang-vn.html'.
adults	integer	Number of adults, used when the link does not say (default 2).
checkIn*	string	Check-in date YYYY-MM-DD, used when the link has no dates.
checkOut*	string	Check-out date YYYY-MM-DD, used when the link has no dates.
language	string	Optional UI language hint. Only used when queryText gives no signal.
queryText	string	Short excerpt (one sentence at most) of the guest's latest message in their own words, used only to detect the reply language; it is not stored or forwarded. It carries no names, contact details or other parts of the conversation.

Input schema (JSON)

get_cancellation_policy

Returns the cancellation terms for one rate plan at an OpenTravel partner hotel: whether it is refundable, the free-cancellation window, the refund percentage, a plain-language summary and, given the check-in date, the exact free-cancellation deadline. Takes the propertyId and the ratePlanId from get_hotel_detail.

read-only

Argument	Type	Description
language	string	Reply language. Falls back to queryText, then English.
queryText	string	Short excerpt of the guest's request, used only to pick the reply language.
propertyId*	string	OpenTravel propertyId UUID from search results
ratePlanId*	string	ratePlanId from get_hotel_detail roomTypes[].ratePlanId
checkInDate*	string	Check-in date YYYY-MM-DD — required to compute the exact free-cancel deadline

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "propertyId",
    "ratePlanId",
    "checkInDate"
  ],
  "properties": {
    "language": {
      "enum": [
        "en",
        "vi"
      ],
      "type": "string",
      "description": "Reply language. Falls back to queryText, then English."
    },
    "queryText": {
      "type": "string",
      "maxLength": 500,
      "description": "Short excerpt of the guest's request, used only to pick the reply language."
    },
    "propertyId": {
      "type": "string",
      "format": "uuid",
      "description": "OpenTravel propertyId UUID from search results"
    },
    "ratePlanId": {
      "type": "string",
      "format": "uuid",
      "description": "ratePlanId from get_hotel_detail roomTypes[].ratePlanId"
    },
    "checkInDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Check-in date YYYY-MM-DD — required to compute the exact free-cancel deadline"
    }
  },
  "additionalProperties": false
}

get_hotel_detail

Prices and availability for one OpenTravel direct-listed hotel over a date range, with its photos, amenities and room types, each room with its rate plan and total price. Takes the propertyId from search results (source 'OPENTRAVEL_DIRECT'), or a hotel name plus city for a known direct listing. get_hotel_info returns the same hotel's static facts without dates.

read-only

Argument	Type	Description
city	string	City of the hotel — required when resolving by hotelName.
adults	integer	Number of adults (default 2)
checkIn*	string	Check-in date YYYY-MM-DD. Must be today or later.
checkOut*	string	Check-out date YYYY-MM-DD. Must be after checkIn.
children	integer	Number of children (default 0)
language	string	Preferred UI language (en/vi/de/ja/ko/zh/fr/es/ru/th/id).
hotelName	string	Fallback name for a confirmed OpenTravel direct listing when propertyId is unavailable
queryText	string

get_hotel_info

Static facts about an OpenTravel direct-listed hotel, with no check-in or check-out date required: photo gallery, property description, address, facilities (parking, pool, pets and so on), check-in and check-out times, the house cancellation policy, and each room type's description, floor area, capacity, photos and in-room facilities. Carries no prices and no availability — get_hotel_detail covers those for a specific date range. Takes the propertyId UUID from search results.

read-only

Argument	Type	Description
language	string	Preferred reply language (en/vi/de/ja/ko/zh).
queryText	string	Optional short excerpt of the current request, used only to detect the reply language; it is not stored or forwarded.
propertyId*	string	OpenTravel propertyId UUID from search results (opentravelResults[].propertyId).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "propertyId"
  ],
  "properties": {
    "language": {
      "enum": [
        "en",
        "vi",
        "de",
        "ja",
        "ko",
        "zh",
        "fr",
        "es",
        "ru",
        "th",
        "id"
      ],
      "type": "string",
      "description": "Preferred reply language (en/vi/de/ja/ko/zh)."
    },
    "queryText": {
      "type": "string",
      "maxLength": 500,
      "description": "Optional short excerpt of the current request, used only to detect the reply language; it is not stored or forwarded."
    },
    "propertyId": {
      "type": "string",
      "format": "uuid",
      "description": "OpenTravel propertyId UUID from search results (opentravelResults[].propertyId)."
    }
  },
  "additionalProperties": false
}

get_ota_hotel_detail

Full detail (rooms, live prices, facilities, photos, reviews) from Booking.com for one named hotel over a date range, for requests about a single hotel rather than a whole city (search_hotels_live lists a city). The name is resolved through the city's listings, so it takes the hotel name together with its city; a Booking.com URL from an earlier result skips that lookup. OpenTravel direct listings are covered by get_hotel_detail. The fetch is live and takes up to about two minutes; under heavy load it can return not-found.

Argument	Type	Description
city	string	City of the hotel, used to resolve the name, e.g. 'Da Nang'. Required with hotelName.
rooms	integer	Number of rooms (default 1)
adults	integer	Number of adults (default 2)
checkIn*	string	Check-in date YYYY-MM-DD. Must be today or later.
checkOut*	string	Check-out date YYYY-MM-DD. Must be after checkIn.
language	string	Optional UI language. Indonesian (id) cannot be detected from text, so for Indonesian this is how the language is set.
hotelName	string	Name of the hotel, e.g. 'Mercure Danang French Village Bana Hills'. Required unless propertyUrl is given.

poll_flight_results

Returns the current results of a flight search session started by search_flights_live: outbound and return options with airline, flight number, times, stops, fare and booking link. Results can be partial while the search runs; status reads 'completed' or 'failed' when it ends.

read-only

Argument	Type	Description
sessionId*	string	Session ID from search_flights_live

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "sessionId"
  ],
  "properties": {
    "sessionId": {
      "type": "string",
      "format": "uuid",
      "description": "Session ID from search_flights_live"
    }
  },
  "additionalProperties": false
}

poll_search_results

Returns the current results of a hotel search session started by search_hotels_live: hotels with their price from each source, and OpenTravel direct listings with the propertyId that get_hotel_detail and get_hotel_info take. Results can be partial while the search runs; status reads 'completed' once every source has answered.

read-only

Argument	Type	Description
area	string	Optional override for the area filter captured at search time
limit	integer	Max hotels to return; 0 = all (default 50)
nights*	integer	Number of nights
offset	integer	Skip first N hotels for pagination (default 0)
priceMax	number	Optional override for the maximum-price filter
priceMin	number	Optional override for the minimum-price filter
hotelName	string	Optional override for the hotel-name filter captured at search time
sessionId*	string	Session ID from search_hotels_live

request_booking

Sends a booking request for a room at an OpenTravel partner hotel. Nothing is charged and no room is held: the hotel confirms the request by email, and the guest pays at the property on arrival. There is no payment step, now or later. Takes the room and rate from get_hotel_detail and the guest's name, phone number and email; when any of these is missing, the result asks for it and, in clients that show widgets, opens a form for it. One request covers several rooms of the same room type (roomCount), with adults and children counted across all of them; each call is a separate request with its own code, so rooms of one type booked call by call reach the hotel as unrelated requests. Returns one confirmation code for the whole request.

Argument	Type	Description
adults*	integer	Number of adults across ALL rooms of the request — at least one per room
checkIn*	string	Check-in date YYYY-MM-DD. Must be today or later.
checkOut*	string	Check-out date YYYY-MM-DD. Must be after checkIn.
children	integer	Number of children across ALL rooms of the request (default 0)
currency*	string	Currency of totalAmount, as quoted by get_hotel_detail for the chosen room.
language	string	Optional response language hint. Only used when queryText gives no signal.

request_cancel_token

First of two steps to cancel a booking. Emails a single-use cancellation token to the address on the booking, given its confirmation code and that same email address. Nothing is cancelled, charged or refunded by this step. The token expires after 24 hours and works once; cancel_booking completes the cancellation with it.

Argument	Type	Description
guestEmail*	string	Guest email address — must match the booking primary guest email
confirmationCode*	string	8-char booking confirmation code, e.g. K7X9M2P4

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "confirmationCode",
    "guestEmail"
  ],
  "properties": {
    "guestEmail": {
      "type": "string",
      "format": "email",
      "description": "Guest email address — must match the booking primary guest email"
    },
    "confirmationCode": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{4,32}$",
      "description": "8-char booking confirmation code, e.g. K7X9M2P4"
    }
  },
  "additionalProperties": false
}

search_flights_live

Starts a live one-way flight search for a route and date. Fares come from Agoda and Google Flights. Origin and destination are 3-letter IATA airport codes (for example SGN, HAN, DAD). Returns a session ID; poll_flight_results returns the results. When the route or date is missing, the result is a question for the user instead of a search.

Argument	Type	Description
cabin	string	Cabin class (default economy)
adults	integer	Number of adults (default 1)
origin	string	Departure airport IATA code, e.g. 'SGN'. When omitted, the result asks the user for it.
language	string	Preferred UI language (en/vi/de/ja/ko/zh/fr/es/ru/th/id).
queryText	string	Optional short excerpt of the current request, used only to detect the UI language; it is not stored or forwarded.
returnDate	string	Return date YYYY-MM-DD. Return flights are not searched at the moment: the result lists outbound flights only.
destination	string	Arrival airport IATA code, e.g. 'HAN'. When omitted, the result asks the user for it.
departureDate	string	Departure date YYYY-MM-DD, today or later. When omitted, the result asks the user for it.

search_hotels_live

Starts a live hotel search for a city and date range. Prices come from Agoda, Booking.com, Traveloka, Trip.com, Hotels.com and Airbnb, plus direct rates from OpenTravel partner hotels. Returns a session ID; poll_search_results returns the results as they arrive. Optional filters narrow the results by hotel name, area or total price for the stay. Prices depend on the party: it defaults to 2 adults in 1 room, and the result states the party searched and flags when it was defaulted. When the city or dates are missing, the result is a question for the user instead of a search; the stay dates searched are echoed back for confirmation.

Argument	Type	Description
area	string	Optional district, ward, or neighborhood filter within the city
city	string	City or broad destination, e.g. 'Da Nang'. When omitted, the result asks the user for it.
rooms	integer	Number of rooms (default 1).
adults	integer	Number of adults (default 2). Prices depend on it.
checkIn	string	Check-in date (YYYY-MM-DD), today or later. When omitted, the result asks the user for it.
checkOut	string	Check-out date (YYYY-MM-DD), after checkIn. When omitted, the result asks the user for it.
children	integer	Number of children sharing the room (default 0). OTA prices cannot include children; the result says so when children are given.

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "url",
    "checkIn",
    "checkOut"
  ],
  "properties": {
    "url": {
      "type": "string",
      "maxLength": 4096,
      "minLength": 8,
      "description": "The hotel link as the user pasted it, e.g. 'https://www.agoda.com/radisson-hotel-danang/hotel/da-nang-vn.html'."
    },
    "adults": {
      "type": "integer",
      "default": 2,
      "maximum": 30,
      "minimum": 1,
      "description": "Number of adults, used when the link does not say (default 2)."
    },
    "checkIn": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Check-in date YYYY-MM-DD, used when the link has no dates."
    },
    "checkOut": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Check-out date YYYY-MM-DD, used when the link has no dates."
    },
    "language": {
      "enum": [
        "en",
        "vi",
        "de",
        "ja",
        "ko",
        "zh",
        "fr",
        "es",
        "ru",
        "th",
        "id"
      ],
      "type": "string",
      "description": "Optional UI language hint. Only used when queryText gives no signal."
    },
    "queryText": {
      "type": "string",
      "maxLength": 500,
      "description": "Short excerpt (one sentence at most) of the guest's latest message in their own words, used only to detect the reply language; it is not stored or forwarded. It carries no names, contact details or other parts of the conversation."
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "checkIn",
    "checkOut"
  ],
  "properties": {
    "city": {
      "type": "string",
      "description": "City of the hotel, used to resolve the name, e.g. 'Da Nang'. Required with hotelName."
    },
    "rooms": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Number of rooms (default 1)"
    },
    "adults": {
      "type": "integer",
      "default": 2,
      "minimum": 1,
      "description": "Number of adults (default 2)"
    },
    "checkIn": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Check-in date YYYY-MM-DD. Must be today or later."
    },
    "checkOut": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Check-out date YYYY-MM-DD. Must be after checkIn."
    },
    "language": {
      "enum": [
        "en",
        "vi",
        "de",
        "ja",
        "ko",
        "zh",
        "fr",
        "es",
        "ru",
        "th",
        "id"
      ],
      "type": "string",
      "description": "Optional UI language. Indonesian (id) cannot be detected from text, so for Indonesian this is how the language is set."
    },
    "hotelName": {
      "type": "string",
      "description": "Name of the hotel, e.g. 'Mercure Danang French Village Bana Hills'. Required unless propertyUrl is given."
    },
    "queryText": {
      "type": "string",
      "maxLength": 500,
      "description": "Short excerpt (one sentence at most) of the guest's latest message in their own words, used only to detect the reply language; it is not stored or forwarded. It carries no names, contact details or other parts of the conversation."
    },
    "propertyUrl": {
      "type": "string",
      "description": "Booking.com property URL from an earlier result (hotel.prices.booking.url); skips the name lookup."
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "propertyId",
    "checkIn",
    "checkOut",
    "roomTypeId",
    "adults",
    "totalAmount",
    "currency"
  ],
  "properties": {
    "adults": {
      "type": "integer",
      "minimum": 1,
      "description": "Number of adults across ALL rooms of the request — at least one per room"
    },
    "checkIn": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Check-in date YYYY-MM-DD. Must be today or later."
    },
    "checkOut": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Check-out date YYYY-MM-DD. Must be after checkIn."
    },
    "children": {
      "type": "integer",
      "default": 0,
      "minimum": 0,
      "description": "Number of children across ALL rooms of the request (default 0)"
    },
    "currency": {
      "enum": [
        "VND",
        "USD",
        "EUR"
      ],
      "type": "string",
      "description": "Currency of totalAmount, as quoted by get_hotel_detail for the chosen room."
    },
    "language": {
      "enum": [
        "en",
        "vi",
        "de",
        "ja",
        "ko",
        "zh",
        "fr",
        "es",
        "ru",
        "th",
        "id"
      ],
      "type": "string",
      "description": "Optional response language hint. Only used when queryText gives no signal."
    },
    "guestName": {
      "type": "string",
      "minLength": 1,
      "description": "Full name of the primary guest. When omitted, the result asks the user for it."
    },
    "queryText": {
      "type": "string",
      "maxLength": 500,
      "description": "Short excerpt (one sentence at most) of the guest's latest message in their own words, used only to detect the reply language; it is not stored or forwarded. It carries no names, contact details or other parts of the conversation."
    },
    "roomCount": {
      "type": "integer",
      "default": 1,
      "maximum": 10,
      "minimum": 1,
      "description": "How many rooms of this room type the guest wants (default 1). All of them go in this one request, under one confirmation code."
    },
    "guestEmail": {
      "type": "string",
      "format": "email",
      "description": "Email address the confirmation is sent to, as the guest gave it; it cannot be changed after the request is sent. When omitted, the result asks the user for it."
    },
    "guestPhone": {
      "type": "string",
      "minLength": 1,
      "description": "Guest phone number; the hotel calls it to confirm the request. When omitted, the result asks the user for it."
    },
    "propertyId": {
      "type": "string",
      "format": "uuid",
      "description": "OpenTravel propertyId from get_hotel_detail"
    },
    "roomTypeId": {
      "type": "string",
      "description": "roomTypeId from get_hotel_detail roomTypes array"
    },
    "totalAmount": {
      "type": "number",
      "description": "Total amount for ALL rooms in the property's base currency: the room's price for the stay × roomCount"
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "area": {
      "type": "string",
      "maxLength": 120,
      "description": "Optional district, ward, or neighborhood filter within the city"
    },
    "city": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "City or broad destination, e.g. 'Da Nang'. When omitted, the result asks the user for it."
    },
    "rooms": {
      "type": "integer",
      "default": 1,
      "maximum": 20,
      "minimum": 1,
      "description": "Number of rooms (default 1)."
    },
    "adults": {
      "type": "integer",
      "default": 2,
      "maximum": 20,
      "minimum": 1,
      "description": "Number of adults (default 2). Prices depend on it."
    },
    "checkIn": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Check-in date (YYYY-MM-DD), today or later. When omitted, the result asks the user for it."
    },
    "checkOut": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Check-out date (YYYY-MM-DD), after checkIn. When omitted, the result asks the user for it."
    },
    "children": {
      "type": "integer",
      "default": 0,
      "maximum": 20,
      "minimum": 0,
      "description": "Number of children sharing the room (default 0). OTA prices cannot include children; the result says so when children are given."
    },
    "language": {
      "enum": [
        "en",
        "vi",
        "de",
        "ja",
        "ko",
        "zh",
        "fr",
        "es",
        "ru",
        "th",
        "id"
      ],
      "type": "string",
      "description": "Preferred UI language (en/vi/de/ja/ko/zh/fr/es/ru/th/id)."
    },
    "priceMax": {
      "type": "number",
      "maximum": 1000000000,
      "minimum": 0,
      "description": "Maximum total price for the whole stay (not per night), in priceCurrency."
    },
    "priceMin": {
      "type": "number",
      "maximum": 1000000000,
      "minimum": 0,
      "description": "Minimum total price for the whole stay (not per night), in priceCurrency."
    },
    "amenities": {
      "type": "array",
      "items": {
        "enum": [
          "pool",
          "beach",
          "breakfast",
          "parking",
          "gym",
          "spa",
          "airport_shuttle",
          "kitchen",
          "family"
        ],
        "type": "string"
      },
      "maxItems": 9,
      "description": "Optional amenities every hotel shown must have, as at least one of its sites lists them: pool, beach, breakfast, parking, gym, spa, airport_shuttle, kitchen, family (family rooms)."
    },
    "hotelName": {
      "type": "string",
      "maxLength": 200,
      "description": "Optional hotel-name filter when the user names a specific property"
    },
    "queryText": {
      "type": "string",
      "maxLength": 500,
      "description": "Optional short excerpt of the current request, used only to detect the UI language; it is not stored or forwarded."
    },
    "priceCurrency": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "ISO 4217 code of priceMin/priceMax (USD, EUR, VND, …); defaults to the currency of the UI language."
    }
  },
  "additionalProperties": false
}