Eghamat24 Hotels

---

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-mcp or claude 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 as 1405-08-19 is 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"), then eg_rooms for 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 (in eg_specials it can be null when the site lists no price and tomorrow is sold out); 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.