Commerce-Shopping

Almatar

by almatar

Overview

Almatar AI helps users search flights and hotels, add selections to cart, and complete bookings via secure payment links.

Tools

getHotelDetails

Claude

Fetch a single hotel's photo gallery and details for the stay-detail view. This is called by the Stays widget when the user opens "View more about this hotel" — it returns the hotel's image gallery and review score so the detail blow-out can show real photos instead of the single search thumbnail. It does NOT render its own widget and does NOT book anything (booking is on almatar.com). Pass the hotelId from searchHotels plus the same checkIn/checkOut/adults.

searchFlights

Claude

Search Almatar flight inventory for a one-way OR round-trip itinerary. Returns the best-value options (ranked by price). For round-trip, supply the optional returnDate — each result is one itinerary combining the outbound and return flights with a single price. For one-way, omit returnDate. OPTIONAL FILTERS: When the user asks to refine results ("direct only", "only Emirates", "under SAR 2000"), re-call this tool with the appropriate optional fields: - maxPrice, maxStops (0 = direct), airlines (partial match), departTimeWindow ("morning"/"afternoon"/"evening"/"night"), maxDurationMinutes. Each refinement is a fresh API call. OUTPUT HANDLING (important): This tool renders an interactive widget that displays the flights as cards. Each card has a single "View on Almatar" button that opens that exact fare's booking page on almatar.com. There is no in-chat fare/passenger/booking step — booking happens on almatar.com. DO NOT repeat the flight list in chat text. DO NOT paraphrase, summarise, or describe individual options. The widget IS the display. A single brief sentence like "Here are your flight options — tap View on Almatar to book." is enough, and only if you must say anything at all. This is the only flight tool. Do not attempt to call any viewFlightPrice / checkFlightPrice / chooseFlight / confirmFlightBooking / round-trip pricing tools (they are intentionally not available).

searchHotels

Claude

Search Almatar hotel inventory by destination and dates. Use this tool first in the hotel booking flow. Returns up to 10 best-value hotels (ranked by combined price, rating, and review count). OPTIONAL FILTERS: When the user asks to refine results ("only 4-star hotels", "under SAR 1500 per night", "in Marina"), re-call this tool with the appropriate optional fields: - minRating: 4 for "4 star and above" - maxPricePerNight: 1500 for "under SAR 1500 per night" - locationContains: "Marina" for "in Marina" (case-insensitive substring) Combine filters freely. Each refinement is a fresh API call. OUTPUT HANDLING (important): This tool renders an interactive widget that displays hotels as cards. Each card has two buttons: "View more about this hotel" (opens an in-widget detail blow-out with a left list of the other stays) and "View on Almatar.com" (opens the booking page). The user browses and books entirely through the widget and almatar.com. DO NOT repeat the hotel list in chat text. DO NOT paraphrase, summarise, or describe individual hotels. The widget IS the display. A single brief sentence such as "Here are the stays — tap a card to see more." is enough, and only if you must say anything at all. This is the only hotel tool. There is no in-chat rooms/cart/payment step — booking happens on almatar.com via the card's "View on Almatar.com" button. Do not attempt to call any getHotelRooms / addHotelToCart / createBooking tools (they are intentionally not available).

Links

Documentation ↗Privacy Policy ↗

App Stats

Tools

Claude

Platforms