trip1

npx add-mcp 'https://trip1.com/api/mcp'

trip1 面向 AI 智能体

通过智能体预订酒店

trip1 将酒店搜索、房价和预订功能作为 MCP 工具提供。覆盖 200 多个国家/地区的约 300 万家住宿，使用 Base 上的 USDC 通过 x402 付款。结算在智能体已发起的同一个 HTTP 请求中完成。

安装 trip1 了解其工作原理

Claude Desktop Claude Code ChatGPT 其他

通过 Claude Desktop UI 安装：

1. 01打开 Settings → Customize → Plugins。
2. 02点击 Add marketplace 并输入 trivial-corp/agents。
3. 03在 marketplace 列表中找到 trip1，然后点击 Install。

Pro、Max、Team 和 Enterprise 的具体步骤有所不同。Anthropic 的连接器设置指南介绍了各个方案。

在任意 Claude Code 会话中粘贴。它会同时安装 MCP 服务器和酒店预订技能。

/plugin marketplace add trivial-corp/agents

/plugin install trip1@trivial-corp/agents

需要 Pro、Team、Enterprise 或 Edu（Developer Mode）。

1. 01打开 Settings → Apps & Connectors → Advanced settings 并启用 Developer Mode。
2. 02返回 Apps & Connectors，点击 Add new connector。
3. 03将其命名为 trip1，粘贴下方 URL，并将 Auth 设为 None。

https://trip1.com/api/mcp

OpenAI MCP 文档。

任何支持远程 MCP 的客户端（Cursor、Codex CLI、Gemini CLI、Cowork 等）都可以使用此配置：

mcp.json

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

流程

从搜索到确认预订

智能体会自行完成每个步骤，从首次搜索到获取供应商的预订参考号。

酒店

300 多万家住宿

覆盖范围

200 多个国家/地区

结算

Base 上的 USDC，约 2 秒

trip1 MCP 演示

1. 01

   搜索

   智能体按目的地和日期搜索酒店（入住人数固定为 2 位成人）。

2. 02

   比较

   获取所选酒店的客房、房价和实时空房情况。

3. 03

   预订

   使用宾客信息和房价 ID 创建预订。

4. 04

   付款

   通过 x402 在 Base 上签署 USDC 转账。支付协调方提交转账并确认结算，通常约两秒即可完成。

5. 05

   确认

   轮询订单，直到供应商返回预订参考号。

工具

四个工具，按顺序调用

每个工具都附带完整的 JSON 架构、读写注释，以及供智能体在调用前阅读的说明。无需猜测。

search_hotels

查询指定目的地和日期范围内的酒店。可按价格、评分或距搜索中心的距离排序。

get_hotel_details

获取一家酒店的房型、每晚房价、取消条款和实时空房情况。

purchase_hotel

使用宾客信息和来自 get_hotel_details 的房价 ID 创建预订。返回 x402 挑战；如果无法使用，则返回 CoinGate URL。

get_order_details

按 ID 获取订单。付款后进行轮询；预订完成后会显示供应商参考号。

技能可端到端处理的提示词

在已安装 trip1 的会话中粘贴以下任意提示词。智能体会自行搜索、比较房价、收集宾客信息、与你确认，并完成付款结算。

• >帮我找一家 5 月 30 日至 31 日在巴塞罗那的酒店。
• >这个周末里斯本 Bairro Alto 附近最便宜的酒店是哪家？
• >从周五开始在涩谷住三晚。选一家评价不错的酒店并帮我预订。
• >查看巴塞罗那的预订。持续轮询，直到获取供应商参考号。

付款

智能体通过 x402 付款

x402 是面向智能体支付的开放协议。它让 HTTP 402 可用于程序化场景：智能体调用 purchase_hotel 时，trip1 会返回付款挑战；智能体在 Base 上签署 USDC 授权后重试。支付协调方提交转账，结算完成后即可继续预订。智能体会自行处理所有步骤，无需在钱包 UI 中点击操作。

智能体需要支持 x402 的钱包才能自行付款。最简单的选择是同时加载 Coinbase Payments MCP 和 trip1：

npx @coinbase/payments-mcp

如果没有连接支付 MCP，purchase_hotel 会改为返回 CoinGate URL。你可以在浏览器中自行完成付款，支持包括 USDC 在内的 120 多种加密货币。

技能

插件附带技能

MCP 服务器提供工具。技能则提供判断能力：何时调用、下一步调用哪个工具、如何与用户确认预订详情，以及房价在搜索和结账之间下跌时如何处理。上文的 Claude Desktop 和 Claude Code 安装包会自动附带该技能。

对于支持通用 SKILL.md 格式的客户端（Cursor、Codex CLI、Gemini CLI），请单独添加：

npx skills add trivial-corp/agents

ChatGPT 和其他仅支持远程 MCP 的界面不会加载 SKILL.md。服务器上的工具说明本身已包含足够的意图信息。

在浏览器中

WebMCP：直接在 trip1.com 上使用工具

WebMCP 允许网页向浏览器中的智能体提供一组带说明的工具。trip1.com 通过 document.modelContext 注册这些工具，因此智能体可以像使用该页面的用户一样搜索、查看房价、浏览指南和帮助内容、保存酒店并打开结账页面，而不是猜测按钮的作用。工具会随页面变化，就像页面本身一样。

它与上文的 MCP 服务器并行运行，而非取而代之。MCP 服务器面向在浏览器之外运行并通过 x402 付款的智能体。WebMCP 则在用户自己的会话中运行，付款始终由用户在结账页面上完成。

实验性功能

Chrome 正在通过 origin trial（Chrome 149 至 156）测试 WebMCP，trip1.com 已加入该测试，标准仍可能发生变化。

试用

1. 01安装 WebMCP 智能体扩展，例如 Model Context Tool Inspector。
2. 02Inspector 会读取 Chrome 自带的 WebMCP，因此需要先启用它：在 Chrome 150 或更高版本中，打开 chrome://flags，将 WebMCP for testing 设为 Enabled，然后重新启动浏览器。自带 WebMCP 的扩展无需此步骤。
3. 03打开 trip1.com，并让智能体帮你规划住宿。

各页面上的工具

只读

读取页面内容，不做任何更改。

更改页面

导航或编辑搜索内容，效果相当于点击操作。

重要操作

代表用户执行操作：预留客房、在表单中填写用户信息，或编辑用户的已保存列表。付款仍由用户完成。

每个页面：3 个工具

get_page_context只读

用户所在页面、登录状态、货币，以及此页面提供的工具。

navigate_to更改页面

打开 trip1 的某个版块。

search_hotels更改页面

按目的地、日期、客房和宾客人数搜索，并打开搜索结果。

每个页面：指南和帮助，4 个工具

find_articles只读

按目的地或主题查找旅行指南和博客文章，按最新发布排序。

open_article更改页面

打开指南或博客文章。

search_help_articles只读

搜索帮助中心：预订、加密货币付款、取消。

get_help_article只读

以纯文本形式获取帮助文章。

每个页面：账户，2 个工具

get_account_status只读

用户是否已登录，不包含任何身份信息。

open_sign_in更改页面

打开登录对话框。用户自行登录；智能体绝不会处理凭据。

搜索结果：4 个工具

get_search_results只读

获取页面上的酒店、整个住宿期间的实时价格和坐标，并支持通过 offset 分页。

get_available_filters只读

获取可用于细化此次搜索的筛选条件，包括价格范围。

refine_search更改页面

更改星级、设施、价格、排序、半径、日期或宾客人数。

open_hotel更改页面

打开搜索结果中的酒店，或通过 slug 打开任意 trip1 酒店。

酒店页面：4 个工具

get_hotel_details只读

酒店描述、位置、设施和政策。

get_hotel_reviews只读

宾客评价，按最新发布排序，并显示平均评分。

check_hotel_availability更改页面

针对其他日期或宾客人数进行实时空房查询。

save_hotel重要操作

将酒店添加到用户的已保存列表，或从中移除。用户必须已登录。

酒店页面：设置日期后，2 个工具

get_room_rates只读

所有可预订的客房，包括餐食方案、取消条款和住宿总价。

select_rates重要操作

预留所选客房并打开结账页面。不会扣款。

结账：2 个工具

get_checkout_summary只读

酒店、日期、客房、取消条款、总价、宾客信息是否已填写，以及还需完成哪些事项。用户接受条款并付款。

prefill_contact重要操作

将联系人的信息填入表单。信息不会被保存：用户需要检查信息并点击 Save contact。

账户已登录：2 个工具

get_bookings只读

用户的预订：参考号、酒店、日期、状态和总价。不包含宾客信息。

open_booking会更改页面

通过预订参考编号打开预订。

预订1 工具

get_booking_details只读

客房、状态、取消条款和退款估算。取消操作由用户完成。

旅行指南或博客文章3 工具

get_article只读

文章的纯文本内容：日期、章节、链接到的酒店以及常见问题。

open_hotel会更改页面

打开文章中链接的酒店。

save_travel_guide有重要影响

仅适用于旅行指南：将指南添加到用户的已保存列表，或将其移除。用户必须已登录。

TSA 等待时间页面2 工具

find_tsa_airports只读

按代码、城市或别名查找机场，并获取规范的机场链接。

get_tsa_wait_times只读

缓存的等待时间，附带实时/估算标签、来源时间戳、安检点指南和常见问题。

trip1 上的 WebMCP 工作原理，通过 Inspector 展示 Gemini 规划的真实行程。

常见问题

使用 trip1 需要加密货币钱包吗？

trip1 原生支持加密货币，因此整个流程中始终会用到钱包。作为用户，你可以通过 CoinGate 获取托管式结账 URL，使用 120 多种加密货币（包括 USDC）付款。若加载了支持 x402 的钱包 MCP（例如 Coinbase Payments MCP），智能体便可通过 x402 自行付款。

如果搜索和预订之间价格发生变化，会怎样？

trip1 会返回明确的“价格已不可用”错误。该技能会指示智能体使用最新的价格 ID 重新运行 search_hotels 和 get_hotel_details。它绝不会在不告知用户的情况下自动替换价格。

trip1 会存储智能体或用户的付款凭据吗？

不会。trip1 是一个非托管商户端点。x402 转账会通过智能体选择的中介在链上结算。CoinGate 负责处理基于浏览器的流程，trip1 不会接触银行卡或钱包详情。

服务器使用哪个 MCP 协议版本？

Streamable HTTP，规范版本为 2025-06-18，无状态模式。兼容所有现代 MCP 客户端（Claude Desktop、Claude Code、ChatGPT、Cursor、Codex CLI、Gemini CLI）。

预订确认后可以取消吗？

能否取消取决于价格方案。get_hotel_details 会在预订前返回每个价格方案的取消条款，技能也会明确标示不可退款的价格方案。预订后的变更，请向 trip1 支持团队提供预订参考编号并联系他们。

MCP 服务器有速率限制吗？

trip1 会按 IP 和已签名会话实施速率限制。若要大规模运行智能体，请在上线前联系我们，以便提高配额。

面向智能体的加密货币结账

自 2025 年以来，trip1 一直接受用户的加密货币付款。MCP 服务器只是让智能体也能完成同样的操作。

浏览酒店 GitHub 上的插件源代码

{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://trip1.com/#organization","name":"trip1","url":"https://trip1.com","logo":{"@type":"ImageObject","@id":"https://trip1.com/#logo","url":"https://trip1.com/trip1-logo.png"},"image":{"@id":"https://trip1.com/#logo"},"description":"trip1 is a hotel booking platform that helps travelers find and book accommodations from 3M+ hotels worldwide. Pay with crypto.","foundingDate":"2025","founder":{"@type":"Person","name":"Tomas Achmedovas","url":"https://trip1.com/authors/tomas-achmedovas"},"address":{"@type":"PostalAddress","addressLocality":"Vilnius","addressCountry":"LT"},"email":"support@trip1.com","numberOfEmployees":{"@type":"QuantitativeValue","minValue":2,"maxValue":10},"sameAs":["https://www.instagram.com/trip1com","https://www.facebook.com/trip1com","https://x.com/trip1com","https://www.linkedin.com/company/trip1","https://github.com/trivial-corp","https://www.trustpilot.com/review/trip1.com","https://coingate.com/stores/trip1","https://smithery.ai/servers/trip1/trip1"],"contactPoint":{"@type":"ContactPoint","contactType":"customer support","url":"https://trip1.com/help"}},{"@type":"WebSite","@id":"https://trip1.com/#website","name":"trip1","url":"https://trip1.com","description":"Find and book hotels effortlessly with trip1. Compare deals from 3M+ hotels worldwide and pay with crypto.","publisher":{"@id":"https://trip1.com/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://trip1.com/search/hotels?query={search_term_string}"},"query-input":"required name=search_term_string"}},{"@type":"WebAPI","@id":"https://trip1.com/agents#mcp","name":"trip1 MCP server","description":"trip1 MCP server lets AI agents book hotels and pay with USDC on Base via x402. 3M+ hotels, settled on-chain in seconds. Works with Claude, ChatGPT, and any MCP client.","url":"https://trip1.com/agents","documentation":"https://trip1.com/agents","provider":{"@id":"https://trip1.com/#organization"}},{"@type":"WebAPI","@id":"https://trip1.com/agents#webmcp","name":"trip1 WebMCP tools","description":"Experimental. trip1.com pages register tools for searching hotels, reading results, hotel details and room rates, travel guides, blog posts and help articles, and saving hotels, with document.modelContext, for agents running in the user’s browser (Chrome origin trial, Chrome 149 to 156).","url":"https://trip1.com/agents#webmcp","documentation":"https://trip1.com/blog/trip1-webmcp-ai-agents","provider":{"@id":"https://trip1.com/#organization"}},{"@type":"SoftwareApplication","@id":"https://trip1.com/agents#app","name":"trip1 MCP server","description":"trip1 MCP server lets AI agents book hotels and pay with USDC on Base via x402. 3M+ hotels, settled on-chain in seconds. Works with Claude, ChatGPT, and any MCP client.","url":"https://trip1.com/agents","applicationCategory":"TravelApplication","operatingSystem":"Any","installUrl":"https://trip1.com/agents","softwareHelp":{"@id":"https://trip1.com/agents#mcp"},"offers":{"@type":"Offer","price":"0","priceCurrency":"USD"},"author":{"@id":"https://trip1.com/#organization"},"sameAs":["https://smithery.ai/servers/trip1/trip1","https://github.com/trivial-corp/agents"]}]}