trip1

trip1 Agent 技能和 MCP 服务

一个插件，可让 Agent 通过 trip1 MCP 服务在 trip1 上预订酒店：覆盖 200 多个国家/地区的约 300 万处住宿，可通过 x402 在 Base 上使用 USDC 付款。

• 端点： https://trip1.com/api/mcp（Streamable HTTP）
• 身份验证： 无需账户、API 密钥或 OAuth
• 文档： https://trip1.com/agents
• MCP Registry： com.trip1/mcp

附带一个技能 hotel-booking，当用户想要查找、比较或预订酒店时会启用。

包含内容

• .claude-plugin/plugin.json — Claude Code / Claude Desktop 插件清单
• .mcp.json — 配置 trip1 远程 MCP 服务，使插件可独立运行
• plugin.json 和 mcp.json — 采用 Agent Plugins 格式的相同插件，适用于 Cursor 和其他兼容客户端
• skills/hotel-booking/SKILL.md — 编排完整预订流程的技能
• server.json — 官方 MCP Registry 条目
• llms-install.md — 为 Cline 等自行设置服务的 Agent 提供安装说明

安装

Claude Code

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

MCP 服务和技能会一起安装。重启会话，让 Claude Code 加载新的 MCP 连接。

Claude Desktop

有两种方式。

作为本地插件。 从最新版本下载 agents.zip，然后在 Claude Desktop 中依次选择 Customize → Personal plugins → Upload local plugin，并上传该 zip 文件。

作为连接器。 如果只需要 MCP 服务而不需要技能，可直接添加连接器：

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

Cursor、Windsurf、Cline

将服务添加到客户端的 MCP 配置中（Cursor 使用 ~/.cursor/mcp.json；Cline 中选择 MCP Servers → Configure → Remote Servers）：

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

Cursor 也可以通过 plugin.json 和 mcp.json 将此仓库作为插件加载。仅支持 stdio 的客户端可通过 npx -y mcp-remote https://trip1.com/api/mcp 建立桥接。

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

此操作会安装技能。请通过客户端的 MCP 配置另行添加 MCP 服务（使用上文相同的 JSON）。

ChatGPT

在 ChatGPT 应用目录中搜索 trip1。或者在 Settings → Connectors → Add 中将其添加为自定义连接器，并填写：

https://trip1.com/api/mcp

此处不适用该技能；ChatGPT 不会加载 SKILL.md 文件。MCP 服务中的工具描述已包含足够的意图信息，ChatGPT 可以自行完成整个流程。

Cowork 和其他支持 MCP 的客户端

任何支持远程 MCP（Streamable HTTP）的客户端都可以将 trip1 添加为连接器。粘贴上文相同的 mcpServers 代码块；如果客户端支持直接输入 URL，也可以粘贴裸 URL https://trip1.com/api/mcp。

本地开发

git clone https://github.com/trivial-corp/agents
cd agents
claude --plugin-dir .

技能功能

该技能是一组指令，而非代码。它会告知 Agent：

• 何时检测到预订酒店的意图并启用技能
• 应调用哪些 trip1 MCP 工具、按什么顺序调用，以及传入哪些参数
• 如何处理 x402 付款握手和 CoinGate 备用方案
• 如何报告结果，以及如何从价格下跌、付款失败和轮询超时中恢复

代表 Agent 付款

如需让 Agent 全自动付款，可在 trip1 之外加载支持 x402 的钱包 MCP。最简单的方式：

npx @coinbase/payments-mcp

使用 x402 SDK 通过代码付款

@x402/fetch 默认拒绝任何超过 $1 的付款，而酒店预订的费用始终更高，因此需要提高限额。同时固定收款方，确保客户端只向 trip1 付款：

import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm";
import { privateKeyToAccount } from "viem/accounts";

const TRIP1_PAY_TO = "0x4eD818663D9040461Ee1f6E8f618Df1770dddDc1"; // see https://trip1.com/.well-known/x402.json

const fetchWithPayment = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(privateKeyToAccount(process.env.EVM_PRIVATE_KEY)) }],
  spendControls: { maxAmountPerPayment: "$2000" },
  policies: [(_version, reqs) => reqs.filter((r) => r.payTo.toLowerCase() === TRIP1_PAY_TO.toLowerCase())],
});

const response = await fetchWithPayment(paymentUrl); // payment_url from purchase_hotel

然后轮询 get_order_details，直到 ready 为 true。

没有钱包时

调用 purchase_hotel 并设置 payment_service: "coingate"。该工具会返回 CoinGate 结账 URL，由用户在浏览器中完成付款。CoinGate 支持 120 多种加密货币，包括 USDC。

发布到 MCP Registry

更新 server.json 中的 version，然后在运行 mcp-publisher login dns --domain trip1.com 后，运行 mcp-publisher publish。DNS 密钥由 trip1 团队保管。

发布版本

更新 .claude-plugin/plugin.json 中的 version，并合并到 main。release.yml 工作流会创建 vX.Y.Z 标签，将 agents.zip（完整插件包）以及 skills/ 下每个技能对应的 zip 文件打包，并发布到 GitHub release。

如需从已有提交创建版本，也可以手动推送标签：git tag -a vX.Y.Z -m "..." && git push origin vX.Y.Z。该工作流同样会处理。

链接

• 落地页：https://trip1.com/agents
• 服务卡片：https://trip1.com/.well-known/mcp.json
• x402 元数据：https://trip1.com/.well-known/x402.json
• MCP Registry 条目：com.trip1/mcp
• x402 协议：https://x402.org
• Agent Skills 规范：https://agentskills.io/specification

许可证

MIT