eghamat24-mcp: Eghamat24 (اقامت۲۴) Iran hotel search and room prices MCP server for AI agents
eghamat24-mcp is an unofficial, read-only MCP server that gives AI agents the hotel data of Eghamat24 (eghamat24.com), the Iranian hotel booking site.
Its 14 tools search hotels by city, dates, stars, price and facilities, list discounts and special offers, read a hotel's facilities, photos and rules,
price its rooms for a stay, chart the cheapest nights, find flight-plus-hotel tours, browse city sights and read guest reviews and questions.
No API key or account is needed. It works in Claude, Cursor, Copilot and any other MCP client.
For AI agents · Quick start · Tools · FAQ · فارسی
For AI agents
- What: unofficial MCP server (model context protocol) for eghamat24.com: hotel and stay search per city and date with filters, discounts, hotel profile (facilities, rules, scores, nearby places), room prices for a stay, a night-by-night price calendar, photos, similar hotels, free-cancellation and one-night offers, flight-plus-hotel tours with a price calendar, city attractions (and hotels near one), guest reviews and Q&A.
- Install:
uvx eghamat24-mcporclaude mcp add eghamat24 -- uvx eghamat24-mcp. Transport: stdio. Needs uv (Python 3.10+). - Auth: none. Optional
EGHAMAT24_MCP_PROXY(HTTP proxy URL); system proxy settings are ignored. - Access: read-only. It cannot book, log in or post, so no confirmation is needed before calling any tool.
- Tools: 14, all prefixed
eg_. Typical sequence:eg_cities->eg_search->eg_rooms/eg_hotel/eg_reviews. - Use when: the user asks which hotels exist in an Iranian city, what a hotel or room costs on given dates, which hotel is cheapest, has a pool, is near the shrine or has the best reviews, when a hotel is cheapest, or what guests say.
- Do not use when: the user wants to book, or asks about hotels abroad or plain flight tickets.
- Output: compact JSON. Prices are Toman (the site's unit; its API sends Rial). Dates are Gregorian
YYYY-MM-DD; Jalali such as1405-08-19is accepted. Names, rules and reviews are Persian. - Machine-readable:
server.json.
Why
On eghamat24.com, "cheapest 4-star hotel with a pool near the shrine in Mashhad for two nights" means setting filters,
sorting, and opening hotel after hotel to see room prices. With eghamat24-mcp an agent does it in a few calls:
You: Cheap hotel with a pool near the Imam Reza shrine for 2 nights from 19 Aban?
Agent: calls
eg_search("Mashhad", "1405-08-19", 2, facilities=["استخر"], area="حرم", sort="price_asc"), theneg_roomsfor the best two.
Quick start
claude mcp add eghamat24 -- uvx eghamat24-mcp
Other clients: command uvx, args ["eghamat24-mcp"]. If eghamat24.com is only reachable through a proxy on your network,
set EGHAMAT24_MCP_PROXY=http://host:port.
Tools
| Tool | What it does |
|---|---|
eg_cities |
Destinations (cities or provinces) with hotel counts; gives the city slug |
eg_search |
Hotels in a city for dates: stars, type, price, name, facilities, beds, meal plan, area; sort by price, rating, discount, reviews; sold-out status |
eg_deals |
Biggest discounts in a city for dates |
eg_hotel |
Profile: address, times, description, facilities, rules, scores out of 10, perks, services, nearby places with distances |
eg_rooms |
Bookable rooms and rate plans with total and per-night price, list price, rooms left, free cancellation; guests filter |
eg_price_calendar |
Cheapest room price for each night over up to 31 days |
eg_reviews |
Guest reviews 10 per page, score breakdown, trip types |
eg_questions |
Public guest questions and answers |
eg_photos |
Photo URLs of a hotel and of each room type |
eg_similar |
Alternative hotels the site suggests, with starting prices |
eg_attractions |
City sights, malls and shrines with coordinates and descriptions; the id feeds eg_search attraction_id |
eg_specials |
Offer pages: free cancellation (per city), one-night offers, latest discounts |
eg_tours |
Flight plus hotel packages from an origin city: hotels with total and per-person price, or one hotel's packages with flight times |
eg_tour_calendar |
Cheapest package for each departure day |
Prices are what the site shows for the dates asked and can change; availability is re-checked on the site at booking.
price_from is the cheapest room (often a single bed) per night; eg_search with guests adds price_for_guests.
FAQ
Can it book a room? No. It only reads public pages' data. Booking stays on eghamat24.com.
Do I need an account or key? No.
Does it work outside Iran? Yes; the site answered both from an Iranian line and through a Turkish proxy when tested. If your network blocks it, set EGHAMAT24_MCP_PROXY.
Is it official? No. It is an independent project and not affiliated with Eghamat24.
فارسی
eghamat24-mcp یک سرور MCP غیررسمی و فقط‌خواندنی برای اقامت۲۴ است: جستجوی هتل بر اساس شهر، تاریخ، ستاره، قیمت و امکانات، تخفیف‌ها، مشخصات هتل، قیمت اتاق‌ها برای مدت اقامت، تقویم قیمت و نظرات مسافران. رزرو انجام نمی‌دهد. قیمت‌ها به تومان هستند.
نصب: claude mcp add eghamat24 -- uvx eghamat24-mcp
License
MIT. Author: Sepehr Radmard (سپهر رادمرد), github.com/sepehr071, linkedin.com/in/sepehr-radmard.
1 maintainer
Metadata
1 maintainer
Release files for eghamat24-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 |
|---|---|---|---|---|
| eghamat24_mcp-0.1.0.tar.gz | 126.4 kB | With provenance | Details for eghamat24_mcp-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| eghamat24_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for eghamat24_mcp-0.1.0-py3-none-any.whl |
Total release size: 153.2 kB
Release files / eghamat24_mcp-0.1.0.tar.gz
| Download URL | eghamat24_mcp-0.1.0.tar.gz |
|---|---|
| Size | 126.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fbad52d23ca9b0d919f8a51c60b8a6a68844018aff40bda5ccc8bbe467e50aa8
|
|
BLAKE2b-256 checksum How to use checksums |
0f2deee264ebd2e4c6db87ec8fa4db19917264526a038a3fcdd15c2b9a529b57
|
| 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 1, 2026.
Transparency logRelease files / eghamat24_mcp-0.1.0-py3-none-any.whl
| Download URL | eghamat24_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 26.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ba606dfcab6462194d6fb9ebd0f1ff9553c7d43508a3700560a0f3854aca20bd
|
|
BLAKE2b-256 checksum How to use checksums |
508d7193e9f6775ea8cfd5be69b536668f041518bb50325935f0b220b55e827a
|
| 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 1, 2026.
Transparency logSecurity for eghamat24-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
All 2 files in this release have been uploaded with provenance metadata.
Attestation for eghamat24_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 1, 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.
