Server definition
- Hash
- sha256:f01f8c517c04ad226b49c006413ed96db243eae511cedcac3b2523a829e5fc48
- What it is
- What a remote MCP server returned when asked what it offers: 11 tools
The blob, as servednamed by its sha256
{
"instructions": "Today is 2026-10-04 (UTC) — never infer the date from the conversation or from training data. Stay dates are calendar days in the hotel's local time zone, which in Asia is already ahead of UTC, so check_in must be 2026-10-03 or later; an earlier check_in is rejected, not silently accepted. HotelRefund is a price tracker, not a hotel search or comparison service. It is the tool that creates state: register one hotel for one stay once, and its Agoda price keeps being checked several times a day from then on; ask again days or weeks later and you get what changed in between — every observed price, with timestamps, as a printable page and a CSV that people use as evidence for price claims. Flow: search_hotels only resolves a hotel name to the agoda_hotel_id that track_hotel_price needs (it returns no prices); track_hotel_price starts — or joins — tracking for the stay dates; get_price_history returns the recorded prices and a book-now-or-wait signal for one tracking; list_tracked_hotels lists every public tracking. list_hotel_deals returns today's biggest observed Agoda discounts, worldwide or for one city. get_hotel_price_calendar shows the Agoda price across nearby check-in dates for one hotel. After booking: get_current_price reads the Agoda price for a stay right now; check_refund_claim says whether a lower price found elsewhere qualifies for the booking site's best price guarantee and by when; draft_refund_request writes the claim message and letter (or a date change, goodwill refund or check-in request to the hotel) — names and booking numbers are left as placeholders and never sent to HotelRefund. get_refund_guide returns reference guides on cancellation deadlines, refunds and rebooking after a price drop; get_service_status reports coverage and the remaining daily registration allowance. Tracking is free, anonymous and public — no accounts, no keys. Registrations from AI clients count toward a shared daily limit; reading is not limited. Best fit: Korea, Japan and Southeast Asia, where Agoda coverage is strongest. Pages exist in en, ko, ja and zh: pass language to track_hotel_price, get_price_history and list_tracked_hotels to get track_page_url and the timing read in the user's language. Hotel and city names are in English (as Agoda lists them) plus name_local / city_local {ko, ja, zh} where known — call the hotel by its local name when talking to the user, and use the English name when the user searches on Agoda. Price basis: every tracked price is Agoda's total for the whole stay with taxes and fees included, for 2 adults, at the standard rate Agoda returns to partners — coupons, member or app-only discounts and non-refundable rates are not included. Agoda's own pages often show prices before tax, so tell users to compare against the tax-inclusive total at checkout (see price_basis in the tool results).",
"tools": [
{
"description": "Check whether a lower price found after booking qualifies for the booking site's best price guarantee, using the same rules as the HotelRefund Refund Report: same-site drops, sites that ended their guarantee (Hotels.com; Expedia for newer bookings), currency mismatch, a price that is not actually lower, and the four matching conditions. Returns a verdict, the claim deadline (date, rule and days left), how the site pays out, the difference, and — with tracking_id — whether HotelRefund's timestamped Agoda records cover the same dates. No personal data is needed or accepted.",
"inputSchema": {
"properties": {
"booked_date": {
"description": "Date the booking was made, YYYY-MM-DD (decides old Expedia bookings).",
"type": "string"
},
"booked_on": {
"description": "Where the stay was booked.",
"enum": [
"booking",
"agoda",
"trip",
"expedia",
"hotels",
"other"
],
"type": "string"
},
"cancellation_policy": {
"description": "The booking's cancellation policy.",
"enum": [
"free_cancellation",
"non_refundable"
],
"type": "string"
},
"check_in": {
"description": "Check-in date, YYYY-MM-DD.",
"type": "string"
},
"check_out": {
"description": "Check-out date, YYYY-MM-DD.",
"type": "string"
},
"conditions_match": {
"description": "What the user has confirmed about the lower offer. Anything not true is reported as unconfirmed.",
"properties": {
"public_rate": {
"description": "Not a member, app-only, coupon or package rate.",
"type": "boolean"
},
"same_dates_and_guests": {
"type": "boolean"
},
"same_hotel_and_room": {
"type": "boolean"
},
"same_policy_and_breakfast": {
"type": "boolean"
}
},
"type": "object"
},
"language": {
"description": "Language of the verdict text: en (default), ko, ja or zh.",
"enum": [
"en",
"ko",
"ja",
"zh"
],
"type": "string"
},
"lower_currency": {
"description": "ISO currency of lower_total (defaults to paid_currency).",
"type": "string"
},
"lower_price_site": {
"description": "Where the lower price was seen.",
"enum": [
"booking",
"agoda",
"trip",
"expedia",
"hotels",
"other"
],
"type": "string"
},
"lower_price_site_other": {
"description": "Site name when lower_price_site is \"other\".",
"type": "string"
},
"lower_total": {
"description": "Total of the lower offer for the same stay, taxes included.",
"type": "number"
},
"paid_currency": {
"description": "ISO currency of paid_total.",
"type": "string"
},
"paid_total": {
"description": "Total paid for the stay, taxes included.",
"type": "number"
},
"tracking_id": {
"description": "Optional HotelRefund tracking for the same stay — its recorded prices are summarized as independent evidence.",
"type": "integer"
}
},
"required": [
"booked_on",
"lower_price_site",
"check_in"
],
"type": "object"
},
"name": "check_refund_claim",
"outputSchema": null
},
{
"description": "Write the text for one of four requests, in en, ko, ja or zh: price_guarantee (claim to the booking site for the difference), date_change, goodwill_refund (for a non-refundable booking, with a reason) or checkin_request (upgrade, late check-out or breakfast, citing the lower price) to the hotel. Returns a short message for a chat or claim form and a full letter. The confirmation number and guest name are not accepted; they appear as placeholders in the text. With tracking_id, HotelRefund's recorded Agoda prices for the same dates are added to price_guarantee and checkin_request letters. The same letter can be saved as a PDF at refund_report_url.",
"inputSchema": {
"properties": {
"adults": {
"description": "Default 2.",
"type": "integer"
},
"booked_date": {
"description": "YYYY-MM-DD.",
"type": "string"
},
"booked_on": {
"description": "Booking site. Required for price_guarantee; omit for a direct hotel booking.",
"enum": [
"booking",
"agoda",
"trip",
"expedia",
"hotels",
"other"
],
"type": "string"
},
"breakfast": {
"description": "Breakfast included in the booking.",
"type": "boolean"
},
"cancellation_policy": {
"enum": [
"free_cancellation",
"non_refundable"
],
"type": "string"
},
"check_in": {
"description": "YYYY-MM-DD.",
"type": "string"
},
"check_out": {
"description": "YYYY-MM-DD.",
"type": "string"
},
"city": {
"type": "string"
},
"hotel_name": {
"type": "string"
},
"kind": {
"enum": [
"price_guarantee",
"date_change",
"goodwill_refund",
"checkin_request"
],
"type": "string"
},
"letter_language": {
"description": "Language of the text: en (default), ko, ja or zh. Usually the language the booking site or hotel reads.",
"enum": [
"en",
"ko",
"ja",
"zh"
],
"type": "string"
},
"lower_currency": {
"type": "string"
},
"lower_price_site": {
"description": "Required for price_guarantee.",
"enum": [
"booking",
"agoda",
"trip",
"expedia",
"hotels",
"other"
],
"type": "string"
},
"lower_price_site_other": {
"type": "string"
},
"lower_seen_at": {
"description": "When the lower price was seen, e.g. 2026-10-02 14:30.",
"type": "string"
},
"lower_total": {
"description": "Required for price_guarantee.",
"type": "number"
},
"lower_url": {
"description": "Link to the lower offer.",
"type": "string"
},
"new_check_in": {
"description": "date_change: requested new check-in, YYYY-MM-DD. Omit to ask which dates are possible.",
"type": "string"
},
"new_check_out": {
"description": "date_change: requested new check-out, YYYY-MM-DD.",
"type": "string"
},
"paid_currency": {
"description": "ISO currency of paid_total.",
"type": "string"
},
"paid_total": {
"description": "Total paid, taxes included. Required for price_guarantee.",
"type": "number"
},
"perks": {
"description": "checkin_request: what to ask for.",
"items": {
"enum": [
"upgrade",
"late",
"breakfast"
],
"type": "string"
},
"type": "array"
},
"reason": {
"description": "goodwill_refund: why the stay cannot go ahead.",
"enum": [
"illness",
"flight",
"visa",
"family",
"disaster",
"other"
],
"type": "string"
},
"room_type": {
"type": "string"
},
"tracking_id": {
"description": "Optional HotelRefund tracking for the same stay.",
"type": "integer"
}
},
"required": [
"kind",
"hotel_name",
"check_in",
"check_out"
],
"type": "object"
},
"name": "draft_refund_request",
"outputSchema": null
},
{
"description": "Read the Agoda price for one hotel (agoda_hotel_id from search_hotels) and one stay right now: total for the whole stay with taxes and fees, 2 adults, standard rate, plus room type and breakfast when Agoda reports them. A one-time reading — nothing is tracked or stored about the request. Used after booking elsewhere to see whether Agoda is now cheaper (input for check_refund_claim), or to compare a quoted price. agoda_url is a plain Agoda link for the same stay, suitable as evidence. Readings are cached for 30 minutes; live lookups share a daily budget.",
"inputSchema": {
"properties": {
"agoda_hotel_id": {
"description": "Hotel id from search_hotels.",
"type": "integer"
},
"check_in": {
"description": "Check-in date, YYYY-MM-DD.",
"type": "string"
},
"check_out": {
"description": "Check-out date, YYYY-MM-DD (stay of 30 nights or less).",
"type": "string"
},
"currency": {
"description": "ISO currency: KRW, JPY, USD, EUR, TWD, HKD, CNY, SGD, THB, GBP, AUD or VND (default USD). Use the currency the booking was paid in.",
"type": "string"
},
"language": {
"description": "en (default), ko, ja or zh.",
"enum": [
"en",
"ko",
"ja",
"zh"
],
"type": "string"
}
},
"required": [
"agoda_hotel_id",
"check_in",
"check_out"
],
"type": "object"
},
"name": "get_current_price",
"outputSchema": null
},
{
"description": "Show what one hotel (agoda_hotel_id from search_hotels) costs on Agoda for each check-in date in a window — the \"what if I move my dates\" view. Returns one price snapshot per date (with fetched_at), the cheapest date, and low/high bands for the hotel; dates with an active tracking are marked is_tracked with their track_page_url. This is a cross-section by date, not a time series: to keep watching a date, call track_hotel_price for it. Most dates are fetched in the background on the first call, so pending may be > 0 — call again with the same arguments after ~3 seconds to get the rest. Default window: 28 days from start_date (or today), 1 night, 2 adults.",
"inputSchema": {
"properties": {
"agoda_hotel_id": {
"description": "Hotel id from search_hotels.",
"type": "integer"
},
"currency": {
"description": "KRW, JPY, USD, EUR, TWD, HKD, CNY, SGD, THB, GBP, AUD or VND (default USD).",
"type": "string"
},
"days": {
"description": "How many consecutive check-in dates (default 28, max 35).",
"maximum": 35,
"minimum": 7,
"type": "integer"
},
"language": {
"description": "Agoda locale for the rate: ko-kr, ja-jp, en-us, zh-cn, zh-tw or zh-hk (default en-us).",
"type": "string"
},
"nights": {
"description": "Stay length for every date (default 1).",
"maximum": 14,
"minimum": 1,
"type": "integer"
},
"start_date": {
"description": "First check-in date to show, YYYY-MM-DD (default today; past dates are moved to today).",
"type": "string"
}
},
"required": [
"agoda_hotel_id"
],
"type": "object"
},
"name": "get_hotel_price_calendar",
"outputSchema": null
},
{
"description": "Return the recorded prices for one tracking (tracking_id): current, first, lowest and highest price, percentage change and trend since tracking started, and the time series of observed prices. Also returns booking_guidance — a book-now-or-wait signal computed from this stay's full tracked record (share of observations lower than now, distance from the median, overall spread, days left), and headline + summary sentences (in language: en, ko, ja or zh) that explain the read the same way the page does. track_page_url is the booking-decision page in that language. And report_url / csv_url: every observation with UTC timestamps as a printable page and a CSV, which people use as evidence for best-price-guarantee claims, refund requests and check-in negotiation. When available, seasonality adds the destination's forecast monthly rates for the hotel's star band (a separate scale from the tracked prices — it says whether the stay month is a high or low month for the city, and which nearby month is cheapest). A tracking created moments ago may report awaiting_first_price until its first check completes; no_rates means there is no sellable rate for these dates right now (sold out or not open yet) and it is re-checked daily.",
"inputSchema": {
"properties": {
"language": {
"description": "Language for booking_guidance.headline/summary and track_page_url: en (default), ko, ja or zh.",
"enum": [
"en",
"ko",
"ja",
"zh"
],
"type": "string"
},
"tracking_id": {
"description": "Tracking id from track_hotel_price or list_tracked_hotels.",
"type": "integer"
}
},
"required": [
"tracking_id"
],
"type": "object"
},
"name": "get_price_history",
"outputSchema": null
},
{
"description": "Return the full text of one HotelRefund reference guide on what to do about a booking that already exists: cancellation deadlines, getting a refund, what to do when the price drops after booking, how best-price guarantees work, refundable vs non-refundable rates, and why rates move. Call without arguments to list every guide with its topic id and a one-line summary. Guide text is English; language returns the matching Korean, Japanese or Chinese page url alongside it.",
"inputSchema": {
"properties": {
"language": {
"description": "Language for the returned url: en (default), ko, ja or zh.",
"enum": [
"en",
"ko",
"ja",
"zh"
],
"type": "string"
},
"topic": {
"description": "Topic id from a previous listing (e.g. \"hotel-free-cancellation-deadline\"), or plain words describing the situation (e.g. \"price dropped after booking\", \"취소 마감\"). Omit to list all guides.",
"type": "string"
}
},
"type": "object"
},
"name": "get_refund_guide",
"outputSchema": null
},
{
"description": "Report whether the tracker is running and what it covers: the number of hotels and cities in the catalog that can be tracked, how many stays are tracked right now, price checks in the last 24 hours, and the remaining shared daily registration allowance for AI clients. Useful before starting a longer flow, or to confirm the server is live.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "get_service_status",
"outputSchema": null
},
{
"description": "List today's biggest observed hotel discounts: Agoda's live rate for a 1-night stay about two weeks ahead (2 adults, USD) compared with Agoda's own listed rate for the same room; only discounts of 5% or more are kept. Without arguments, returns the single best deal per city across major cities worldwide, biggest discount first. With city (a city name in Korean, Japanese, Chinese or English) or city_id, returns the current deals for that city (up to 6; an uncached city is fetched live at most once per 6 hours). Each deal includes booking_url, the Agoda page for that hotel and stay, and image_url when a photo is available.",
"inputSchema": {
"properties": {
"city": {
"description": "Optional city, region or airport name, e.g. \"Tokyo\", \"도쿄\", \"東京\". Omit for the worldwide list.",
"type": "string"
},
"city_id": {
"description": "Catalog city id from a previous search_hotels or list_hotel_deals result. Overrides city.",
"type": "integer"
},
"limit": {
"description": "Max deals to return (default 20).",
"maximum": 60,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "list_hotel_deals",
"outputSchema": null
},
{
"description": "List the hotels currently being tracked (all trackings are public), with current price, change since tracking started, stay dates and per-item booking_url / track_page_url (in language), sorted with the biggest price drops first.",
"inputSchema": {
"properties": {
"language": {
"description": "Language of each track_page_url: en (default), ko, ja or zh.",
"enum": [
"en",
"ko",
"ja",
"zh"
],
"type": "string"
},
"limit": {
"description": "Max items to return (default 20).",
"maximum": 50,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "list_tracked_hotels",
"outputSchema": null
},
{
"description": "Resolve a hotel to the agoda_hotel_id that track_hotel_price needs. This is a lookup step, not a hotel search engine: it returns catalog entries (name, address, stars, rating, review count) and no prices — for prices, track the hotel or use list_hotel_deals. Give a city, region or airport name (Korean, Japanese, Chinese or English) and, when the user named a hotel, the hotel filter; the city is resolved to the best catalog match. If several cities match, other_city_matches lists them — pass one of their city_id values (instead of city) to search that city. Typical flow: search_hotels → track_hotel_price → get_price_history.",
"inputSchema": {
"properties": {
"city": {
"description": "City, region or airport name, e.g. \"Sapporo\", \"삿포로\", \"札幌\". Required unless city_id is given.",
"type": "string"
},
"city_id": {
"description": "Catalog city id from a previous result (other_city_matches). Overrides city.",
"type": "integer"
},
"hotel": {
"description": "Optional hotel-name filter within the city, e.g. \"Hilton\", \"힐튼\". Omit to list notable hotels. A hotel name alone is not enough — city (or city_id) is still required.",
"type": "string"
},
"limit": {
"description": "Max hotels to return (default 8).",
"maximum": 20,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "search_hotels",
"outputSchema": null
},
{
"description": "Today is 2026-10-04 (UTC) — never infer the date from the conversation or from training data. Stay dates are calendar days in the hotel's local time zone, which in Asia is already ahead of UTC, so check_in must be 2026-10-03 or later; an earlier check_in is rejected, not silently accepted. Start tracking one hotel (agoda_hotel_id from search_hotels) for one stay (check_in to check_out, YYYY-MM-DD). This is the tool that creates lasting state: from now on the Agoda price is checked automatically several times a day and every observed price is recorded, so the same tracking_id can be asked about days or weeks later with get_price_history. Free, anonymous and public; no account. If the same hotel and dates are already tracked, the existing tracking is returned instead of a duplicate, so it is safe to call again. The response includes tracking_id, booking_url (the Agoda page for this hotel via a HotelRefund redirect) and track_page_url (the booking-decision page: price chart, timing read and a book button; in the language given by language, with track_page_urls for all four). Used both before booking (to catch a drop) and after booking a refundable rate (to see when rebooking would pay off).",
"inputSchema": {
"properties": {
"agoda_hotel_id": {
"description": "Hotel id from search_hotels.",
"type": "integer"
},
"check_in": {
"description": "Check-in date, YYYY-MM-DD (today up to 540 days ahead).",
"type": "string"
},
"check_out": {
"description": "Check-out date, YYYY-MM-DD (after check_in, stay of 60 nights or less).",
"type": "string"
},
"currency": {
"description": "Optional ISO currency for recorded prices: KRW, JPY, USD, EUR, TWD, HKD, CNY, SGD, THB, GBP, AUD or VND. Defaults by language.",
"type": "string"
},
"language": {
"description": "Optional locale for the tracked rate: ko-kr, ja-jp, en-us, zh-cn, zh-tw or zh-hk (default en-us).",
"type": "string"
}
},
"required": [
"agoda_hotel_id",
"check_in",
"check_out"
],
"type": "object"
},
"name": "track_hotel_price",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:f01f8c517c04ad226b49c006413ed96db243eae511cedcac3b2523a829e5fc48 | sha256sum