This is the playbook your agent receives when the skill activates — you don't need to read it to use the skill, but it's here to audit before installing.

Requires the pricewin MCP server. This skill issues no network calls of its own.

Price Comparison

MCP server: pricewin. Compares live rates across Booking.com, Agoda, Traveloka (crawled) plus OpenTravel (direct API).

Comparison is something you do over the returned sources — there is no server-side compare call. Pick the entry point by what the user gave you:

User gave you	Tool
A city — "compare hotel prices in Da Nang"	`search_hotels_live` → `poll_search_results`
A named hotel — "is Mercure Danang cheaper on Agoda or Booking?"	`get_ota_hotel_detail`
A hotel already known to be OpenTravel direct (`source: "OPENTRAVEL_DIRECT"`, has `propertyId`)	`get_hotel_detail`

City-wide comparison

search_hotels_live returns IMMEDIATELY with a sessionId — it does not return hotels.

search_hotels_live — required: city, checkIn, checkOut (YYYY-MM-DD). Optional: adults (default 2), rooms, area, hotelName, priceMin, priceMax, language
Wait 5s → poll_search_results(sessionId, nights)
While status is pending or partial: wait 5s and poll again — up to 18 times (90s)
Present as soon as status == "partial" with hotels; keep polling silently and refine

Then compare per hotel across its sources. See pricewin-hotel-search for the full dedupe + presentation contract — do not restate it differently here.

Single named hotel

get_ota_hotel_detail — for one specific Booking.com/Agoda hotel the user named.

Required: checkIn, checkOut. Pass hotelName + city + queryText (verbatim user text) whenever known
Do NOT call search_hotels_live for a named hotel — that returns a whole-city list
Live crawl, ~20–60s. Say nothing about "loading" until it actually returns
Speed-up: if a prior search already gave you prices.booking.url, pass it as propertyUrl to skip name resolution
If it returns not-found under load, retry once

Returns rooms, prices, facilities, photos, reviews for that property.

OpenTravel direct properties

get_hotel_detail — only for results with source: "OPENTRAVEL_DIRECT".

Pass propertyId (UUID from opentravelResults[].propertyId) when available
hotelName + city is a fallback only for a property already confirmed as OpenTravel direct
Required: checkIn, checkOut. Optional: adults, children, language
Returns room types with roomTypeId and ratePlanId — these are what make a property bookable

⚠️ Router rule: have a propertyId → get_hotel_detail. Name only → get_ota_hotel_detail.

Cancellation terms

For OpenTravel rate plans only: get_cancellation_policy(propertyId, ratePlanId, checkInDate) → non-refundable flag, free-cancellation window, refund %, and the computed deadline.

ratePlanId comes from get_hotel_detail → roomTypes[].ratePlanId. Pass checkInDate or you get no deadline. OTA hotels have no structured policy — quote whatever the crawl returned.

Presenting a comparison

Rank purely by price. No source gets priority, OpenTravel included
Show the cheapest source first, then the others underneath: Agoda $X · Booking $Y · OpenTravel $Z
Savings vs the next-cheapest source: (next - cheapest) / next * 100 → "Save Z%"
When the gap is small, prefer the free-cancellation option and say why
All prices USD unless the tool says otherwise. No conversion

Tool inputs and response fields: reference.md.

Security & data handling

Documentation only — no code, no dependencies, no network calls of its own. The only data sent is the comparison query (city or hotel name, dates, guests, plus queryText — the user's message verbatim), to PriceWin's hosted MCP server https://mcp.price.win/mcp (no credentials, no account). No PII, and this skill cannot book or pay for anything. Full disclosure — operator, backend provenance, exact fields per tool — in SECURITY.md.