Skip to main content
Glama
Sign In
jolly-tur-mcp

jolly-tur-mcp

by mohammad-abbasi-sh
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

jolly-tur-mcp 🇹🇷

mcp-name: io.github.mohammad-abbasi-sh/jolly-tur-mcp

Unofficial read-only MCP server for Jolly Tur (jollytur.com), one of Türkiye's top-3 tour operators — hotel search with live prices, hotel detail and current campaigns.

Part of the "Turkey MCP factory". Not affiliated with Jolly Tur.

For AI agents

Add to your MCP client config (stdio):

{
  "mcpServers": {
    "jolly": {
      "command": "uvx",
      "args": ["jolly-tur-mcp==0.1.1"]
    }
  }
}

Or run locally: python -m jolly_mcp.server (needs mcp<2, curl-cffi).

Related MCP server: webhotelier-mcp

Tools

Tool

Description

jolly_search_hotels

Search hotels in a city — city slug ("antalya", "istanbul", "bodrum"…), check_in/check_out (YYYY-MM-DD, both needed for prices), page, hotel_name

jolly_get_hotel

Detail for one hotel — hotel_slug (e.g. "the-x-belek") or full URL

jolly_list_campaigns

Current campaigns from /kampanyalar (title + link)

Example output (jolly_search_hotels / Antalya, 2026-11-20 → 2026-11-22):

{"result_count": 1067, "count": 20,
 "hotels": [{"name": "The X Belek", "location": "Antalya, Serik, Belek, Kadriye",
 "rating": 9.6, "rating_count": 4186, "rating_text": "Mükemmel",
 "concept": "Ultra Her Şey Dahil",
 "total_price_tl": 21576.0, "discounted_price_tl": 13377.12}]}

Notes:

  • Prices are Turkish Lira (TRY) for the requested stay; without dates the cards show no price (prices_available: false).

  • Searches are slow (~10–15s: the site renders results server-side per query, and the endpoint occasionally stalls — the server retries once). Prefer one search per question.

  • Data: Jolly's own listing/search flow (listing page + GetListPagePartials POST) — no key, no login, read-only.

Development

python3 -m venv .venv && .venv/bin/pip install "mcp<2" curl-cffi pytest
.venv/bin/python -m pytest tests/ -q

  • tests/test_hotels.py — offline, parses real captured pages

  • tests/test_live.py — 4 cautious live requests against jollytur.com

License

MIT

Built by Mohammad Abbasi — Almanibama · mabbasi.ir

Available Tools

3 tools
jolly_get_hotelA

Detail for one Jolly hotel. hotel_slug: e.g. "the-x-belek" (from search results) or a full jollytur.com hotel URL.

Inputs: hotel_slug (required). Returns: result

jolly_list_campaignsA

Current Jolly Tur campaigns from /kampanyalar (title + link).

Inputs: no named parameters. Returns: result

jolly_search_hotelsA

Search Jolly hotels in a city. city: slug like "antalya", "istanbul", "bodrum". check_in/check_out: YYYY-MM-DD (both needed for prices). page: results page (20 hotels/page). hotel_name: optional name filter (4+ chars). Returns hotels with rating, concept, campaigns and prices.

Inputs: city (required), page, check_in, check_out, +1 more. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.9/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool maps to a distinct operation: city-level search, single-hotel detail lookup, and campaign listing. There is no plausible way to confuse them, and the search-to-detail handoff (hotel_slug from search results) is explicitly documented.

    Naming Consistency5/5

    All three tools use the same jolly_<verb>_<noun> convention (jolly_search_hotels, jolly_get_hotel, jolly_list_campaigns). The server prefix is applied uniformly and verbs are used consistently for their action type.

    Tool Count4/5

    Three tools is on the thin side, but for a read-only hotel discovery server each tool earns its place and nothing is redundant. A small set of extra tools (e.g. destination/availability lookup) would round it out without bloat.

    Completeness4/5

    The core read-only lifecycle is covered: find hotels by city, drill into a hotel, and surface current promotions. Gaps remain around room/availability details and booking or filtering beyond name and city, but agents can work around these for search-oriented tasks.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • webhotelier-mcp

      gabrielnika
      F
      license
      A
      quality
      D
      maintenance
      A read-only MCP server that lets AI assistants query the WebHotelier REST API for live hotel data, including property info, room availability, rates, calendars, and offers via natural language tools.
      8
      -

    • Hotelbeds MCP Server

      karanrao
      A
      license
      A
      quality
      C
      maintenance
      Enables MCP clients to search hotel availability, validate rates, create and retrieve bookings, simulate or execute cancellations, and browse destinations and hotel content through the Hotelbeds Booking and Content APIs. Includes a surface-and-reconfirm booking flow that re-validates live prices with a tolerance before confirming.
      9
      MIT