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.

---

Table of Contents

• Quick Start
• Authentication
• Available Tools
• Examples
• Supported Destinations
• Contact & Support

---

Quick Start

Endpoint

POST https://api.jtrholidays.com/mcp/v1
Content-Type: application/json
x-jtr-aihub-secret: <your-secret-key>

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

Every request to POST /mcp/v1 must include the secret header:

Header	Value
x-jtr-aihub-secret	Your secret key
Content-Type	application/json

To request API access, contact us at it@jtrholidays.com or visit jtrholidays.com/contact-us.

The discovery endpoint (GET /.well-known/mcp.json) is public and requires no authentication.

---

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

... View full README on GitHub