Jtr Holidays

io.github.naeem-jtr由 GitHub 帳號 naeem-jtr 發布v1.1.0更新於 Oct 29, 2026

Search tours, attraction tickets, and holiday packages across 24 countries.

已驗證Streamable HTTP可網頁執行位置與生活商業與電商

概覽

AI 產生的概覽

讓助理搜尋 JTR Holidays 涵蓋 24 個國家的旅遊與景點目錄,查詢指定日期的可訂狀況與價格,並瀏覽多日度假套裝行程。

可以做什麼
  • 依目的地、類別和預算搜尋活動與行程,並列出所有目的地及其活動數量
  • 查看單一活動的完整資訊,包括包含項目、不包含項目、取消政策和評價
  • 查詢某日期與出行人數的可訂狀態和即時價格選項
  • 瀏覽多日度假套裝行程的行程內容、出發日期和價格
  • 並排比較 2 至 5 個活動,並列出目前有折扣的優惠項目
適用情境
適合在使用者規劃旅行時,讓助理尋找涵蓋國家內的行程、景點門票或度假套裝行程,比較不同選項,或確認某個活動在某天是否可訂。
執行需求
遠端 streamable HTTP 端點;目前的瀏覽與搜尋工具無需 API 金鑰、註冊或環境變數。需要能連線至服務商的網路介面,請求依 IP 限流。
安裝前請注意
現有工具皆為唯讀查詢,但結果包含預訂連結和可能變動的價格,使用前應在服務商網站確認。README 提到未來的寫入類工具(如建立預訂)需要密鑰標頭,目前尚不存在。查詢內容和目的地會傳送給第三方旅遊服務商。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Jtr Holidays,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.naeem-jtr%2Fjtr-holidays/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "jtr-holidays": {
      "type": "http",
      "url": "https://api.jtrholidays.com/mcp/v1"
    }
  }
}

README

JTR Holidays MCP Server

Connect your AI assistant to JTR Holidays' live catalogue of attraction tickets, tours, and multi-day holiday packages via the Model Context Protocol.

[MCP Protocol] [JSON-RPC] [Destinations]

JTR Holidays is a Dubai-based global travel platform rated 5 stars on Trustpilot (734+ reviews). This MCP server gives AI assistants real-time access to search activities, check availability, and browse holiday packages across 24 countries — all via a single JSON-RPC 2.0 endpoint.


Table of Contents


Quick Start

Endpoint

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

No API key needed. All five browse/search tools are publicly accessible.

Auto-discovery (no auth required)

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

MCP Handshake

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

List available tools

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

Call a tool

All tool calls use the tools/call method:

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

Authentication

This server uses a two-tier access model:

Tier 1 — Public (no authentication required)

All five current tools are publicly accessible. No API key, no sign-up, no waiting.

HeaderValue
Content-Typeapplication/json

Rate limit: 100 requests/minute per IP.

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

Tier 2 — Protected (future write tools)

Future write and mutation tools (e.g. create_booking, update_inventory) will require a secret header. These tools do not exist yet.

HeaderValue
X-MCP-SecretYour secret key
Content-Typeapplication/json

Rate limit: 1000 requests/minute per IP for authenticated callers.

To request authenticated access for integrations, contact us at [email protected].

The discovery endpoint (GET /.well-known/mcp.json) is always public.


Available Tools

search_activities

Search JTR Holidays' activity and tour catalogue by destination, category, and budget.

ParameterTypeRequiredDescription
destinationstringNoCity or country name (e.g. "Dubai", "Singapore")
categorystringNoActivity category (e.g. "Desert Safari", "Sightseeing")
budget_maxnumberNoMaximum price per person in the activity's local currency
limitintegerNoMax results to return (default: 20, max: 50)

get_activity_details

Get full details for a single activity including inclusions, exclusions, cancellation policy, and reviews.

ParameterTypeRequiredDescription
activity_idstringYesActivity UUID from search_activities results

check_availability

Check if an activity is available on a specific date and return live pricing options.

ParameterTypeRequiredDescription
activity_idstringYesActivity UUID
datestringYesDate in Y-m-d format (e.g. "2025-12-25")
paxintegerNoNumber of people (default: 1)

get_destinations

List all destinations (countries) where JTR Holidays offers tours, with activity counts and popular picks. Takes no parameters.


get_holiday_packages

Browse multi-day holiday packages with itineraries, departure dates, and pricing.

ParameterTypeRequiredDescription
destinationstringNoFilter by country or region
duration_daysintegerNoFilter by exact number of days
limitintegerNoMax results to return (default: 20, max: 50)

Examples

1. Search activities in Dubai

Request

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

Response

json
{  "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. Check availability for an activity

Request

json
{  "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    }  }}

Response

json
{  "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. List all destinations

Request

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

Response

json
{  "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\"}]}]}"      }    ]  }}

Supported Destinations

JTR Holidays offers tours and activities across 24 countries:

RegionCountries
Middle East🇦🇪 United Arab Emirates · 🇴🇲 Oman · 🇯🇴 Jordan
South & Southeast Asia🇸🇬 Singapore · 🇻🇳 Vietnam · 🇹🇭 Thailand · 🇲🇾 Malaysia · 🇮🇩 Indonesia · 🇲🇻 Maldives
East Asia🇯🇵 Japan · 🇰🇷 South Korea · 🇭🇰 Hong Kong
Europe🇫🇷 France · 🇮🇹 Italy · 🇪🇸 Spain · 🇳🇱 Netherlands · 🇨🇭 Switzerland · 🇬🇷 Greece · 🇦🇹 Austria · 🇹🇷 Turkey
Oceania🇦🇺 Australia · 🇳🇿 New Zealand
Americas & UK🇬🇧 United Kingdom · 🇺🇸 United States

Use get_destinations to retrieve live activity counts and popular picks for each country.


Error Codes

CodeHTTPMeaning
-32600400Invalid JSON-RPC request
-32601404Method not found
-32602422Invalid parameters or resource not found
-32603500Internal server error

Contact & Support

To request API access or report an issue, open a GitHub Issue or email us directly.


Powered by JTR Holidays ·

來源:README.md,提交 aaa3ca2

工具

7

search_activities

Search JTR Holidays activity/tour catalog by destination, category, and budget

輸入參數limitcategorybudget_maxdestination

get_activity_details

Get full details for a single activity including inclusions, exclusions, cancellation policy, and reviews

輸入參數activity_id必填

check_availability

Check if an activity is available on a specific date and get pricing options

輸入參數paxdate必填activity_id必填

get_destinations

List all destinations (countries) where JTR Holidays offers tours, with activity counts and popular picks

無需輸入參數。

get_holiday_packages

Browse multi-day holiday packages with itineraries, departures, and pricing

輸入參數limitdestinationduration_days

compare_activities

Compare 2–5 JTR activities side-by-side on price, discount, rating, inclusions, and cancellation policy. Use this when a user asks "which is better?" or wants to choose between specific activities.

輸入參數activity_ids必填

get_current_offers

Return activities with active discounts — where the current price is lower than the original price. Sorted by discount percentage. Use this when a user asks for deals, discounts, or best value.

輸入參數limitdestination

版本歷史

1
  1. v1.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。