negm17111995/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.
Quick start
Pick your client. Each line is enough to connect; the full steps are under Connect.
| Client | Fastest way to connect |
| --- | --- |
| Claude Code | claude 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 mobile | **Customize → Connectors → Add custom connector**, URL https://mcp.maqami.co/, **No sign in**. Works on the Free plan (steps) |
| Cursor | Add to Cursor (one click), or add "maqami-travel": { "url": "https://mcp.maqami.co/" } to mcp.json |
| VS Code | Install in VS Code (one click), or code --add-mcp '{"name":"maqami-travel","type":"http","url":"https://mcp.maqami.co/"}' |
| Windsurf | Add "maqami-travel": { "serverUrl": "https://mcp.maqami.co/" } to mcp_config.json |
| Gemini CLI | gemini extensions install https://github.com/negm17111995/mcp-server |
| OpenAI Codex | codex mcp add maqami-travel --url https://mcp.maqami.co/ |
| ChatGPT | Developer mode → create an app with URL https://mcp.maqami.co/ and **No Authentication** (steps and plans) |
| OpenAI Agents SDK | MCPServerStreamableHttp(name="MAQAMI Travel", params={"url": "https://mcp.maqami.co/"}) |
| LangChain | MCPAdapter("https://mcp.maqami.co/") from langchain.mcp (example) |
| n8n | **MCP Client Tool** node, endpoint https://mcp.maqami.co/, HTTP Streamable, no authentication (steps) |
| Cline | **MCP Servers → Remote Servers**, URL https://mcp.maqami.co/, Streamable HTTP |
| LM Studio | Add "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 client | Streamable 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
Or install the plugin, which adds the server and a booking skill that walks Claude through search, confirmation and the checkout link:
Cursor
Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):
Or install with one click: Add to Cursor. The same install as a deeplink, to open in your browser:
VS Code
Add to .vscode/mcp.json in your workspace:
Or install in VS Code with one click, or add it to your user profile from the command line:
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: