jtr-holidays

JTR Holidays MCP サーバー

Model Context Protocol を介して、JTR Holidays のアトラクションチケット、ツアー、複数日間のホリデーパッケージの最新カタログを AI アシスタントに接続できます。

JTR Holidays はドバイを拠点とするグローバルな旅行プラットフォームで、Trustpilot で 5 つ星（734 件以上のレビュー）を獲得しています。この MCP サーバーにより、AI アシスタントは単一の JSON-RPC 2.0 エンドポイントを介して、24 か国のアクティビティをリアルタイムで検索し、空き状況を確認し、ホリデーパッケージを閲覧できます。

---

目次

• クイックスタート
• 認証
• 利用可能なツール
• 使用例
• 対応する目的地
• お問い合わせとサポート

---

クイックスタート

エンドポイント

POST https://api.jtrholidays.com/mcp/v1
Content-Type: application/json

API キーは不要です。5 つの閲覧／検索ツールはすべて公開されています。

自動検出（認証不要）

GET https://api.jtrholidays.com/.well-known/mcp.json

MCP ハンドシェイク

{
  "jsonrpc": "2.0",
  "method": "initialize",
  "id": 1,
  "params": {
    "protocolVersion": "2024-11-05",
    "clientInfo": { "name": "your-client", "version": "1.0" }
  }
}

利用可能なツールの一覧表示

{
  "jsonrpc": "2.0",
  "method": "tools/list",
  "id": 2
}

ツールの呼び出し

すべてのツール呼び出しで tools/call メソッドを使用します。

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 3,
  "params": {
    "name": "<tool_name>",
    "arguments": { }
  }
}

---

認証

このサーバーは二段階のアクセスモデルを採用しています。

ティア 1 — 公開（認証不要）

現在の 5 つのツールはすべて公開されています。API キーも、サインアップも、待ち時間も不要です。

ヘッダー	値
Content-Type	application/json

レート制限：IP あたり毎分 100 リクエスト。

POST https://api.jtrholidays.com/mcp/v1
Content-Type: application/json

ティア 2 — 保護対象（今後追加予定の書き込みツール）

今後追加される書き込みおよび変更ツール（例：create_booking、update_inventory）では、シークレットヘッダーが必要になります。これらのツールはまだ存在しません。

ヘッダー	値
X-MCP-Secret	お客様のシークレットキー
Content-Type	application/json

認証済みの呼び出し元のレート制限：IP あたり毎分 1000 リクエスト。

連携用の認証済みアクセスを希望する場合は、[email protected] までお問い合わせください。

検出エンドポイント（GET /.well-known/mcp.json）は常に公開されています。

---

利用可能なツール

search_activities

目的地、カテゴリ、予算で JTR Holidays のアクティビティおよびツアーのカタログを検索します。

パラメーター	型	必須	説明
destination	string	いいえ	都市名または国名（例："Dubai"、"Singapore"）
category	string	いいえ	アクティビティのカテゴリ（例："Desert Safari"、"Sightseeing"）
budget_max	number	いいえ	アクティビティの現地通貨での、1 人あたりの最高価格
limit	integer	いいえ	返す結果の最大数（デフォルト：20、最大：50）

---

get_activity_details

1 件のアクティビティについて、含まれる内容、含まれない内容、キャンセルポリシー、レビューなどの詳細情報を取得します。

パラメーター	型	必須	説明
activity_id	string	はい	search_activities の結果に含まれるアクティビティの UUID

---

check_availability

特定の日付にアクティビティを利用できるか確認し、最新の料金オプションを返します。

パラメーター	型	必須	説明
activity_id	string	はい	アクティビティの UUID
date	string	はい	Y-m-d 形式の日付（例："2025-12-25"）
pax	integer	いいえ	人数（デフォルト：1）

---

get_destinations

JTR Holidays がツアーを提供しているすべての目的地（国）を、アクティビティ数や人気のツアーとともに一覧表示します。パラメーターはありません。

---

get_holiday_packages

旅程、出発日、料金を含む複数日間のホリデーパッケージを検索します。

パラメーター	型	必須	説明
destination	string	いいえ	国または地域で絞り込みます
duration_days	integer	いいえ	日数を指定して絞り込みます
limit	integer	いいえ	返す結果の最大数（デフォルト：20、最大：50）

---

例

1. ドバイのアクティビティを検索する

リクエスト

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "search_activities",
    "arguments": {
      "destination": "Dubai",
      "category": "Desert Safari",
      "budget_max": 200,
      "limit": 2
    }
  }
}

レスポンス

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"activities\":[{\"activity_id\":\"a1b2c3d4-0001-0001-0001-000000000001\",\"title\":\"Dubai Evening Desert Safari with BBQ Dinner\",\"description\":\"Experience the magic of the Dubai desert with dune bashing, camel riding, and a live BBQ dinner under the stars.\",\"price_from\":55,\"currency\":\"AED\",\"city\":\"Dubai\",\"country\":\"UAE\",\"rating\":4.8,\"booking_url\":\"https://jtrholidays.com/activity/dubai-evening-desert-safari\"},{\"activity_id\":\"a1b2c3d4-0001-0001-0001-000000000002\",\"title\":\"Dubai Morning Desert Safari with Camel Ride\",\"description\":\"A sunrise desert adventure with sandboarding, camel ride, and a traditional Bedouin breakfast.\",\"price_from\":45,\"currency\":\"AED\",\"city\":\"Dubai\",\"country\":\"UAE\",\"rating\":4.7,\"booking_url\":\"https://jtrholidays.com/activity/dubai-morning-desert-safari\"}],\"total\":2}"
      }
    ]
  }
}

---

2. アクティビティの空き状況を確認する

リクエスト

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 2,
  "params": {
    "name": "check_availability",
    "arguments": {
      "activity_id": "a1b2c3d4-0001-0001-0001-000000000001",
      "date": "2025-12-25",
      "pax": 2
    }
  }
}

レスポンス

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"available\":true,\"date\":\"2025-12-25\",\"options\":[{\"option\":\"Standard Package\",\"available\":true,\"pax_types\":[{\"type\":\"Adult\",\"note\":\"12+ years\",\"price\":55,\"discount_price\":49,\"currency\":\"AED\"},{\"type\":\"Child\",\"note\":\"3-11 years\",\"price\":40,\"discount_price\":null,\"currency\":\"AED\"},{\"type\":\"Infant\",\"note\":\"Under 3\",\"price\":0,\"discount_price\":null,\"currency\":\"AED\"}]},{\"option\":\"VIP Package\",\"available\":true,\"pax_types\":[{\"type\":\"Adult\",\"note\":\"12+ years\",\"price\":120,\"discount_price\":null,\"currency\":\"AED\"}]}],\"booking_url\":\"https://jtrholidays.com/activity/dubai-evening-desert-safari\"}"
      }
    ]
  }
}

---

3. すべての目的地を一覧表示する

リクエスト

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 3,
  "params": {
    "name": "get_destinations",
    "arguments": {}
  }
}

レスポンス

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"destinations\":[{\"destination\":\"United Arab Emirates\",\"country_code\":\"AE\",\"activity_count\":148,\"popular_activities\":[{\"activity_id\":\"a1b2c3d4-0001-0001-0001-000000000001\",\"title\":\"Dubai Evening Desert Safari with BBQ Dinner\",\"price_from\":55,\"currency\":\"AED\",\"booking_url\":\"https://jtrholidays.com/activity/dubai-evening-desert-safari\"},{\"activity_id\":\"a1b2c3d4-0001-0001-0001-000000000010\",\"title\":\"Burj Khalifa At the Top Tickets\",\"price_from\":149,\"currency\":\"AED\",\"booking_url\":\"https://jtrholidays.com/activity/burj-khalifa-at-the-top\"}]},{\"destination\":\"Maldives\",\"country_code\":\"MV\",\"activity_count\":32,\"popular_activities\":[{\"activity_id\":\"a1b2c3d4-0001-0001-0002-000000000001\",\"title\":\"Maldives Sunset Dolphin Cruise\",\"price_from\":65,\"currency\":\"USD\",\"booking_url\":\"https://jtrholidays.com/activity/maldives-sunset-dolphin-cruise\"}]},{\"destination\":\"Singapore\",\"country_code\":\"SG\",\"activity_count\":27,\"popular_activities\":[{\"activity_id\":\"a1b2c3d4-0001-0001-0003-000000000001\",\"title\":\"Singapore Zoo Day Ticket\",\"price_from\":48,\"currency\":\"SGD\",\"booking_url\":\"https://jtrholidays.com/activity/singapore-zoo-ticket\"}]}]}"
      }
    ]
  }
}

---

対応している目的地

JTR Holidays は24か国でツアーやアクティビティを提供しています。

地域	国
中東	🇦🇪 アラブ首長国連邦 · 🇴🇲 オマーン · 🇯🇴 ヨルダン
南アジア・東南アジア	🇸🇬 シンガポール · 🇻🇳 ベトナム · 🇹🇭 タイ · 🇲🇾 マレーシア · 🇮🇩 インドネシア · 🇲🇻 モルディブ
東アジア	🇯🇵 日本 · 🇰🇷 韓国 · 🇭🇰 香港
ヨーロッパ	🇫🇷 フランス · 🇮🇹 イタリア · 🇪🇸 スペイン · 🇳🇱 オランダ · 🇨🇭 スイス · 🇬🇷 ギリシャ · 🇦🇹 オーストリア · 🇹🇷 トルコ
オセアニア	🇦🇺 オーストラリア · 🇳🇿 ニュージーランド
アメリカ大陸・英国	🇬🇧 英国 · 🇺🇸 アメリカ合衆国

get_destinations を使用すると、各国の最新のアクティビティ件数や人気のアクティビティを取得できます。

---

エラーコード

コード	HTTP	意味
-32600	400	無効な JSON-RPC リクエスト
-32601	404	メソッドが見つかりません
-32602	422	パラメーターが無効、またはリソースが見つかりません
-32603	500	内部サーバーエラー

---

お問い合わせ・サポート

• ウェブサイト： jtrholidays.com
• MCP ドキュメント： jtrholidays.com/mcp-docs
• メール： [email protected]
• 電話： +971 4 385 2466
• お問い合わせフォーム： jtrholidays.com/contact-us

API アクセスの申請や問題の報告は、GitHub Issue を作成するか、直接メールでお問い合わせください。

---

JTR Holidays 提供 ·