Jtr Holidays

io.github.naeem-jtrPublished by GitHub account naeem-jtrv1.1.0Updated Oct 29, 2026

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

VerifiedStreamable HTTPWeb executableLocation & LifestyleBusiness & Commerce

Overview

AI-generated overview

Lets an assistant search JTR Holidays' tour and attraction catalogue across 24 countries, check date availability and pricing, and browse multi-day packages.

What you can do
  • Search activities and tours by destination, category and budget, and list all destinations with activity counts
  • Read full details for one activity, including inclusions, exclusions, cancellation policy and reviews
  • Check availability and live pricing options for a given date and party size
  • Browse multi-day holiday packages with itineraries, departure dates and pricing
  • Compare two to five activities side by side and list currently discounted offers
When to use it
Useful when someone is planning a trip and wants an assistant to find tours, attraction tickets or holiday packages in one of the covered countries, compare options, or check whether a specific activity is bookable on a date.
Requirements
A remote streamable HTTP endpoint; no API key, sign-up or environment variables are needed for the current browse and search tools. Network access to the provider's API is required, and requests are rate limited per IP.
Before you install
All current tools are read-only lookups, but results include booking links and prices that may change; confirm details on the provider's site before relying on them. The README says future write tools such as booking creation would require a secret header, which does not exist yet. Queries and destinations are sent to a third-party travel provider.

Installation

In SourceWeft

  1. Open Jtr Holidays in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.naeem-jtr%2Fjtr-holidays/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "jtr-holidays": {
      "type": "http",
      "url": "https://api.jtrholidays.com/mcp/v1"
    }
  }
}

README

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.

[MCP Protocol] [JSON-RPC] [Destinations]

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

Endpoint

POST https://api.jtrholidays.com/mcp/v1Content-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

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.

HeaderValue
Content-Typeapplication/json

Rate limit: 100 requests/minute per IP.

POST https://api.jtrholidays.com/mcp/v1Content-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.

HeaderValue
X-MCP-SecretYour secret key
Content-Typeapplication/json

Rate limit: 1000 requests/minute per IP for authenticated callers.

To request authenticated access for integrations, contact us at [email protected].

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.

ParameterTypeRequiredDescription
destinationstringNoCity or country name (e.g. "Dubai", "Singapore")
categorystringNoActivity category (e.g. "Desert Safari", "Sightseeing")
budget_maxnumberNoMaximum price per person in the activity's local currency
limitintegerNoMax results to return (default: 20, max: 50)

get_activity_details

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

ParameterTypeRequiredDescription
activity_idstringYesActivity UUID from search_activities results

check_availability

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

ParameterTypeRequiredDescription
activity_idstringYesActivity UUID
datestringYesDate in Y-m-d format (e.g. "2025-12-25")
paxintegerNoNumber 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.

ParameterTypeRequiredDescription
destinationstringNoFilter by country or region
duration_daysintegerNoFilter by exact number of days
limitintegerNoMax 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:

RegionCountries
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

CodeHTTPMeaning
-32600400Invalid JSON-RPC request
-32601404Method not found
-32602422Invalid parameters or resource not found
-32603500Internal server error

Contact & Support

To request API access or report an issue, open a GitHub Issue or email us directly.


Powered by JTR Holidays ·

Source: README.md at commit aaa3ca2

Tools

7

search_activities

Search JTR Holidays activity/tour catalog by destination, category, and budget

Parameterslimitcategorybudget_maxdestination

get_activity_details

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

Parametersactivity_idrequired

check_availability

Check if an activity is available on a specific date and get pricing options

Parameterspaxdaterequiredactivity_idrequired

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, departures, and pricing

Parameterslimitdestinationduration_days

compare_activities

Compare 2–5 JTR activities side-by-side on price, discount, rating, inclusions, and cancellation policy. Use this when a user asks "which is better?" or wants to choose between specific activities.

Parametersactivity_idsrequired

get_current_offers

Return activities with active discounts — where the current price is lower than the original price. Sorted by discount percentage. Use this when a user asks for deals, discounts, or best value.

Parameterslimitdestination

Version history

1
  1. v1.1.0LatestSep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.