Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words Sign in

MAQAMI Travel

by negm17111995version 1.0.9i★ 2iComputer or cloudOfficial site ↗
Registry nameio.github.negm17111995/maqami-travel

How to install

What it does

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

  • Connects Computer or cloud
  • Account or key No key needed
  • Category Travel, maps & weather

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity6/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness7/12Full marks for a release or code change within 30 days
Still answering8/8The cloud endpoint answered at the last check
Usage score21/100

Quality: Passed 5/5 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install MAQAMI Travel. Follow https://mcp.popnx.com/i/negm17111995-maqami-travel.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 5/5 checks · What you ask goes through the maker’s server (mcp.maqami.co) · ✓ Commands checked Nov 20, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude · about 2 min

No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it

  1. Open Claude’s Connectors page

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Click “Add” → “Custom” → “Web” and fill in these 2 fields

    Copy each value into the field with the same name in Claude, then click Continue

    Name · NameMAQAMI Travel
    Remote MCP server URL · Addresshttps://mcp.maqami.co/

    Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add

  3. Turn it on in a chat

    +ConnectorsMAQAMI Travel

  4. Try it

    Use MAQAMI Travel and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using MAQAMI Travel or shows a MAQAMI Travel tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with ChatGPT, depending on your plan

Full MCP: ChatGPT Business, Enterprise or Edu on the web · Pro: connects with read/fetch permissions, so tools that change data may not work · Plus: not confirmed in OpenAI’s docs; if you see an add-custom-MCP option on the Plugins page you can try these steps · web only

  1. Open ChatGPT’s add-MCP page on the web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Fill in the name and address

    Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin

    Name · NameMAQAMI Travel
    Connection · Addresshttps://mcp.maqami.co/
  3. Pick MAQAMI Travel in a chat

    Start a new chat and pick MAQAMI Travel from your plugins before typing

  4. Try it

    Use MAQAMI Travel and tell me what you can do for me, then show me one thing

    ✓ If ChatGPT says it is using MAQAMI Travel or shows a MAQAMI Travel tool in the answer, you are connected

Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Claude Code · about 2 min

No key, nothing to install

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  2. Paste this command and press Enter

    claude mcp add --transport http --scope user maqami-travel https://mcp.maqami.co/
  3. Type /mcp in Claude Code

    You should see MAQAMI Travel listed as connected

  4. Try it

    Use MAQAMI Travel and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using MAQAMI Travel or shows a MAQAMI Travel tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor · about 2 min

No key, nothing to install

  1. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  2. Open the AI chat in Cursor in Agent mode

  3. Try it

    Use MAQAMI Travel and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using MAQAMI Travel or shows a MAQAMI Travel tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code · about 2 min

No key, nothing to install

  1. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  2. Open the AI chat in VS Code in Agent mode

  3. Try it

    Use MAQAMI Travel and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using MAQAMI Travel or shows a MAQAMI Travel tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://mcp.maqami.co/

JSON settings are under “For developers” below

Stuck? Ask people who use MAQAMI Travel💬 Discussion →
For developers: Terminal commands and JSON settings

Over the web

Claude Code

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

Cursor (~/.cursor/mcp.json)

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

VS Code (mcp.json)

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

Installed on your computer

Claude Code

claude mcp add --scope user maqami-travel -- npx -y maqami-travel

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "maqami-travel": {
      "command": "npx",
      "args": [
        "-y",
        "maqami-travel"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "maqami-travel": {
      "command": "npx",
      "args": [
        "-y",
        "maqami-travel"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "maqami-travel": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "maqami-travel"
      ]
    }
  }
}

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
102/wk
Connection
Computer or cloud
Transport
stdio, streamable-http
Latest versioni
1.0.9
Published to registryi
Oct 7, 2026
Code last changedi
Oct 17, 2026
Last checked
Nov 19, 2026
Maker
negm17111995
Packages
npm: maqami-travel
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Tool names and descriptions exactly as the server reported them on Nov 19, 2026. The maker wrote them, not us; we show them as plain text.

  • 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 `off

  • 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:

  • 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`, t

  • 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 che

  • 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 - *

  • 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/dest

  • 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 onc

  • 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`

  • 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 con

  • 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

  • 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-cancell

  • 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

  • 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 Alli

  • 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 loc

  • 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 discover

  • 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**

  • 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 per

  • 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**

  • 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 Londo

  • 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 amenitie

  • 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**

  • 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

  • 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 av

  • 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 ci

  • 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 search

  • 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 di

  • 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 s

  • 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 fac

  • 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_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** - G

  • 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

  • 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 `cityNam

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 20, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account negm17111995, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 34 days ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • ✓ Pass

    Endpoint responds

    Responded in 745 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 35 tool descriptions and found no hidden instructions to the AI

The cloud address answered 5 of the last 5 checks · latest 745 ms · checked Nov 19, 2026

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for maqami-travel@1.0.9

Checks only this package version, not every dependency · checked Nov 15, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/negm17111995-maqami-travel.svg)](https://mcp.popnx.com/en/servers/negm17111995-maqami-travel)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Travel, maps & weatheri

  • More stars than 92% of the other 2032 servers in this category
  • Published to the registry more recently than 38% of the other 2032 servers in this category
  • Basic checks equal to or better than 99% of the other 2032 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is MAQAMI Travel safe?

It passed 5 of 5 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

Either way works: install it on your computer or connect to the cloud version.

Is it still maintained?

The GitHub repo last changed 34 days ago, and the latest version (1.0.9) reached the registry 44 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: Mu, Award Travel Finder, Killbottleneck, Gondola Award Travel Search, Whimsical

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Mu

News, web search, mail, markets, weather, places, files, calendar, contacts. 67 tools, one endpoint.

by microGrowing★ 441Updated 4 months ago

Runs in the cloud✓ micro.mu

Whimsical

Create and edit flowcharts, mind maps, wireframes, and docs in Whimsical, or search your workspace.

by WhimsicalCodeEarly★ 11Updated 2 months ago

Runs in the cloud✓ service owner · whimsical.com
Compared with similar ones
This one
MAQAMI Travel
MuAward Travel FinderKillbottleneckGondola Award Travel SearchWhimsical
Runs whereCloud or install on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyNoNoNoYesNoNo
Add with + in ClaudeNoNoNoNoNoYes
Basic checks5/54/43/33/34/44/4
LicenseMITAGPL-3.0MITMITMITMIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

MAQAMI Travel MCP Server

Official MCP server for MAQAMI, a hotel and flight booking platform with 3M+ hotels. Search live hotel rates and flights, look up cities, airports and hotel details, then send the customer a secure checkout link on book.maqami.co for the exact room or fare they chose. Remote Streamable HTTP endpoint, no API key required.

https://mcp.maqami.co/

Quick start

Pick your client. Each line is enough to connect; the full steps are under Connect.

ClientFastest way to connect
Claude Codeclaude mcp add --transport http maqami-travel https://mcp.maqami.co/
Claude Desktop (one click)Download maqami-travel.mcpb and open it (steps)
Any stdio client (npm)npx -y maqami-travel as the server command (config); Node.js 18+
claude.ai, Claude Desktop and Claude mobileCustomize → Connectors → Add custom connector, URL https://mcp.maqami.co/, No sign in. Works on the Free plan (steps)
CursorAdd to Cursor (one click), or add "maqami-travel": { "url": "https://mcp.maqami.co/" } to mcp.json
VS CodeInstall in VS Code (one click), or code --add-mcp '{"name":"maqami-travel","type":"http","url":"https://mcp.maqami.co/"}'
WindsurfAdd "maqami-travel": { "serverUrl": "https://mcp.maqami.co/" } to mcp_config.json
Gemini CLIgemini extensions install https://github.com/negm17111995/mcp-server
OpenAI Codexcodex mcp add maqami-travel --url https://mcp.maqami.co/
ChatGPTDeveloper mode → create an app with URL https://mcp.maqami.co/ and No Authentication (steps and plans)
OpenAI Agents SDKMCPServerStreamableHttp(name="MAQAMI Travel", params={"url": "https://mcp.maqami.co/"})
LangChainMCPAdapter("https://mcp.maqami.co/") from langchain.mcp (example)
n8nMCP Client Tool node, endpoint https://mcp.maqami.co/, HTTP Streamable, no authentication (steps)
ClineMCP Servers → Remote Servers, URL https://mcp.maqami.co/, Streamable HTTP
LM StudioAdd "maqami-travel": { "url": "https://mcp.maqami.co/" } to mcp.json, or use the install link
Booking skill only (Claude Code, Codex, Cursor and other skill-aware agents)npx skills add negm17111995/mcp-server
Any other clientStreamable HTTP at https://mcp.maqami.co/ with no auth, or npx -y maqami-travel for stdio-only clients

Then try: *"Find 4-star hotels in Lisbon for 2 adults, 12 to 15 May."*

Contents

  • Connect
  • How agents use the server
  • What you can do
  • Example prompts
  • FAQ
  • Examples
  • Privacy and security
  • Development

Connect

The server is hosted at https://mcp.maqami.co/ and uses the Streamable HTTP transport. There is nothing to install and no API key to configure.

Claude (claude.ai and Claude Desktop)

Add MAQAMI as a custom connector:

  1. Go to Customize → Connectors.
  2. Click + Add, then Add custom connector.
  3. Enter the name MAQAMI Travel and the URL https://mcp.maqami.co/, then click Continue.
  4. Under Authentication, choose No sign in, then click Add.

This works on every Claude plan, including Free. Free accounts can have one custom connector at a time.

On Team and Enterprise plans, an Owner adds the connector under Organization settings → Connectors first.

Claude Desktop extension

A one-click install for Claude Desktop on macOS, Windows and Linux. It doesn't use a custom connector slot, so it also suits Free accounts that already have one.

  1. Download maqami-travel.mcpb.
  2. Open the file, or drag it into Claude Desktop under Settings → Extensions.
  3. Click Install.

The extension runs the same stdio bridge as the npm package and connects to https://mcp.maqami.co/. Claude Desktop provides Node.js, so there is nothing else to install.

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

Or install the plugin, which adds the server and a booking skill that walks Claude through search, confirmation and the checkout link:

/plugin marketplace add negm17111995/mcp-server

/plugin install maqami-travel@maqami

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{

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

Or install with one click: Add to Cursor. The same install as a deeplink, to open in your browser:

cursor://anysphere.cursor-deeplink/mcp/install?name=maqami-travel&config=eyJ1cmwiOiJodHRwczovL21jcC5tYXFhbWkuY28vIn0=
VS Code

Add to .vscode/mcp.json in your workspace:

{

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

Or install in VS Code with one click, or add it to your user profile from the command line:

code --add-mcp '{"name":"maqami-travel","type":"http","url":"https://mcp.maqami.co/"}'
Cline

In the Cline panel, open MCP Servers → Remote Servers, enter the URL https://mcp.maqami.co/ and choose Streamable HTTP. Or add it to the MCP settings JSON:

{

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

LM Studio

LM Studio 0.3.17 and later can use MCP servers. Open the Program tab in the right-hand sidebar, choose Install → Edit mcp.json, and add:

{

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

Or install it by opening this link in your browser:

lmstudio://add_mcp?name=maqami-travel&config=eyJ1cmwiOiJodHRwczovL21jcC5tYXFhbWkuY28vIn0%3D

Local models have smaller context windows, so consider turning off the tools you don't need (see the FAQ).

Windsurf

Open mcp_config.json from the … menu in the Cascade panel (Open MCP config file) and add:

{

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

On current releases the file is at ~/.config/devin/mcp_config.json (macOS and Linux) or %APPDATA%\devin\mcp_config.json (Windows). Older releases use ~/.codeium/windsurf/mcp_config.json.

ChatGPT

Developer mode apps are available on the web for Plus, Pro, Business, Enterprise and Education accounts. On the Free plan, ChatGPT shows only apps published in its app directory.

  1. Open Settings → Security and login and turn on Developer mode.
  2. Open Plugins, select the + button and create a developer-mode app.
  3. Enter the name MAQAMI Travel and the URL https://mcp.maqami.co/, and choose No Authentication.
  4. In a conversation, choose Developer mode from the + menu and select MAQAMI Travel.
OpenAI Codex
codex mcp add maqami-travel --url https://mcp.maqami.co/

Or add to ~/.codex/config.toml:

[mcp_servers.maqami-travel]

url = "https://mcp.maqami.co/"

Gemini CLI

Install the extension, which adds the server and its context file:

gemini extensions install https://github.com/negm17111995/mcp-server

Or add only the server:

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

Or add to ~/.gemini/settings.json:

{

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

OpenAI Agents SDK (Python)
import asyncio

from agents import Agent, Runner from agents.mcp import MCPServerStreamableHttp

async def main() -> None: async with MCPServerStreamableHttp( name="MAQAMI Travel", params={"url": "https://mcp.maqami.co/"}, ) as maqami: agent = Agent(name="Travel assistant", mcp_servers=[maqami]) result = await Runner.run(agent, "Find 4-star hotels in Lisbon for 2 adults, 12 to 15 May.") print(result.final_output)

asyncio.run(main())

LangChain (Python)

LangChain 1.x includes MCP support in langchain.mcp (beta). Install with pip install langchain langchain-openai:

import asyncio

from langchain.agents import create_agent from langchain.mcp import MCPAdapter

async def main() -> None: async with MCPAdapter("https://mcp.maqami.co/") as maqami: tools = await maqami.list_tools() agent = create_agent("openai:gpt-5.4-mini", tools) result = await agent.ainvoke( {"messages": [{"role": "user", "content": "Which airports serve Tokyo?"}]} ) print(result"messages".content)

asyncio.run(main())

For a version that asks for your approval before any prebook, see travel-agent-examples/langchain-python.

n8n
  1. Add an AI Agent node to your workflow.
  2. Under Tools, add an MCP Client Tool node.
  3. Set the endpoint to https://mcp.maqami.co/, choose HTTP Streamable as the server transport (if your n8n version shows the option) and None for authentication.
  4. Under Tools to Include, pick the tools your workflow needs, or keep All.
Other Streamable HTTP clients
SettingValue
URLhttps://mcp.maqami.co/
TransportStreamable HTTP
AuthNone
Local stdio (npm)

For clients that only support stdio servers, the maqami-travel npm package is a thin bridge to the remote endpoint. It runs no booking logic locally and needs no credentials. Node.js 18 or later is required.

{

"mcpServers": { "maqami-travel": { "command": "npx", "args": ["-y", "maqami-travel"] } } }

This works in claude_desktop_config.json and any other client that launches stdio servers.

How agents use the server

The server is a standard MCP server. Every tool has a JSON Schema for its inputs and MCP annotations, so clients can tell read-only tools (readOnlyHint: true) from tools that change something.

Customers always book and pay on MAQAMI's website, book.maqami.co. The server finds the hotel or flight, holds the price and returns a checkoutUrl for that exact choice; the customer enters guest or passenger details, pays and

Only the beginning is shown; read the rest in the repo