Skip to main content

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"]
    }
  }
}

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

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

Metadata

Release files for jolly-tur-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for jolly-tur-mcp 0.1.0
File Size Uploaded Provenance Actions
jolly_tur_mcp-0.1.0.tar.gz 315.3 kB With provenance Details for jolly_tur_mcp-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for jolly-tur-mcp 0.1.0
File Interpreter ABI Platform Actions
jolly_tur_mcp-0.1.0-py3-none-any.whl Python 3 none any Details for jolly_tur_mcp-0.1.0-py3-none-any.whl

Total release size: 324.9 kB

Release files / jolly_tur_mcp-0.1.0.tar.gz

Download URL jolly_tur_mcp-0.1.0.tar.gz
Size 315.3 kB
Tags Source
SHA-256 checksum
How to use checksums
432aec540fe8ecb0ad0ad6c0fcf8e6dcc2a1aacdde89dfef1b491ebe0c2e8022
BLAKE2b-256 checksum
How to use checksums
213360b9950bce5f2a4fa4c1e82955104c22c6357264859d3df559252feea0d3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

Release files / jolly_tur_mcp-0.1.0-py3-none-any.whl

Download URL jolly_tur_mcp-0.1.0-py3-none-any.whl
Size 9.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
662c4dd060252197e3732eaa669bca358056f8fd554d5737ffe39ea0d1ed4e67
BLAKE2b-256 checksum
How to use checksums
a76f5f341bd9db555439b6f48bea65ea8e5d093c5de316cbaaf7e11df01b24bf
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

Security for jolly-tur-mcp 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for jolly_tur_mcp-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 8, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page