{ "markdown": "# JTR Holidays MCP Server\n\n> Connect your AI assistant to JTR Holidays' live catalogue of attraction tickets, tours, and multi-day holiday packages via the [Model Context Protocol](https://modelcontextprotocol.io).\n\n[![MCP Protocol](https://img.shields.io/badge/MCP-2024--11--05-blue)](https://modelcontextprotocol.io)\n[![JSON-RPC](https://img.shields.io/badge/JSON--RPC-2.0-green)](https://www.jsonrpc.org/specification)\n[![Destinations](https://img.shields.io/badge/Destinations-24%20Countries-orange)](https://www.jtrholidays.com)\n\nJTR 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.\n\n---\n\n## Table of Contents\n\n- [Quick Start](#quick-start)\n- [Authentication](#authentication)\n- [Available Tools](#available-tools)\n- [Examples](#examples)\n- [Supported Destinations](#supported-destinations)\n- [Contact & Support](#contact--support)\n\n---\n\n## Quick Start\n\n### Endpoint\n\n```\nPOST https://api.jtrholidays.com/mcp/v1\nContent-Type: application/json\n```\n\n> No API key needed. All five browse/search tools are publicly accessible.\n\n### Auto-discovery (no auth required)\n\n```\nGET https://api.jtrholidays.com/.well-known/mcp.json\n```\n\n### MCP Handshake\n\n```json\n{\n \"jsonrpc\": \"2.0\",\n \"method\": \"initialize\",\n \"id\": 1,\n \"params\": {\n \"protocolVersion\": \"2024-11-05\",\n \"clientInfo\": { \"name\": \"your-client\", \"version\": \"1.0\" }\n }\n}\n```\n\n### List available tools\n\n```json\n{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/list\",\n \"id\": 2\n}\n```\n\n### Call a tool\n\nAll tool calls use the `tools/call` method:\n\n```json\n{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"id\": 3,\n \"params\": {\n \"name\": \"\",\n \"arguments\": { }\n }\n}\n```\n\n---\n\n## Authentication\n\nThis server uses a **two-tier access model**:\n\n### Tier 1 โ€” Public (no authentication required)\n\nAll five current tools are publicly accessible. No API key, no sign-up, no waiting.\n\n| Header | Value |\n|--------|-------|\n| `Content-Type` | `application/json` |\n\nRate limit: **100 requests/minute per IP**.\n\n```\nPOST https://api.jtrholidays.com/mcp/v1\nContent-Type: application/json\n```\n\n### Tier 2 โ€” Protected (future write tools)\n\nFuture write and mutation tools (e.g. `create_booking`, `update_inventory`) will require a secret header. These tools do not exist yet.\n\n| Header | Value |\n|--------|-------|\n| `X-MCP-Secret` | Your secret key |\n| `Content-Type` | `application/json` |\n\nRate limit: **1000 requests/minute per IP** for authenticated callers.\n\nTo request authenticated access for integrations, contact us at [it@jtrholidays.com](mailto:it@jtrholidays.com).\n\n> The discovery endpoint (`GET /.well-known/mcp.json`) is always public.\n\n---\n\n## Available Tools\n\n### `search_activities`\n\nSearch JTR Holidays' activity and tour catalogue by destination, category, and budget.\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `destination` | string | No | City or country name (e.g. `\"Dubai\"`, `\"Singapore\"`) |\n| `category` | string | No | Activity category (e.g. `\"Desert Safari\"`, `\"Sightseeing\"`) |\n| `budget_max` | number | No | Maximum price per person in the activity's local currency |\n| `limit` | integer | No | Max results to return (default: `20`, max: `50`) |\n\n---\n\n### `get_activity_details`\n\nGet full details for a single activity including inclusions, exclusions, cancellation policy, and reviews.\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `activity_id` | string | **Yes** | Activity UUID from `search_activities` results |\n\n---\n\n### `check_availability`\n\nCheck if an activity is available on a specific date and return live pricing options.\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `activity_id` | string | **Yes** | Activity UUID |\n| `date` | string | **Yes** | Date in `Y-m-d` format (e.g. `\"2025-12-25\"`) |\n| `pax` | integer | No | Number of people (default: `1`) |\n\n---\n\n### `get_destinations`\n\nList all destinations (countries) where JTR Holidays offers tours, with activity counts and popular picks. Takes no parameters.\n\n---\n\n### `get_holiday_packages`\n\nBrowse multi-day holiday packages with itineraries, departure dates, and pricing.\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `destination` | string | No | Filter by country or region |\n| `duration_days` | integer | No | Filter by exact number of days |\n| `limit` | integer | No | Max results to return (default: `20`, max: `50`) |\n\n---\n\n## Examples\n\n### 1. Search activities in Dubai\n\n**Request**\n```json\n{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"id\": 1,\n \"params\": {\n \"name\": \"search_activities\",\n \"arguments\": {\n \"destination\": \"Dubai\",\n \"category\": \"Desert Safari\",\n \"budget_max\": 200,\n \"limit\": 2\n }\n }\n}\n```\n\n**Response**\n```json\n{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"result\": {\n \"content\": [\n {\n \"type\": \"text\",\n \"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}\"\n }\n ]\n }\n}\n```\n\n---\n\n### 2. Check availability for an activity\n\n**Request**\n```json\n{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"id\": 2,\n \"params\": {\n \"name\": \"check_availability\",\n \"arguments\": {\n \"activity_id\": \"a1b2c3d4-0001-0001-0001-000000000001\",\n \"date\": \"2025-12-25\",\n \"pax\": 2\n }\n }\n}\n```\n\n**Response**\n```json\n{\n \"jsonrpc\": \"2.0\",\n \"id\": 2,\n \"result\": {\n \"content\": [\n {\n \"type\": \"text\",\n \"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\\\"}\"\n }\n ]\n }\n}\n```\n\n---\n\n### 3. List all destinations\n\n**Request**\n```json\n{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"id\": 3,\n \"params\": {\n \"name\": \"get_destinations\",\n \"arguments\": {}\n }\n}\n```\n\n**Response**\n```json\n{\n \"jsonrpc\": \"2.0\",\n \"id\": 3,\n \"result\": {\n \"content\": [\n {\n \"type\": \"text\",\n \"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\\\"}]}]}\"\n }\n ]\n }\n}\n```\n\n---\n\n## Supported Destinations\n\nJTR Holidays offers tours and activities across **24 countries**:\n\n| Region | Countries |\n|--------|-----------|\n| **Middle East** | ๐Ÿ‡ฆ๐Ÿ‡ช United Arab Emirates ยท ๐Ÿ‡ด๐Ÿ‡ฒ Oman ยท ๐Ÿ‡ฏ๐Ÿ‡ด Jordan |\n| **South & Southeast Asia** | ๐Ÿ‡ธ๐Ÿ‡ฌ Singapore ยท ๐Ÿ‡ป๐Ÿ‡ณ Vietnam ยท ๐Ÿ‡น๐Ÿ‡ญ Thailand ยท ๐Ÿ‡ฒ๐Ÿ‡พ Malaysia ยท ๐Ÿ‡ฎ๐Ÿ‡ฉ Indonesia ยท ๐Ÿ‡ฒ๐Ÿ‡ป Maldives |\n| **East Asia** | ๐Ÿ‡ฏ๐Ÿ‡ต Japan ยท ๐Ÿ‡ฐ๐Ÿ‡ท South Korea ยท ๐Ÿ‡ญ๐Ÿ‡ฐ Hong Kong |\n| **Europe** | ๐Ÿ‡ซ๐Ÿ‡ท France ยท ๐Ÿ‡ฎ๐Ÿ‡น Italy ยท ๐Ÿ‡ช๐Ÿ‡ธ Spain ยท ๐Ÿ‡ณ๐Ÿ‡ฑ Netherlands ยท ๐Ÿ‡จ๐Ÿ‡ญ Switzerland ยท ๐Ÿ‡ฌ๐Ÿ‡ท Greece ยท ๐Ÿ‡ฆ๐Ÿ‡น Austria ยท ๐Ÿ‡น๐Ÿ‡ท Turkey |\n| **Oceania** | ๐Ÿ‡ฆ๐Ÿ‡บ Australia ยท ๐Ÿ‡ณ๐Ÿ‡ฟ New Zealand |\n| **Americas & UK** | ๐Ÿ‡ฌ๐Ÿ‡ง United Kingdom ยท ๐Ÿ‡บ๐Ÿ‡ธ United States |\n\nUse `get_destinations` to retrieve live activity counts and popular picks for each country.\n\n---\n\n## Error Codes\n\n| Code | HTTP | Meaning |\n|------|------|---------|\n| `-32600` | 400 | Invalid JSON-RPC request |\n| `-32601` | 404 | Method not found |\n| `-32602` | 422 | Invalid parameters or resource not found |\n| `-32603` | 500 | Internal server error |\n\n---\n\n## Contact & Support\n\n- **Website**: [jtrholidays.com](https://www.jtrholidays.com)\n- **MCP Docs**: [jtrholidays.com/mcp-docs](https://www.jtrholidays.com/mcp-docs)\n- **Email**: [it@jtrholidays.com](mailto:it@jtrholidays.com)\n- **Phone**: +971 4 385 2466\n- **Contact form**: [jtrholidays.com/contact-us](https://www.jtrholidays.com/contact-us)\n\nTo request API access or report an issue, open a [GitHub Issue](https://github.com/JTR-Holidays/jtr-holidays-mcp/issues) or email us directly.\n\n---\n\n*Powered by [JTR Holidays](https://www.jtrholidays.com) ยท*\n", "bytes": 10383, "sha": "dc91c8e3d3909dbc698c645a5cfde0aa59adffaff8dfdf75c287c2432100a525", "repo_slug": "jtr-holidays/jtr-holidays-mcp", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_io_github_naeem_jtr_jtr_holidays_2a8c2b08/readme" }