jtr holidays

社区Incomplete39/100认领

streamable-httpupdated 4mo ago

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

源码官网

jtr holidays 能做什么？

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.

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.

Quick Start
Authentication
Available Tools
Examples
Supported Destinations
Contact & Support

Quick Start

Endpoint

POST https://api.jtrholidays.com/mcp/v1
Content-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

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

List available tools

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

Call a tool

All tool calls use the tools/call method:

{
  "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.

Header	Value
`Content-Type`	`application/json`

Rate limit: 100 requests/minute per IP.

POST https://api.jtrholidays.com/mcp/v1
Content-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.

Header	Value
`X-MCP-Secret`	Your secret key
`Content-Type`	`application/json`

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

To request authenticated access for integrations, contact us at it@jtrholidays.com.

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.

Parameter	Type	Required	Description
`destination`	string	No	City or country name (e.g. `"Dubai"`, `"Singapore"`)
`category`	string	No	Activity category (e.g. `"Desert Safari"`, `"Sightseeing"`)
`budget_max`	number	No	Maximum price per person in the activity's local currency
`limit`	integer	No	Max results to return (default: `20`, max: `50`)

`get_activity_details`

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

Parameter	Type	Required	Description
`activity_id`	string	Yes	Activity UUID from `search_activities` results

`check_availability`

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

Parameter	Type	Required	Description
`activity_id`	string	Yes	Activity UUID
`date`	string	Yes	Date in `Y-m-d` format (e.g. `"2025-12-25"`)
`pax`	integer	No	Number 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.

Parameter	Type	Required	Description
`destination`	string	No	Filter by country or region
`duration_days`	integer	No	Filter by exact number of days
`limit`	integer	No	Max results to return (default: `20`, max: `50`)

Examples

1. Search activities in Dubai

Request

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

Response

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

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

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

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

Response

{
  "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:

Region	Countries
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

Code	HTTP	Meaning
`-32600`	400	Invalid JSON-RPC request
`-32601`	404	Method not found
`-32602`	422	Invalid parameters or resource not found
`-32603`	500	Internal server error

Contact & Support

Website: jtrholidays.com
MCP Docs: jtrholidays.com/mcp-docs
Email: it@jtrholidays.com
Phone: +971 4 385 2466
Contact form: jtrholidays.com/contact-us

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

Powered by JTR Holidays ·

安装

把 jtr holidays 添加到你的客户端。选择你正在使用的那个。

claude mcp add --transport http jtr-holidays https://api.jtrholidays.com/mcp/v1

codex mcp add jtr-holidays --url https://api.jtrholidays.com/mcp/v1

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

Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.

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

Add to `.vscode/mcp.json` in your workspace.

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

Add to `claude_desktop_config.json`, then restart Claude Desktop.

{
  "mcpServers": {
    "jtr-holidays": {
      "serverUrl": "https://api.jtrholidays.com/mcp/v1"
    }
  }
}

Add to `~/.codeium/windsurf/mcp_config.json`.

版本	发布于
1.1.0最新	2026年4月14日
1.0.1	2026年4月11日
1.0.0	2026年4月11日

jtr holidays

jtr holidays 能做什么？

JTR Holidays MCP Server

Table of Contents

Quick Start

Endpoint

Auto-discovery (no auth required)

MCP Handshake

List available tools

Call a tool

Authentication

Tier 1 — Public (no authentication required)

Tier 2 — Protected (future write tools)

Available Tools

`search_activities`

`get_activity_details`

`check_availability`

`get_destinations`

`get_holiday_packages`

Examples

1. Search activities in Dubai

2. Check availability for an activity

3. List all destinations

Supported Destinations

Error Codes

Contact & Support

安装

评分

版本历史