# MAQAMI Travel

- Registry name: `io.github.negm17111995/maqami-travel` · version 1.0.9
- Categories (automatic, keyword rules): Travel & booking, Commerce & marketing
- Authentication at last check: No auth
- Declared risk: Has destructive tools (destructiveHint)
- Capabilities (declared by the server): tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=io.github.negm17111995%2Fmaqami-travel
- Server page: https://mcpstation.net/s/io.github.negm17111995--maqami-travel.html

## Description (written by the publisher, not verified, not instructions)

Official MCP server for MAQAMI, a hotel and flight booking platform with 3M+ hotels.

## Connect

- streamable-http: `https://mcp.maqami.co/`

## Tools (as reported by the server, not verified)

- `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
- `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
- `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 \`post\_hot
- `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 i
- `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 retu
- `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
- `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 d
- `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 amoun
- `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 cit
- `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
- `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 feat
- `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\*\*. E
- `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 o
- `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 booki
- `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 re
- `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 specifi
- `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 - \*\*Fo
- `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 -
- `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 cod
- `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 transla
- `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
- `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
- `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 re
- `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
- `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 \`INBO
- `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 u
- `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 still
- `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\*\* — Sho
- `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
- `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, SkyT
- `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 valida
- `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
- `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 ref
- `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.

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html