MCP server

MAQAMI Travel

io.github.negm17111995/maqami-travel

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

Website Source

At a glance

Type

MCP server

Publisher

Not verified

Status

Working at last check

Tools

41

Token cost

About 22,596 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http maqami-travel https://mcp.maqami.co/

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.maqami-travel]
url = "https://mcp.maqami.co/"

Gemini CLI

{"mcpServers":{"maqami-travel":{"httpUrl":"https://mcp.maqami.co/"}}}

Cursor

{"mcpServers":{"maqami-travel":{"url":"https://mcp.maqami.co/"}}}

VS Code

{"servers":{"maqami-travel":{"type":"http","url":"https://mcp.maqami.co/"}}}

Antigravity

agy mcp add maqami-travel https://mcp.maqami.co/

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"maqami-travel","server_url":"https://mcp.maqami.co/","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"maqami-travel","server_url":"https://mcp.maqami.co/"}

Tools

• cancelExperienceBooking ~247 tokens
  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.
• cancel_hotel_booking ~263 tokens
  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
• getExperienceBooking ~232 tokens
  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 ~402 tokens
  ## 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
• getHotelTaxSchema ~402 tokens
  ## 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_bookings_bookingid ~231 tokens
  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.
• get_data_chains ~218 tokens
  ## 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_cities ~314 tokens
  ## 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 ~270 tokens
  ## 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 ~303 tokens
  ## 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_facilities ~288 tokens
  ## 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_flights_airlines ~404 tokens
  ## 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 ~274 tokens
  ## 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_airlines_iatas_iatacode ~308 tokens
  ## 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 ~332 tokens
  ## 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
• get_data_flights_airports_iatas ~270 tokens
  ## 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
• get_data_flights_airports_iatas_iatacode ~305 tokens
  ## 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_hotel ~433 tokens
  ## 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_hotel_ask ~516 tokens
  ## 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
• get_data_hotel_search ~210 tokens
  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_hotels ~1245 tokens
  ## 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_room_search ~1101 tokens
  ## 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_hotels_semantic_search ~512 tokens
  ## 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_hoteltypes ~219 tokens
  ## 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_iatacodes ~303 tokens
  ## 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_languages ~276 tokens
  ## 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_reviews ~538 tokens
  ## 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_flights_bookings_bookingid ~231 tokens
  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_cancellations ~748 tokens
  ## 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** —
• get_flights_bookings_bookingid_services ~706 tokens
  ## 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_prebooks_prebookid ~159 tokens
  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`.
• listBookings ~209 tokens
  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
• post_bookings_bookingid_alternative_prebooks ~1146 tokens
  ## 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
• post_data_hotel_highlights ~1045 tokens
  ## 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**
• post_flights_bookings_bookingid_cancellations ~179 tokens
  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
• post_flights_rates ~2369 tokens
  ## 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 ~581 tokens
  ## 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
• post_hotels_min_rates ~601 tokens
  ## 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
• post_hotels_rates ~3251 tokens
  ## 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_rates_prebook ~455 tokens
  ## 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
• put_bookings_bookingid_amend ~500 tokens
  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

Browse

• GitHub tools
• Web search
• Website monitoring
• Email
• Booking and scheduling

Related MCP servers

• FareEagle Travel
  Flights, hotels, buses and holiday packages in India at live fares, plus visa help; pay on fareeagle
• BreckenWander Travel
  Search flights, hotels & experiences at all-in prices, then build a trip on breckenwander.com.
• Mubboo Flights Search
  Mubboo Flights: all-in-one travel comparison and tickets platform. MCP tools for flight search.
• VoyageHacks
  Multilingual travel guides, gear picks and booking links for AI travel agents.
• Intentlink
  The best agent monetization tool: free search, clear rev-share, 10M+ commerce/travel/local offers.
• Gondola Award Travel Search
  Compare cash vs points on hotels, flights, and cars. Checkout supported hotels and rental cars.
• MBD Travel
  Read-only MBD Travel catalogue: tours, hotel prices, private transfers and the Dubai visa.
• Autonomad Travel
  AI travel agent — book flights, hotels, activities, and events worldwide via autonomad.ai.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.negm17111995/maqami-travel.svg)](https://aptlynx.net/servers/io.github.negm17111995/maqami-travel)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents