{"id":"io.github.negm17111995/maqami-travel","slug":"io-github-negm17111995-maqami-travel","title":"MAQAMI Travel","description":"Official MCP server for MAQAMI, a hotel and flight booking platform with 3M+ hotels.","version":"1.0.9","publisher":{"kind":"github","id":"negm17111995","label":"@negm17111995 on GitHub","url":"https://github.com/negm17111995"},"website":"https://mcp.maqami.co/","repository":"https://github.com/negm17111995/mcp-server","remotes":[{"type":"streamable-http","url":"https://mcp.maqami.co/"}],"packages":[{"registryType":"npm","registryBaseUrl":"https://registry.npmjs.org","identifier":"maqami-travel","version":"1.0.9","transport":{"type":"stdio"}}],"published":"2026-10-07","updated":"2026-10-07","status":"online","auth":"","latency_ms":1375,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"get_prebooks_prebookid","title":"Get locked hotel rate","description":"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`.","read_only":true},{"name":"post_rates_prebook","title":"Lock hotel rate and get checkout link","description":"## Overview\n\nLocks the chosen hotel rate and returns the final price, cancellation terms and a checkout link on MAQAMI's website.\n\n## When to Use\n\nWhen the customer has chosen a hotel, room, dates and guests and reviewed the price and cancellation terms.\n\n## Quick Start\n\nPass the `offerId` from `post_hotels_rates` exactly as it was returned.\n\n## What You Get\n\n- **prebookId** - The locked rate\n- **","read_only":false},{"name":"get_bookings_bookingid","title":"Get hotel booking","description":"Look up a confirmed hotel booking: status, hotel, dates, rooms, guests, price and cancellation policy.\n\nRequires the `bookingId` and the `email` used to book: the server only returns or changes a booking when they match.","read_only":true},{"name":"cancel_hotel_booking","title":"Cancel hotel booking","description":"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.\n\nRequires the `bookingId` and the `email` used to book: the server only returns or changes a booking when they match.","read_only":false},{"name":"put_bookings_bookingid_amend","title":"Amend hotel booking","description":"Correct the booking holder's name, email or phone on a confirmed hotel booking, for example to fix a typo.\n\nIt does not change dates, rooms or guests. To show the customer prices for other dates or guests, use `post_bookings_bookingid_alternative_prebooks`.\n\nPass the `bookingId`, the `email` currently on the booking and the corrected `holder` (`firstName`, `lastName`, `email`, optional `phone`). C","read_only":false},{"name":"post_bookings_bookingid_alternative_prebooks","title":"Find alternative hotel rates","description":"## Overview\n\n**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.\n\n## When to Use\n\n- **Date changes** — Guest needs different check-in or check-out dates\n- **Occupancy changes** — Guest needs a different number of adults or children\n- **Hard amen","read_only":false},{"name":"get_data_flights_airlines_iatas_iatacode","title":"Get airline by IATA code","description":"## Overview\n\nRetrieve full details for a specific airline using its 2-letter IATA code.\n\n## When to Use\n\n- **Airline display** - Show airline name, logo, and alliance for a given IATA code\n- **Flight result enrichment** - Fetch airline details to display alongside search results\n- **Data validation** - Verify an airline code and retrieve its metadata\n\n## What You Get\n\n- **Airline details** includi","read_only":true},{"name":"get_data_flights_airports_iatas_iatacode","title":"Get airport by IATA code","description":"## Overview\n\nRetrieve detailed information for a specific airport using its 3-letter IATA code.\n\n## When to Use\n\n- **Airport display** - Show airport name, city, and country for a given IATA code\n- **Flight result enrichment** - Fetch airport details to display alongside origin/destination in search results\n- **Autocomplete validation** - Verify an airport code and retrieve its full details\n\n## Wh","read_only":true},{"name":"get_data_flights_airports_iatas","title":"List airport IATA codes","description":"## Overview\n\nRetrieve a lightweight list of airport IATA codes with names for autocomplete and lookup purposes.\n\n## When to Use\n\n- **Autocomplete dropdowns** - Populate airport search inputs with a full list of codes and names\n- **Client-side filtering** - Download the full list once and filter locally\n- **Code validation** - Build a lookup table of valid airport codes\n\n## What You Get\n\n- **IATA c","read_only":true},{"name":"post_flights_rates","title":"Search flights","description":"## Overview\n\nSearch 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.\n\n**Not supporte","read_only":true},{"name":"post_flights_verify","title":"Confirm flight price and get checkout link","description":"## Overview\n\nConfirm a flight offer is still available and retrieve the latest pricing before proceeding to booking. Returns the checkout link for the verified offer.\n\n## When to Use\n\n- **Pre-booking validation** - Confirm offer availability after user selects a flight\n- **Price confirmation** - Show users the guaranteed price\n- **Fare rule retrieval** - Get the latest cancellation and change poli","read_only":true},{"name":"get_flights_bookings_bookingid","title":"Get flight booking","description":"Look up a confirmed flight booking: status, passengers, flights, booking references, fare rules and price.\n\nRequires the `bookingId` and the `email` used to book: the server only returns or changes a booking when they match.","read_only":true},{"name":"get_flights_bookings_bookingid_services","title":"Get flight booking extras","description":"## Overview\n\nRetrieve 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**.\n\n## When to Use\n\n- **Post-booking upsell** - Show the passenger which seats and bags they can still add after the booking was created\n- **Booking management** - Display the services already attach","read_only":true},{"name":"get_flights_bookings_bookingid_cancellations","title":"Get flight cancellation status","description":"## Overview\n\nReturns 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.\n\n## When to Use\n\n- **Pre-cancellation review** — Show the customer the potential maximum refund (not guaranteed) before they confirm cancellation\n- *","read_only":true},{"name":"post_flights_bookings_bookingid_cancellations","title":"Get flight cancellation link","description":"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.","read_only":true},{"name":"get_data_flights_airlines","title":"List airlines","description":"## Overview\n\nRetrieve a list of airlines with optional filtering by name, alliance, and active status.\n\n## When to Use\n\n- **Airline directory** - Build a searchable list of airlines for display or filtering\n- **Alliance filtering** - Filter airlines by alliance membership (Star Alliance, oneworld, SkyTeam)\n- **Active airlines** - Retrieve only currently operating airlines\n\n## What You Get\n\n- **Ful","read_only":true},{"name":"get_data_flights_airlines_iatas","title":"List airline IATA codes","description":"## Overview\n\nRetrieve a lightweight list of airline IATA codes with names for autocomplete and lookup purposes.\n\n## When to Use\n\n- **Autocomplete dropdowns** - Populate airline search inputs with a minimal list\n- **Client-side filtering** - Download the full list once and filter locally\n- **Code validation** - Build a lookup table of valid airline codes\n\n## What You Get\n\n- **IATA codes** for all a","read_only":true},{"name":"get_data_flights_airports","title":"List airports","description":"## Overview\n\nSearch for airports by name, city, or IATA code using a text query. Returns matching airports for use in autocomplete and search inputs.\n\n## When to Use\n\n- **Airport autocomplete** - Power origin/destination search inputs with type-ahead suggestions\n- **Airport discovery** - Find airports in a city or region by name\n- **Search validation** - Look up airports before constructing a flig","read_only":true},{"name":"post_hotels_rates","title":"Search hotel rates","description":"## Overview\n\nSearch for hotel rates and availability across multiple hotels. This is your primary endpoint for finding bookable hotel rooms with real-time pricing.\n\n## When to Use\n\n- **Display hotel listings** with prices on your search results page\n- **Show detailed rate options** for specific hotels users are viewing\n- **Support multi-room bookings** for families or groups\n- **Filter hotels** by","read_only":true},{"name":"post_hotels_min_rates","title":"Get lowest hotel prices","description":"## Overview\n\nGet the cheapest available rate for each hotel in your list. Perfect for displaying price comparisons without loading full rate details.\n\n## When to Use\n\n- **Show price ranges** on hotel listing pages\n- **Quick price comparisons** across multiple hotels\n- **Optimize performance** when you only need the lowest price, not all rate options\n- **Build price filters** or sorting by price\n\n#","read_only":true},{"name":"get_data_hotels","title":"List hotels","description":"## Overview\n\nSearch and retrieve hotel listings based on various criteria. Get hotel metadata including names, addresses, ratings, amenities, and images for display in your application.\n\n## When to Use\n\n- **Hotel listings** - Display hotel search results\n- **Location-based search** - Find hotels by city, coordinates, or Place ID\n- **Hotel discovery** - Browse hotels in specific areas\n- **Metadata ","read_only":true},{"name":"get_data_hotels_semantic_search","title":"Search hotels by description","description":"## Overview\n\n**Beta Feature** - Search hotels using natural language queries. Uses AI to understand search intent and find hotels that match the meaning, not just keywords.\n\n## When to Use\n\n- **Natural language search** - Let users search with phrases like \"romantic getaway in London\"\n- **Intent-based matching** - Find hotels matching the vibe or style, not just location\n- **Conversational search*","read_only":true},{"name":"get_data_hotel_ask","title":"Ask about a hotel","description":"## Overview\n\n**Beta Feature** - Ask natural language questions about a specific hotel and get AI-powered answers based on the hotel's information.\n\n## When to Use\n\n- **Hotel Q&A** - Answer customer questions about hotels\n- **Information lookup** - Get specific details about amenities, services, or features\n- **Conversational interfaces** - Build chat interfaces for hotel information\n- **Detailed i","read_only":true},{"name":"get_data_hotels_room_search","title":"Search hotel rooms by style","description":"## Overview\n\n**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.\n\n## When to Use\n\n- **Visual room search** - Find rooms based on visual characteristics like \"luxury modernist comfort\" or \"blue accessible bathroom\"\n- **Style-","read_only":true},{"name":"get_data_hotel","title":"Get hotel details","description":"## Overview\n\nGet comprehensive details about a specific hotel including descriptions, amenities, images, location, and ratings. Perfect for displaying hotel detail pages.\n\n## When to Use\n\n- **Hotel detail pages** - Show complete hotel information\n- **Booking pages** - Display hotel details before booking\n- **Hotel profiles** - Build rich hotel information pages\n- **Content display** - Show descrip","read_only":true},{"name":"get_data_reviews","title":"Get hotel reviews","description":"## Overview\n\nRetrieve guest reviews and ratings for a specific hotel. Display authentic feedback from previous guests to help users make informed booking decisions.\n\n## When to Use\n\n- **Review display** - Show guest reviews on hotel detail pages\n- **Rating aggregation** - Display average ratings and review counts\n- **Trust building** - Show authentic guest feedback\n- **Decision support** - Help us","read_only":true},{"name":"get_data_cities","title":"List cities","description":"## Overview\n\nGet a list of all cities within a specific country. Perfect for building location dropdowns and city selection interfaces.\n\n## When to Use\n\n- **City dropdowns** - Populate city selection lists\n- **Location filters** - Filter hotels by city\n- **Geographic data** - Get city lists for specific countries\n- **Form autocomplete** - Build city autocomplete features\n\n## What You Get\n\n- **City","read_only":true},{"name":"get_data_countries","title":"List countries","description":"## Overview\n\nGet a complete list of all countries available in the system with their ISO-2 country codes. Essential for building country selection interfaces.\n\n## When to Use\n\n- **Country dropdowns** - Populate country selection lists\n- **Location filters** - Filter hotels or searches by country\n- **Form inputs** - Build country selection forms\n- **Reference data** - Get country codes for use in o","read_only":true},{"name":"get_data_currencies","title":"List currencies","description":"## Overview\n\nGet all available currencies with their codes, names, and the countries where each currency is used. Perfect for building currency selection interfaces.\n\n## When to Use\n\n- **Currency dropdowns** - Populate currency selection lists\n- **Price display** - Show prices in different currencies\n- **Currency conversion** - Get currency information for conversion\n- **Reference data** - Get cur","read_only":true},{"name":"get_data_iatacodes","title":"List IATA codes","description":"## Overview\n\nGet IATA (International Air Transport Association) airport codes with airport names, coordinates, and country information. Useful for airport-based hotel searches.\n\n## When to Use\n\n- **Airport searches** - Find hotels near airports\n- **Location selection** - Let users search by airport codes\n- **Geographic data** - Get airport locations and coordinates\n- **Reference data** - Get IATA ","read_only":true},{"name":"get_data_facilities","title":"List hotel facilities","description":"## Overview\n\nGet all available hotel facilities (amenities) with multi-language translations. Use these facility IDs to filter hotel searches by amenities.\n\n## When to Use\n\n- **Facility filters** - Build amenity filtering in hotel searches\n- **Facility display** - Show available facilities with translated names\n- **Multi-language support** - Display facilities in user's language\n- **Reference data","read_only":true},{"name":"get_data_hoteltypes","title":"List hotel types","description":"## Overview\n\nGet all available hotel type classifications (e.g., resort, boutique, business hotel). Use type IDs to filter hotel searches.\n\n## When to Use\n\n- **Type filters** - Filter hotels by type in search\n- **Type display** - Show hotel type classifications\n- **Reference data** - Get hotel type IDs for filtering\n\n## What You Get\n\n- **Hotel type list** - All available hotel types\n- **Type IDs**","read_only":true},{"name":"get_data_chains","title":"List hotel chains","description":"## Overview\n\nGet all available hotel chains (e.g., Marriott, Hilton, IHG). Use chain IDs to filter hotel searches by brand.\n\n## When to Use\n\n- **Chain filters** - Filter hotels by chain/brand\n- **Brand selection** - Let users search for specific hotel chains\n- **Reference data** - Get chain IDs for use in search filters\n\n## What You Get\n\n- **Chain list** - All available hotel chains\n- **Chain IDs*","read_only":true},{"name":"get_data_languages","title":"List languages","description":"## Overview\n\nGet all supported languages for hotel translations and content localization. Use language codes to request hotel data in specific languages.\n\n## When to Use\n\n- **Language selection** - Display available languages to users\n- **Content localization** - Get language codes for API requests\n- **Multi-language support** - Build language switchers in your application\n- **Reference data** - V","read_only":true},{"name":"get_data_hotel_search","title":"Find hotels by name or place","description":"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.","read_only":true}],"server_info":{"name":"MAQAMI Travel MCP Server","version":"1.0.9","title":"MAQAMI Travel","websiteUrl":"https://maqami.co","icons":[{"src":"https://maqami.co/android-chrome-512x512.png","mimeType":"image/png","sizes":["512x512"]},{"src":"https://maqami.co/android-chrome-192x192.png","mimeType":"image/png","sizes":["192x192"]}]},"category":"travel","tags":["web-search","memory"],"kind":"remote","source":"registry","submitted":{},"first_party":false,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-07-02","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/io-github-negm17111995-maqami-travel/"}