jtr-holidays

JTR Holidays MCP 服务

通过 Model Context Protocol，将 AI 助手连接到 JTR Holidays 实时更新的景点门票、旅行团和多日假期套餐目录。

JTR Holidays 是一家总部位于迪拜的全球旅行平台，在 Trustpilot 上获得 5 星评级（734+ 条评价）。此 MCP 服务让 AI 助手能够实时搜索活动、查询可用情况，并浏览 24 个国家/地区的假期套餐，所有操作均通过单个 JSON-RPC 2.0 端点完成。

---

目录

• 快速开始
• 身份验证
• 可用工具
• 示例
• 支持的目的地
• 联系与支持

---

快速开始

端点

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

无需 API 密钥。所有五个浏览/搜索工具均可公开访问。

自动发现（无需身份验证）

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 层 — 公开（无需身份验证）

当前所有五个工具均可公开访问。无需 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	否	以活动当地货币计的每人最高价格
limit	integer	否	返回结果数量上限（默认：20，最大：50）

---

get_activity_details

获取单项活动的完整详情，包括包含项目、不包含项目、取消政策和评价。

参数	类型	必填	描述
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 提供支持 ·