trip1

trip1 エージェントスキルと MCP サーバー

エージェントが trip1 MCP サーバーを通じて trip1 のホテルを予約できるプラグインです。x402 を介して Base 上で USDC で支払うことができ、200 以上の国に約 300 万件の宿泊施設があります。

• エンドポイント： https://trip1.com/api/mcp（Streamable HTTP）
• 認証： 不要。アカウント、API キー、OAuth は必要ありません
• ドキュメント： https://trip1.com/agents
• MCP レジストリ： com.trip1/mcp

hotel-booking というスキルが 1 つ含まれており、ユーザーがホテルを検索、比較、予約しようとすると有効になります。

内容

• .claude-plugin/plugin.json — Claude Code / Claude Desktop のプラグインマニフェスト
• .mcp.json — trip1 リモート MCP サーバーを接続し、プラグインを単体で利用できるようにします
• plugin.json と mcp.json — Cursor やその他の互換クライアント向けの、Agent Plugins 形式の同じプラグイン
• skills/hotel-booking/SKILL.md — 予約の全行程を調整するスキル
• server.json — 公式 MCP レジストリのエントリー
• llms-install.md — サーバーを自分で設定する Cline などのエージェント向けインストール手順

インストール

Claude Code

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

MCP サーバーとスキルは一緒にインストールされます。Claude Code が新しい MCP 接続を認識できるよう、セッションを再起動してください。

Claude Desktop

2 つの方法があります。

ローカルプラグインとして。 最新リリースから 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 互換エージェント

npx skills add trivial-corp/agents

これによりスキルがインストールされます。クライアントの MCP 設定から、MCP サーバーを別途追加してください（上記と同じ JSON を使用します）。

ChatGPT

ChatGPT アプリディレクトリで trip1 を検索してください。または、Settings → Connectors → Add でカスタムコネクターとして追加し、次の URL を指定します。

https://trip1.com/api/mcp

ChatGPT は SKILL.md ファイルを読み込まないため、このスキルは適用されません。MCP サーバーのツール説明だけで、ChatGPT が独自に一連の処理を進めるには十分です。

Cowork およびその他の MCP 対応クライアント

リモート MCP（Streamable HTTP）に対応するクライアントであれば、trip1 をコネクターとして追加できます。上記と同じ mcpServers ブロックを貼り付けるか、クライアントが URL を直接受け付ける場合は https://trip1.com/api/mcp を入力します。

ローカル開発

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

スキルの機能

このスキルはコードではなく、指示です。エージェントに次のことを伝えます。

• ホテル予約の意図がある場合に、いつスキルを有効にするか
• どの trip1 MCP ツールを、どの順序で、どの引数を使って呼び出すか
• x402 の支払いハンドシェイクと CoinGate へのフォールバックをどう処理するか
• 結果をどう報告し、料金の下落、支払い失敗、ポーリングのタイムアウトからどう復旧するか

エージェントに代わって支払う

エージェントによる完全自動の支払いには、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

次に、ready が true になるまで get_order_details をポーリングします。

ウォレットを使わない場合

payment_service: "coingate" を指定して purchase_hotel を呼び出します。人間がブラウザーで決済を完了する CoinGate のチェックアウト URL が返されます。CoinGate は USDC を含む 120 種類以上の暗号資産に対応しています。

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 リリースに公開します。

既存のコミットからリリースを作成する場合は、代わりにタグを手動でプッシュします：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