io.github.naeem-jtr/jtr-holidays

Official

by JTR-Holidays

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

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

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

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.

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

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:

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 ·

Install

claude_desktop_config.json

{
  "mcpServers": {
    "jtr-holidays": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.jtrholidays.com/mcp/v1"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

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

Install

`search_activities`

`get_activity_details`

`check_availability`

`get_destinations`

`get_holiday_packages`