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 分

    请在仓库或注册中心条目中声明许可证。