MAQAMI Travel
Official MCP server for MAQAMI, a hotel and flight booking platform with 3M+ hotels.
| Endpoint | https://mcp.maqami.co (streamable-http) |
|---|---|
| Registry version | 1.0.9 |
| Now | 35 tools · grade F (41) · pin ts_0c979b52ddf275c83b0b7ef4da60585e · protocol 2025-06-18 |
| First / last listed | 2026-11-15 00:59 UTC / 2026-11-15 00:59 UTC |
| Grade over time | 2026-11-15: F (41), 35 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: get_prebooks_prebookid post_rates_prebook get_bookings_bookingid cancel_hotel_booking put_bookings_bookingid_amend post_bookings_bookingid_alternative_prebooks get_data_flights_airlines_iatas_iatacode get_data_flights_airports_iatas_iatacode get_data_flights_airports_iatas post_flights_rates post_flights_verify get_flights_bookings_bookingid get_flights_bookings_bookingid_services get_flights_bookings_bookingid_cancellations post_flights_bookings_bookingid_cancellations get_data_flights_airlines get_data_flights_airlines_iatas get_data_flights_airports post_hotels_rates post_hotels_min_rates get_data_hotels get_data_hotels_semantic_search get_data_hotel_ask get_data_hotels_room_search get_data_hotel get_data_reviews get_data_cities get_data_countries get_data_currencies get_data_iatacodes get_data_facilities get_data_hoteltypes get_data_chains get_data_languages get_data_hotel_search
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`. params: prebookId* |
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 `post_hotels_rates` exactly as it was returned.
## What You Get
- **prebookId** - The locked rate
- ** params: timeout, offerId*, voucherCode, bedTypeIds |
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. params: bookingId*, email*, lastName |
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 returns or changes a booking when they match. params: bookingId*, email*, lastName |
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` currently on the booking and the corrected `holder` (`firstName`, `lastName`, `email`, optional `phone`). C params: bookingId*, email*, lastName, holder*, remarks |
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-out dates
- **Occupancy changes** — Guest needs a different number of adults or children
- **Hard amen params: bookingId*, email*, lastName, occupancies*, checkin, checkout, refundableRatesOnly, boardType, maxPrebooks |
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** - Verify an airline code and retrieve its metadata
## What You Get
- **Airline details** includi params: iataCode* |
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 results
- **Autocomplete validation** - Verify an airport code and retrieve its full details
## Wh params: iataCode* |
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 locally
- **Code validation** - Build a lookup table of valid airport codes
## What You Get
- **IATA c params: q* |
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 `INBOUND`); optional per-leg `filters` that override global `filters` for that leg only.
**Not supporte params: legs*, adults*, children, infants, childrenAges, infantAges, cabinClass, currency*, country, filters, sort, sessionId |
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** - Show users the guaranteed price
- **Fare rule retrieval** - Get the latest cancellation and change poli params: offerId*, sessionId |
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. params: bookingId*, email*, lastName |
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 still add after the booking was created
- **Booking management** - Display the services already attach params: bookingId*, email*, lastName, forceRefresh, includeServicesHistory |
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** — Show the customer the potential maximum refund (not guaranteed) before they confirm cancellation
- * params: bookingId*, email*, lastName |
post_flights_bookings_bookingid_cancellations | Flight bookings are cancelled on MAQAMI's website, not in this chat. When a customer wants to cancel a flight, give them https://book.maqami.co/manage-bookings and tell them to continue from there: choose "Flight reservations", enter the last name and the booking ID, then follow the steps to see the refund and cancel. Calling this tool returns the same link and steps. params: bookingId |
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, SkyTeam)
- **Active airlines** - Retrieve only currently operating airlines
## What You Get
- **Ful params: q, limit, activeOnly, alliance |
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 validation** - Build a lookup table of valid airline codes
## What You Get
- **IATA codes** for all a params: activeOnly |
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 airports in a city or region by name
- **Search validation** - Look up airports before constructing a flig params: q* |
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 hotels users are viewing
- **Support multi-room bookings** for families or groups
- **Filter hotels** by params: hotelIds, occupancies*, currency*, guestNationality*, checkin*, checkout*, timeout, maxRatesPerHotel, boardType, refundableRatesOnly, roomAmenities, roomAmenitiesFilter, amenityFilterLogic, bedTypes, sort, roomMapping, hotelName, countryCode, cityName, latitude, longitude, radius, iataCode, limit, offset, aiSearch, minReviewsCount, minRating, zip, placeId, starRating, hotelTypeIds, chainIds, facilities, strictFacilityFiltering, stream, advancedAccessibilityOnly, feed, includeHotelData, sessionId |
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 you only need the lowest price, not all rate options
- **Build price filters** or sorting by price
# params: hotelIds*, occupancies*, checkin*, checkout*, currency*, guestNationality*, timeout |
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 city, coordinates, or Place ID
- **Hotel discovery** - Browse hotels in specific areas
- **Metadata params: countryCode, cityName, hotelName, offset, limit, lastUpdatedAt, longitude, latitude, radius, aiSearch, timeout, zip, minRating, minReviewsCount, facilityIds, hotelTypeIds, chainIds, strictFacilitiesFiltering, starRating, placeId, language, hotelIds, advancedAccessibilityOnly |
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-based matching** - Find hotels matching the vibe or style, not just location
- **Conversational search* params: query*, limit, min_rating |
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 features
- **Conversational interfaces** - Build chat interfaces for hotel information
- **Detailed i params: hotelId*, query*, allowWebSearch |
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 based on visual characteristics like "luxury modernist comfort" or "blue accessible bathroom"
- **Style- params: query*, limit, placeId, latitude, longitude, radius, city, country |
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 booking
- **Hotel profiles** - Build rich hotel information pages
- **Content display** - Show descrip params: hotelId*, timeout, language, advancedAccessibilityOnly |
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 review counts
- **Trust building** - Show authentic guest feedback
- **Decision support** - Help us params: hotelId*, limit, offset, timeout, getSentiment, language |
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 specific countries
- **Form autocomplete** - Build city autocomplete features
## What You Get
- **City params: countryCode*, timeout |
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
- **Form inputs** - Build country selection forms
- **Reference data** - Get country codes for use in o params: timeout |
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 currencies
- **Currency conversion** - Get currency information for conversion
- **Reference data** - Get cur params: timeout |
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 codes
- **Geographic data** - Get airport locations and coordinates
- **Reference data** - Get IATA params: timeout |
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 translated names
- **Multi-language support** - Display facilities in user's language
- **Reference data params: none |
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 IDs for filtering
## What You Get
- **Hotel type list** - All available hotel types
- **Type IDs** params: none |
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 use in search filters
## What You Get
- **Chain list** - All available hotel chains
- **Chain IDs* params: none |
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
- **Multi-language support** - Build language switchers in your application
- **Reference data** - V params: none |
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` is more precise. params: query*, limit |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.