{"apiVersion":"v1","directorySlug":"hotelrefund-mcp-3e60e8f75d","title":"HotelRefund","description":"Free hotel price tracker, no signup. We check your hotel","pageUrl":"https://www.mcpbundles.com/skills/hotelrefund-mcp-3e60e8f75d","connectPath":"importable","connectAction":"import_server","catalogListing":false,"bundleSlug":null,"listingKind":"remote_mcp","kind":"provider","transportUrl":"https://hotelrefund.net/mcp","hostedMcpUrl":null,"toolCount":11,"toolInventoryStatus":"observed","refreshedAt":"2026-11-03T13:26:00.516172+00:00","registryName":"net.hotelrefund/hotelrefund-mcp-3e60e8f75d","registryVersion":"2026.11.3","registryEligible":true,"tools":[{"name":"search_hotels","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","inputSchema":{"type":"object","properties":{"city":{"type":"string"},"hotel":{"type":"string"},"limit":{"type":"integer","maximum":20,"minimum":1},"city_id":{"type":"integer"}}},"title":"Find the agoda_hotel_id for a hotel","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"logicalName":"search_hotels","displayName":"Find the agoda_hotel_id for a hotel"},{"name":"track_hotel_price","description":"Today is 2026-10-12 (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-11 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","inputSchema":{"type":"object","required":["agoda_hotel_id","check_in","check_out"],"properties":{"check_in":{"type":"string"},"currency":{"type":"string"},"language":{"type":"string"},"check_out":{"type":"string"},"agoda_hotel_id":{"type":"integer"}}},"title":"Start tracking a hotel price","logicalName":"track_hotel_price","displayName":"Start tracking a hotel price","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"get_price_history","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 d","inputSchema":{"type":"object","required":["tracking_id"],"properties":{"language":{"enum":["en","ko","ja","zh"],"type":"string"},"tracking_id":{"type":"integer"}}},"title":"Get price history for a tracking","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"logicalName":"get_price_history","displayName":"Get price history for a tracking"},{"name":"list_tracked_hotels","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":{"type":"object","properties":{"limit":{"type":"integer","maximum":50,"minimum":1},"language":{"enum":["en","ko","ja","zh"],"type":"string"}}},"title":"List publicly tracked hotels","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"logicalName":"list_tracked_hotels","displayName":"List publicly tracked hotels"},{"name":"list_hotel_deals","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 onc","inputSchema":{"type":"object","properties":{"city":{"type":"string"},"limit":{"type":"integer","maximum":60,"minimum":1},"city_id":{"type":"integer"}}},"title":"List today's hotel deals","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"logicalName":"list_hotel_deals","displayName":"List today's hotel deals"},{"name":"get_hotel_price_calendar","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, s","inputSchema":{"type":"object","required":["agoda_hotel_id"],"properties":{"days":{"type":"integer","maximum":35,"minimum":7},"nights":{"type":"integer","maximum":14,"minimum":1},"currency":{"type":"string"},"language":{"type":"string"},"start_date":{"type":"string"},"agoda_hotel_id":{"type":"integer"}}},"title":"Price by check-in date for one hotel","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"logicalName":"get_hotel_price_calendar","displayName":"Price by check-in date for one hotel"},{"name":"get_refund_guide","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":{"type":"object","properties":{"topic":{"type":"string"},"language":{"enum":["en","ko","ja","zh"],"type":"string"}}},"title":"Read a hotel refund or cancellation guide","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"logicalName":"get_refund_guide","displayName":"Read a hotel refund or cancellation guide"},{"name":"get_service_status","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":{"type":"object","properties":{}},"title":"Check service status and coverage","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"logicalName":"get_service_status","displayName":"Check service status and coverage"},{"name":"get_current_price","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 ar","inputSchema":{"type":"object","required":["agoda_hotel_id","check_in","check_out"],"properties":{"check_in":{"type":"string"},"currency":{"type":"string"},"language":{"enum":["en","ko","ja","zh"],"type":"string"},"check_out":{"type":"string"},"agoda_hotel_id":{"type":"integer"}}},"title":"Read the current Agoda price for a stay","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"logicalName":"get_current_price","displayName":"Read the current Agoda price for a stay"},{"name":"check_refund_claim","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 timestamp","inputSchema":{"type":"object","required":["booked_on","lower_price_site","check_in"],"properties":{"check_in":{"type":"string"},"language":{"enum":["en","ko","ja","zh"],"type":"string"},"booked_on":{"enum":["booking","agoda","trip","expedia","hotels","other"],"type":"string"},"check_out":{"type":"string"},"paid_total":{"type":"number"},"booked_date":{"type":"string"},"lower_total":{"type":"number"},"tracking_id":{"type":"integer"},"paid_currency":{"type":"string"},"lower_currency":{"type":"string"},"conditions_match":{"type":"object","properties":{"public_rate":{"type":"boolean"},"same_hotel_and_room":{"type":"boolean"},"same_dates_and_guests":{"type":"boolean"},"same_policy_and_breakfast":{"type":"boolean"}}},"lower_price_site":{"enum":["booking","agoda","trip","expedia","hotels","other"],"type":"string"},"cancellation_policy":{"enum":["free_cancellation","non_refundable"],"type":"string"},"lower_price_site_other":{"type":"string"}}},"title":"Check a best price guarantee claim","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"logicalName":"check_refund_claim","displayName":"Check a best price guarantee claim"},{"name":"draft_refund_request","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 recor","inputSchema":{"type":"object","required":["kind","hotel_name","check_in","check_out"],"properties":{"city":{"type":"string"},"kind":{"enum":["price_guarantee","date_change","goodwill_refund","checkin_request"],"type":"string"},"perks":{"type":"array","items":{"enum":["upgrade","late","breakfast"],"type":"string"}},"adults":{"type":"integer"},"reason":{"enum":["illness","flight","visa","family","disaster","other"],"type":"string"},"check_in":{"type":"string"},"booked_on":{"enum":["booking","agoda","trip","expedia","hotels","other"],"type":"string"},"breakfast":{"type":"boolean"},"check_out":{"type":"string"},"lower_url":{"type":"string"},"room_type":{"type":"string"},"hotel_name":{"type":"string"},"paid_total":{"type":"number"},"booked_date":{"type":"string"},"lower_total":{"type":"number"},"tracking_id":{"type":"integer"},"new_check_in":{"type":"string"},"lower_seen_at":{"type":"string"},"new_check_out":{"type":"string"},"paid_currency":{"type":"string"},"lower_currency":{"type":"string"},"letter_language":{"enum":["en","ko","ja","zh"],"type":"string"},"lower_price_site":{"enum":["booking","agoda","trip","expedia","hotels","other"],"type":"string"},"cancellation_policy":{"enum":["free_cancellation","non_refundable"],"type":"string"},"lower_price_site_other":{"type":"string"}}},"title":"Write a refund claim or hotel request","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"logicalName":"draft_refund_request","displayName":"Write a refund claim or hotel request"}],"toolSource":"directory_preview","agentAction":"both","installLinks":[{"id":"cursor","label":"Cursor","href":"cursor://anysphere.cursor-deeplink/mcp/install?name=HotelRefund&config=eyJ1cmwiOiAiaHR0cHM6Ly9ob3RlbHJlZnVuZC5uZXQvbWNwIn0%3D"},{"id":"vscode","label":"VS Code","href":"vscode:mcp/install?%7B%22name%22%3A%22HotelRefund%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fhotelrefund.net%2Fmcp%22%7D"},{"id":"vscode-insiders","label":"VS Code Insiders","href":"vscode-insiders:mcp/install?%7B%22name%22%3A%22HotelRefund%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fhotelrefund.net%2Fmcp%22%7D"},{"id":"claude-web","label":"Claude.ai","href":"https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=HotelRefund&connectorUrl=https%3A%2F%2Fhotelrefund.net%2Fmcp"},{"id":"codex","label":"Codex","copyText":"codex mcp add \"HotelRefund\" --url \"https://hotelrefund.net/mcp\""},{"id":"chatgpt","label":"ChatGPT","href":"https://www.mcpbundles.com/docs/integrations/chatgpt"}],"catalogUrl":"https://www.mcpbundles.com/api/directory/v1/servers/hotelrefund-mcp-3e60e8f75d","callUrl":"https://www.mcpbundles.com/api/directory/v1/servers/hotelrefund-mcp-3e60e8f75d/tools/{tool}","mcpServerUrl":"https://hotelrefund.net/mcp","liveCatalogUrl":"https://www.mcpbundles.com/api/directory/v1/servers/hotelrefund-mcp-3e60e8f75d?live=1"}