Jtr Holidays MCP server

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

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.

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. createbooking, updateinventory) will require a secret header. These tools do not exist yet.

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.

getactivitydetails

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

check_availability

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

Shortened. The full README is on GitHub.