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 places, airports and hotel details, then prebook and book. Remote Streamable HTTP endpoint, no API key required.

https://mcp.maqami.co/

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.

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

Claude Code

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

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 by opening this link 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 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/"
    }
  }
}

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

Custom MCP apps are available on the web for Plus, Pro, Business, Enterprise and Education accounts.

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

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())

Other Streamable HTTP clients

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.

What you can do

• Search hotels with live rates and availability.
• Search flights and compare fares.
• Look up places, airports and hotel details, including amenities and photos.
• Prebook a hotel or flight rate to confirm price and availability.
• Book the prebooked rate. Booking creates a real reservation and requires guest and payment details.

Example prompts

• "Find 5-star hotels in Istanbul for 15 to 17 August, 2 adults."
• "Show me the amenities and photos for the second hotel."
• "Search flights from Dubai to London on 10 December for one adult."
• "Which airports serve Tokyo?"
• "Prebook that room and confirm the final price before I book."

Privacy and security

• No API key or account is required to connect.
• All traffic to https://mcp.maqami.co/ is encrypted over HTTPS.
• Searches and bookings are processed by MAQAMI. Guest and payment details you provide for a booking are handled according to the policies published at maqami.co.
• Booking creates a real reservation. Review the details and final price before confirming.

Development

The repository contains the npm stdio bridge (index.js). The hosted server is deployed separately.

npm install
npm test

The tests start a local mock Streamable HTTP server and point the bridge at it with the MAQAMI_MCP_URL environment variable. That variable exists for testing only; by default the bridge connects to https://mcp.maqami.co/.

License

MIT

Support

Questions or issues: info@maqami.co or open an issue.