trip1 MCP Server已验证已精选

什么是 trip1 MCP Server？

trip1 MCP Server 让 AI agent 在 trip1 上搜索和预订酒店，覆盖 200 多个国家约 300 万家酒店，可通过 x402 用 Base 上的 USDC 付款，或通过 CoinGate 加密货币结账页面付款。它不需要账户、API key 或 OAuth。

服务器是一个远程 Streamable HTTP 端点 https://trip1.com/api/mcp，在官方 MCP Registry 中的名称是 com.trip1/mcp。trivial-corp/agents 仓库（MIT）把它打包成插件，附带一个 skill：hotel-booking。这个 skill 指导 agent 完成预订流程：何时激活、按什么顺序调用哪些工具、如何处理 x402 支付握手和 CoinGate 备选方案，以及如何应对价格失效、支付失败和轮询超时。

如何使用 trip1 MCP Server？

无需注册。把客户端指向这个 URL 即可，或者安装插件以同时获得 skill。

Claude Code

安装插件，同时获得 MCP 服务器和 skill：

/plugin marketplace add trivial-corp/agents
/plugin install trip1@trivial-corp/agents

重启会话，让 Claude Code 加载新的连接。如果只想添加服务器：

claude mcp add --transport http trip1 https://trip1.com/api/mcp

Claude Desktop 和 claude.ai

添加 URL 为 https://trip1.com/api/mcp 的自定义连接器，无需登录。在 Claude Desktop 中，也可以从最新 release 下载 agents.zip，在 Customize → Personal plugins → Upload local plugin 中上传。

Cursor

在 ~/.cursor/mcp.json 中：

{
  "mcpServers": {
    "trip1": {
      "type": "streamable-http",
      "url": "https://trip1.com/api/mcp"
    }
  }
}

Cursor 还可以通过仓库里的 plugin.json 和 mcp.json 把它作为插件加载。

VS Code

code --add-mcp '{"name":"trip1","type":"http","url":"https://trip1.com/api/mcp"}'

其他客户端

Codex CLI、Gemini CLI 以及其他兼容 SKILL.md 的 agent 可以用 npx skills add trivial-corp/agents 安装 skill，MCP 服务器则用上面的 JSON 另行添加。只支持 stdio 的客户端可以用 npx -y mcp-remote https://trip1.com/api/mcp 桥接。在 ChatGPT 中，可以在应用目录搜索 trip1，或把这个 URL 添加为自定义连接器。

trip1 MCP Server 的主要功能

• 用六个工具完成酒店搜索、房价查询、结账和订单跟踪。
• MCP 连接无需账户、API key 或 OAuth。
• 两种支付方式：x402（Base 上的 USDC），由支持 x402 的钱包工具支付；或 CoinGate，由用户在浏览器中完成结账，可用 USDC 或其他 120 多种加密货币付款。
• 在能显示表单的客户端中提供预订表单（start_checkout），否则退回到聊天内预订。
• 每个房价都注明是否可退款，可退款时还注明取消截止时间。
• 入住人数固定为一间房 2 位成人。

trip1 MCP Server 工具

线上服务器提供六个工具，按顺序使用：

• search_hotels 按目的地和日期查找酒店，返回价格、图片和预订链接。
• get_hotel_details 返回房型、房价、退款条件以及预订所需的 rate ID；如果之前报的价格已失效，会标记 prices_changed。
• start_checkout 为选定的房价打开预订表单，只预填用户已经提供过的信息。
• purchase_hotel 在无法使用表单时在聊天中完成预订。它需要所有住客字段（名、姓、邮箱、电话、称谓、国籍）以及 payment_service（x402 或 coingate），返回 payment_url 和 cart_url。
• pay_order 为未付款的 CoinGate 订单打开 CoinGate 结账页面。
• get_order_details 报告支付和预订状态，轮询直到 ready 为 true。

trip1 MCP Server 的使用场景

• “Find hotels in Lisbon for 12 to 15 March and show me three options.”
• 在行程确定前比较可退款房价和取消截止时间。
• 让 agent 全自动付款：在 trip1 旁边加载一个 x402 钱包 MCP，例如 npx @coinbase/payments-mcp。
• 没有钱包工具时选择 CoinGate，在浏览器中完成加密货币付款。
• 在代码中构建 agent，用 @x402/fetch SDK 付款，然后轮询 get_order_details。

trip1 MCP Server 常见问题排查

• @x402/fetch 拒绝支付： 该 SDK 默认拒绝超过 $1 的付款，而酒店预订总是更贵。调高 maxAmountPerPayment，并把收款方固定为 https://trip1.com/.well-known/x402.json 中 trip1 的地址。
• 没有可用的钱包工具： 用 payment_service: "coingate" 调用 purchase_hotel，通过返回的结账链接付款。
• 价格与搜索结果不一致： get_hotel_details 会设置 prices_changed，请报新价格，而不是搜索时的价格。
• 预订尚未确认： 继续轮询 get_order_details，直到 ready 为 true。
• 入住日期被拒绝： 入住日期不能早于目的地当前的日历日期。