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 +
GetListPagePartialsPOST) — 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 pagestests/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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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 logRelease 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 logSecurity 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.
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 logA 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.