接入你的智能体
發布者自己的指令。不是 PlugMCP 端點。
用我們的金鑰與日誌託管一份副本。
npx -y [email protected]Claude Code 沒有本機指令的安裝連結。複製下方指令並在終端機中執行。
claude mcp add maqami-travel -- npx -y maqami-travel@1.0.9在終端機中執行。
{ "mcpServers": { "maqami-travel": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
遠端 URL 還是本機指令? 兩種安裝方式的差異
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/
Pick your client. Each line is enough to connect; the full steps are under Connect.
Then try: "Find 4-star hotels in Lisbon for 2 adults, 12 to 15 May."
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.
Add MAQAMI as a custom connector:
MAQAMI Travel and the URL https://mcp.maqami.co/, then click Continue.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.
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.
maqami-travel.mcpb.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 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
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=
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/"}'
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 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).
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.
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.
MAQAMI Travel and the URL https://mcp.maqami.co/, and choose No Authentication.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/"
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/"
}
}
}
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 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"][-1].content)
asyncio.run(main())
For a version that asks for your approval before any prebook, see travel-agent-examples/langchain-python.
https://mcp.maqami.co/, choose HTTP Streamable as the server transport (if your n8n version shows the option) and None for authentication.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.
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 gets their confirmation there. No tool takes payment or asks for payment details.
Lookup, amend and cancel tools need the booking ID and the email used to book; the server only returns or changes a booking when both match. Pass both bookingId and email to every booking tool. To find a customer's hotel bookings, call listBookings with the email and last name used to book; it returns only bookings where both match the booking holder. Hotel bookings are cancelled with cancel_hotel_booking, flights with post_flights_bookings_bookingid_cancellations (check get_flights_bookings_bookingid_cancellations for the refund estimate first). put_bookings_bookingid_amend corrects the holder's name, email or phone on a hotel booking: it takes the email currently on the booking and the corrected holder (firstName, lastName, email, optional phone).
Tool names and required fields above are as published by the server in October 2026. The tool list your client receives from the server is always the source of truth: only the tools it lists exist, and other tool names are rejected. Hotel offerIds are signed by the server: pass them exactly as returned, and run the search again if one is rejected.
checkoutUrl from prebook or verify, and never ask for card or passport details in the chat.limit and maxRatesPerHotel on hotel searches and filters on flight searches. get_data_facilities, get_data_chains, get_data_iatacodes and get_data_cities return whole reference lists, so call them only when you need an ID from them; find airports with get_data_flights_airports instead.The examples show one way to do this: read-only tools run automatically and every other tool waits for the user's approval.
Do I need an API key or an account to connect? No. The endpoint accepts connections without authentication.
How does the customer pay?
Only on MAQAMI's website. Prebook (hotels) or verify (flights) returns a checkoutUrl on book.maqami.co for that exact room or fare. The customer opens it, enters guest or passenger details, pays securely and receives the confirmation there. The MCP server never takes payment.
Does the checkout link create a real reservation? Yes, once the customer completes checkout on book.maqami.co. Review the details and final price before paying.
Which transport does the server use?
Streamable HTTP at https://mcp.maqami.co/. If your client only supports stdio, use the maqami-travel npm bridge.
My client warns that there are too many tools. What should I do? Turn on only the tools you need. Most clients let you do this: the tool picker in VS Code, per-tool toggles in Cursor and Claude, and Tools to Include in n8n. For a travel assistant, the search, details, prebook and verify tools in the tables above are a good start.
What does the server see? An MCP server receives only the tool calls and arguments your client sends. It does not see the rest of your conversation.
Where is the server listed?
In the official MCP Registry as io.github.negm17111995/maqami-travel, and on npm as maqami-travel. It is also a Claude Desktop extension (maqami-travel.mcpb). This repository is also a Gemini CLI extension (gemini-extension.json), a Claude Code plugin and marketplace (.claude-plugin/), a Codex plugin (.codex-plugin/plugin.json) and an Agent Plugins package (plugin.json and mcp.json). The plugins bundle the maqami-travel-booking skill. Directories: Smithery, Glama, Raycast's MCP registry, the ToolSDK MCP registry and the Hermes Agent plugin catalog.
Can I use it in my own agent or product? Yes, it's a public endpoint. Please follow the confirmation guidance above. For partnerships, contact [email protected].
How do I report a bug or a security issue? Open an issue for bugs and client setup problems. For security issues, follow SECURITY.md and don't open a public issue.
negm17111995/travel-agent-examples has small, runnable travel assistants that connect to this server from the OpenAI Agents SDK (Python), LangChain with LangGraph (Python) and the Vercel AI SDK (TypeScript). Each one asks for your approval before any call that is not read-only.
https://mcp.maqami.co/ is encrypted over HTTPS.The repository contains the npm stdio bridge (index.js). The hosted server is deployed separately.
npm install
npm test
The bridge 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/. The manifest tests check that every manifest parses, points at the same endpoint and carries the version from package.json.
Documentation fixes, client setup guides and bug reports are welcome. See CONTRIBUTING.md and the Code of Conduct. Questions and ideas go to Discussions.
Questions or issues: [email protected] or open an issue.
MAQAMI (MAQAMI LLC) is a US-registered travel company selling hotels and flights worldwide: over 3 million properties, instant confirmation, secure Stripe checkout and 24/7 support.
MCP server for hotel and flight search and booking: live rates for 3M+ hotels and global flights, then a secure checkout link on book.maqami.co. Works with Claude, ChatGPT, Cursor, VS Code, Windsurf,
{ "mcpServers": { "maqami-travel": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}總覽
MCP server for hotel and flight search and booking: live rates for 3M+ hotels and global flights, then a secure checkout link on book.maqami.co. Works with Claude, ChatGPT, Cursor, VS Code, Windsurf, Cline and Gemini CLI. Remote Streamable HTTP endpoint o
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Maqami Travel 透過 stdio 在本機執行。
上次檢查時間:2026-11-16。 MCP server for hotel and flight search and booking: live rates for 3M+ hotels and global flights, then a secure checkout link on book.maqami.co. Works with Claude, ChatGPT, Cursor, VS Code, Windsurf, Cline and Gemini CLI. Remote Streamable HTTP endpoint o