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

Code

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)

Code

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

MCP Handshake

config.json

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

List available tools

config.json

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

Call a tool

All tool calls use the tools/call method:

config.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.

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

Rate limit: 100 requests/minute per IP.

Code

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

config.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

config.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

config.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

config.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

config.json

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

Response

config.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:

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.

Jtr Holidays README

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