🏡 otaghak-mcp: Otaghak MCP server for AI agents

Unofficial, read-only MCP server for Otaghak (اتاقک): let your AI agent find a place to stay in Iran.
Search villas, cottages and apartments across Iran, check which nights are free, get the exact price
for your dates and guests, and read reviews and host stats, all from Claude, Cursor or Copilot.

Quick start · What it can do · Tools · FAQ · فارسی

For AI agents

• What: unofficial, read-only MCP server for Otaghak (اتاقک), an Iranian marketplace for villas, cottages and apartments. Queries work best in Persian, English slugs work too; prices are in Toman.
• Install: claude mcp add otaghak -- uvx otaghak-mcp (stdio transport; needs Python 3.10+ and uv).
• Auth: none, no API key. Optional OTAGHAK_MCP_PROXY (HTTP proxy) if Otaghak blocks your network.
• Access: read-only. No login, booking, payment or SMS codes, so no confirmation is needed before calling tools.
• Tools: 15, all prefixed ot_*. Start with ot_find_place, then ot_search_rooms → ot_room or ot_room_calendar → ot_price_quote. For bargains use ot_deals.
• Use when: finding a stay in Iran and getting the exact total for dates and guests, with reviews and host stats.
• Do not use when: you need to book or pay (the user does that on otaghak.com), or want prices past the open calendar (end of the next Jalali month, at most 20 nights).
• Output: compact JSON. Prices in Toman, dates Gregorian YYYY-MM-DD (check_out is the departure day), ratings 0-5. Pass the numeric room id between tools.
• Machine-readable: server.json; catalog of all Iranian MCP servers: awesome-iran-mcp (TOOLS.md, servers.json, llms.txt).

Why use Otaghak MCP

On Otaghak the price on a listing card is rarely what you pay: every night has its own price, weekends cost more, discounts change per night, extra guests cost extra per night, and calendars only open about a month ahead. Getting the real total for my dates and my group means clicking through calendars one room at a time. An agent with otaghak-mcp does the clicking:

You: We are 4 people, Ramsar, 20 to 23 October. How much is the "سوییسی لیلی" cottage in total?

Agent: calls ot_search_rooms(city=["ramsar"], name="لیلی") → ot_price_quote(room_id=2508916, check_in="2026-10-20", check_out="2026-10-23", guests=4)

Night	Price	Before discount
Tue 20 Oct	4,000,000	5,000,000
Wed 21 Oct	4,000,000	5,000,000
Thu 22 Oct	4,250,000	5,000,000
1 extra guest (3 nights)	980,000	1,200,000
Total to pay	13,230,000

The cottage includes 3 guests and takes at most 4, so the 4th person costs 400,000 a night (discounted like the nights). All three nights are free and bookable instantly. Want me to compare it with ot_similar_rooms?

_{Real tool output from 2026-10-04; prices change all the time. Prices are in Toman.}

What it can do

• 🔎 Search stays in a city, province or themed collection (beach, jungle, villa with pool, ...) for your dates and group, sorted by price, rating or discount
• 🧮 Exact price for dates and guests: every night after discount, extra-guest charges, optional late checkout
• 📅 Calendars: which nights are free, nightly prices, minimum and maximum stay, weekends and holidays
• 🏠 Room details: rooms and beds, amenities, house rules, check-in times, cancellation policy, nearby shops, photos
• ⭐ Quality: rating, six category scores, percent who recommend it, reviews with host replies, host response time and acceptance rate
• 🏷️ Deals: last-second discounts and the most discounted stays
• 🧭 Guides: destination guides, FAQ, blog articles and the site's rules (cancellation, refunds)
• 🔒 Read-only by design: no login, no booking, no payment, no SMS codes

Quick start

You need uv.

claude mcp add otaghak -- uvx otaghak-mcp

{
  "mcpServers": {
    "otaghak": { "command": "uvx", "args": ["otaghak-mcp"] }
  }
}

{
  "servers": {
    "otaghak": { "type": "stdio", "command": "uvx", "args": ["otaghak-mcp"] }
  }
}

Then just ask:

• "Cheapest villa with a pool near Ramsar for 6 people next weekend?"
• "Is room 2512254 free from 20 to 23 October, and what's the total for 5 guests?"
• "Pet-friendly cottages in Gilan with a rating of 4 or more."
• یک کلبه جنگلی در ماسال برای ۴ نفر، آخر هفته بعد، با رزرو آنی پیدا کن.

How it works

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  otaghak-mcp  (runs on your machine)
      │
      │  HTTPS (REST + OData)
      └──────▶  core.otaghak.com, www.otaghak.com/blog

otaghak-mcp runs locally and calls the same public endpoints the otaghak.com website uses. There's no hosted server in between, no API key, and nothing about you is sent anywhere else.

Tools

Rooms are identified by numeric ids like 2512254 (the number in otaghak.com/room/2512254/), places by slugs like ramsar (city), mazandaran (province) or beach (collection).

All 15 tools are annotated readOnlyHint: true and return compact structured JSON, so they don't flood the agent's context.

Good to know

• Prices are in Toman, as on the site (1 Toman = 10 Rial). price_per_night is after discount. Without dates, prices are the room's undated starting price, not a quote.
• The amount to pay is ot_price_quote → total: the nights after discount (the room page's payable amount), plus extra guests above the room's included guests (discounted like the nights), plus optional late checkout. Coupons and wallet credit need a login and are not included. Search results carry a stay_total estimate that can be a few Toman off; with dates, sort="cheapest" orders each page by it.
• Dates are Gregorian YYYY-MM-DD and check_out is the departure day. No past dates, at most 20 nights, and hosts' calendars open only to the end of the next Jalali month; the tools say so clearly instead of returning an empty list. A Jalali date gets an error with its Gregorian twin.
• Guests: each room includes base_guests in its price and takes up to max_guests. ot_price_quote checks the limit itself (the site's own search doesn't when you ask for a specific room).
• Ratings are 0–5; null means not rated yet. Holiday flags are only published about 7 weeks ahead.
• Location is approximate (about 100 m); the exact address and the host's phone come only after booking.
• Persian queries match best (رامسر, کلبه), English slugs work too.

FAQ

npx @modelcontextprotocol/inspector uvx otaghak-mcp

Configuration

فارسی: سرور MCP اتاقک

claude mcp add otaghak -- uvx otaghak-mcp

Development

git clone https://github.com/sepehr071/otaghak-mcp && cd otaghak-mcp
uv sync
uv run pytest            # offline, against recorded responses
uv run pytest -m live    # real API
uv run ruff check .

Tools live in src/otaghak_mcp/search.py, room.py, pricing.py and info.py; each is a typed async function with a docstring that tells the agent when to use it. Issues and PRs are welcome, especially new tools and fixes for API changes.

Releases: bump the version in pyproject.toml and server.json, then push a v* tag. GitHub Actions tests, publishes to PyPI and the MCP Registry, and creates the GitHub Release.

Related servers

• Jabama MCP server for villas, tours and events
• Flytoday MCP server for flights, hotels and villas
• MrBilit MCP server for flights, trains, buses and hotels
• All servers: awesome-iran-mcp, the catalog of Iranian MCP servers

If this saves you clicks, a star helps others find it.

Disclaimer

Unofficial and not affiliated with or endorsed by Otaghak. It uses the public endpoints of the otaghak.com website, which can change without notice. Otaghak offers an official booking web service to partners under contract; this is not it. Please keep request rates reasonable.

License

MIT