io.github.negm17111995/maqami-travel · v1.0.9 · location-and-travel
MAQAMI Travel is healthy: it completed an MCP handshake in 908 ms and exposes 41 tools.
Official MCP server for MAQAMI, a hotel and flight booking platform with 3M+ hotels.
Endpoint: https://mcp.maqami.co/ (streamable-http)
Repository · Website · JSON · Add to my inventory
| Users (last 30 days) | 0 |
| Handshake | Healthy |
| Auth needed | None |
| Tool count | 41 |
| Latency | 908 ms |
| Last checked (UTC) | 2026-10-16T10:55:37.453Z |
| Checked (UTC) | Status | Latency | Error |
|---|---|---|---|
| 2026-10-16T10:55:37.453Z | Healthy | 908 | |
| 2026-10-15T06:10:37.131Z | Healthy | 3627 |
post_hotels_rates | ## Overview Search for hotel rates and availability across multiple hotels. This is your primary endpoint for finding bookable hotel rooms with real-time pricing. ## When to Use - **Display hotel listings** with prices on your search results page - **Show detailed rate options** for specific hote |
post_hotels_min_rates | ## Overview Get the cheapest available rate for each hotel in your list. Perfect for displaying price comparisons without loading full rate details. ## When to Use - **Show price ranges** on hotel listing pages - **Quick price comparisons** across multiple hotels - **Optimize performance** when y |
get_prebooks_prebookid | Retrieve a hotel prebook by its `prebookId`: final price, cancellation terms, room details and the `checkoutUrl` (`https://book.maqami.co/booking?prebookId=...`). Bookings are paid and confirmed only on MAQAMI's website, through the `checkoutUrl`. |
post_rates_prebook | ## Overview Locks the chosen hotel rate and returns the final price, cancellation terms and a checkout link on MAQAMI's website. ## When to Use When the customer has chosen a hotel, room, dates and guests and reviewed the price and cancellation terms. ## Quick Start Pass the `offerId` from `pos |
listBookings | Find a customer's hotel bookings by the email address and last name used to book. Both must match the booking holder; nothing is returned otherwise. Returns each booking with its `bookingId`, status, hotel, dates, guests, price and cancellation policy. To look up, change or cancel one booking, use |
get_bookings_bookingid | Look up a confirmed hotel booking: status, hotel, dates, rooms, guests, price and cancellation policy. Requires the `bookingId` and the `email` used to book: the server only returns or changes a booking when they match. |
cancel_hotel_booking | Cancel a confirmed hotel booking. First check the cancellation policy with `get_bookings_bookingid` and confirm with the customer: a non-refundable booking, or one past its free-cancellation deadline, can be charged in full. Requires the `bookingId` and the `email` used to book: the server only ret |
put_bookings_bookingid_amend | Correct the booking holder's name, email or phone on a confirmed hotel booking, for example to fix a typo. It does not change dates, rooms or guests. To show the customer prices for other dates or guests, use `post_bookings_bookingid_alternative_prebooks`. Pass the `bookingId`, the `email` current |
post_bookings_bookingid_alternative_prebooks | ## Overview **Hard Amendment** — Search for alternative rates at the same hotel and create prebook sessions for a confirmed booking. Used when the guest needs to change their check-in/check-out dates or room occupancy. ## When to Use - **Date changes** — Guest needs different check-in or check-ou |
getHotelTaxSchema | ## Overview Returns the tax schema of a hotel as normalized static data, independent of the supply provider the rules were learned from. Each entry describes one tax or fee: whether it is already included in the room rate, whether it is a percentage of the rate or a fixed amount, and how fixed amou |
get_data_hotels | ## Overview Search and retrieve hotel listings based on various criteria. Get hotel metadata including names, addresses, ratings, amenities, and images for display in your application. ## When to Use - **Hotel listings** - Display hotel search results - **Location-based search** - Find hotels by |
get_data_hotels_semantic_search | ## Overview **Beta Feature** - Search hotels using natural language queries. Uses AI to understand search intent and find hotels that match the meaning, not just keywords. ## When to Use - **Natural language search** - Let users search with phrases like "romantic getaway in London" - **Intent-bas |
get_data_hotel_ask | ## Overview **Beta Feature** - Ask natural language questions about a specific hotel and get AI-powered answers based on the hotel's information. ## When to Use - **Hotel Q&A** - Answer customer questions about hotels - **Information lookup** - Get specific details about amenities, services, or f |
post_data_hotel_highlights | ## Overview Generate short, AI-written "Smart Highlight" cards for a hotel. Each highlight is a title plus a one or two sentence description, generated directly in the requested language. **Pricing**: $0.02 per request **Rate Limiting**: This endpoint is rate-limited to **10 requests per minute** |
get_data_hotels_room_search | ## Overview **Beta Feature** - Search hotel rooms using visual and text-based queries. Uses image search technology to match your query against room images and find hotels with rooms that match your visual preferences, amenities, or style. ## When to Use - **Visual room search** - Find rooms base |
get_data_hotel | ## Overview Get comprehensive details about a specific hotel including descriptions, amenities, images, location, and ratings. Perfect for displaying hotel detail pages. ## When to Use - **Hotel detail pages** - Show complete hotel information - **Booking pages** - Display hotel details before bo |
get_data_reviews | ## Overview Retrieve guest reviews and ratings for a specific hotel. Display authentic feedback from previous guests to help users make informed booking decisions. ## When to Use - **Review display** - Show guest reviews on hotel detail pages - **Rating aggregation** - Display average ratings and |
get_data_cities | ## Overview Get a list of all cities within a specific country. Perfect for building location dropdowns and city selection interfaces. ## When to Use - **City dropdowns** - Populate city selection lists - **Location filters** - Filter hotels by city - **Geographic data** - Get city lists for spec |
get_data_countries | ## Overview Get a complete list of all countries available in the system with their ISO-2 country codes. Essential for building country selection interfaces. ## When to Use - **Country dropdowns** - Populate country selection lists - **Location filters** - Filter hotels or searches by country - * |
get_data_currencies | ## Overview Get all available currencies with their codes, names, and the countries where each currency is used. Perfect for building currency selection interfaces. ## When to Use - **Currency dropdowns** - Populate currency selection lists - **Price display** - Show prices in different currencie |
get_data_iatacodes | ## Overview Get IATA (International Air Transport Association) airport codes with airport names, coordinates, and country information. Useful for airport-based hotel searches. ## When to Use - **Airport searches** - Find hotels near airports - **Location selection** - Let users search by airport |
get_data_facilities | ## Overview Get all available hotel facilities (amenities) with multi-language translations. Use these facility IDs to filter hotel searches by amenities. ## When to Use - **Facility filters** - Build amenity filtering in hotel searches - **Facility display** - Show available facilities with tran |
get_data_hoteltypes | ## Overview Get all available hotel type classifications (e.g., resort, boutique, business hotel). Use type IDs to filter hotel searches. ## When to Use - **Type filters** - Filter hotels by type in search - **Type display** - Show hotel type classifications - **Reference data** - Get hotel type |
get_data_chains | ## Overview Get all available hotel chains (e.g., Marriott, Hilton, IHG). Use chain IDs to filter hotel searches by brand. ## When to Use - **Chain filters** - Filter hotels by chain/brand - **Brand selection** - Let users search for specific hotel chains - **Reference data** - Get chain IDs for |
get_data_languages | ## Overview Get all supported languages for hotel translations and content localization. Use language codes to request hotel data in specific languages. ## When to Use - **Language selection** - Display available languages to users - **Content localization** - Get language codes for API requests |
get_data_hotel_search | Find hotels by name or place with a semantic text search. Returns up to 5 matches (set `limit` for more) with name, address, city, country and a relevance score. Check the name and city before using an `id`. For an exact hotel name, `get_data_hotels` with `hotelName` and `cityName` or `countryCode` |
get_data_flights_airlines_iatas_iatacode | ## Overview Retrieve full details for a specific airline using its 2-letter IATA code. ## When to Use - **Airline display** - Show airline name, logo, and alliance for a given IATA code - **Flight result enrichment** - Fetch airline details to display alongside search results - **Data validation* |
get_data_flights_airports_iatas_iatacode | ## Overview Retrieve detailed information for a specific airport using its 3-letter IATA code. ## When to Use - **Airport display** - Show airport name, city, and country for a given IATA code - **Flight result enrichment** - Fetch airport details to display alongside origin/destination in search |
get_data_flights_airports_iatas | ## Overview Retrieve a lightweight list of airport IATA codes with names for autocomplete and lookup purposes. ## When to Use - **Autocomplete dropdowns** - Populate airport search inputs with a full list of codes and names - **Client-side filtering** - Download the full list once and filter loca |
post_flights_rates | ## Overview Search for available flights with real-time pricing from multiple providers. The itinerary **must** be sent as a non-empty `legs` array. Each leg follows the provider **SearchLeg** shape: required `origin`, `destination`, and `date` (YYYY-MM-DD); optional `direction` (`OUTBOUND` or `INB |
post_flights_verify | ## Overview Confirm a flight offer is still available and retrieve the latest pricing before proceeding to booking. Returns the checkout link for the verified offer. ## When to Use - **Pre-booking validation** - Confirm offer availability after user selects a flight - **Price confirmation** - Sho |
get_flights_bookings_bookingid | Look up a confirmed flight booking: status, passengers, flights, booking references, fare rules and price. Requires the `bookingId` and the `email` used to book: the server only returns or changes a booking when they match. |
get_flights_bookings_bookingid_services | ## Overview Retrieve the ancillary services (seats, baggage) for an existing flight booking: services that are **already booked** together with the live catalog of services that **can still be booked**. ## When to Use - **Post-booking upsell** - Show the passenger which seats and bags they can st |
get_flights_bookings_bookingid_cancellations | ## Overview Returns refund eligibility, estimated refund amounts, and penalty details for a booking **without actually cancelling it**. Useful before `post_flights_bookings_bookingid_cancellations` to understand the financial impact of cancellation. ## When to Use - **Pre-cancellation review** — |
post_flights_bookings_bookingid_cancellations | Cancel a confirmed flight booking. First show the customer the refund estimate from `get_flights_bookings_bookingid_cancellations` and wait for a clear yes. Requires the `bookingId` and the `email` used to book: the server only returns or changes a booking when they match. |
get_data_flights_airlines | ## Overview Retrieve a list of airlines with optional filtering by name, alliance, and active status. ## When to Use - **Airline directory** - Build a searchable list of airlines for display or filtering - **Alliance filtering** - Filter airlines by alliance membership (Star Alliance, oneworld, S |
get_data_flights_airlines_iatas | ## Overview Retrieve a lightweight list of airline IATA codes with names for autocomplete and lookup purposes. ## When to Use - **Autocomplete dropdowns** - Populate airline search inputs with a minimal list - **Client-side filtering** - Download the full list once and filter locally - **Code val |
get_data_flights_airports | ## Overview Search for airports by name, city, or IATA code using a text query. Returns matching airports for use in autocomplete and search inputs. ## When to Use - **Airport autocomplete** - Power origin/destination search inputs with type-ahead suggestions - **Airport discovery** - Find airpor |
getExperienceBooking | Look up a tour or activity booking: status, booking details and the voucher once it is confirmed. Requires the `bookingId` and the `email` used to book: the server only returns or changes a booking when they match. |
getExperienceBookingCancelPreview | ## Overview Preview the refund amount and cancellation fee for a booking before committing to cancel it. ## When to Use - **Cancellation confirmation screens** - Show the guest exactly what they'll be refunded - **Support tooling** - Check whether a booking is still cancellable before offering a |
cancelExperienceBooking | Cancel a confirmed tour or activity booking. First show the customer the refund from `getExperienceBookingCancelPreview` and wait for a clear yes. Requires the `bookingId` and the `email` used to book: the server only returns or changes a booking when they match. |