Otaghak

🏡 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.

For AI agents · Why · What it can do · Quick start · Tools · How it works · Good to know · FAQ · Configuration · فارسی · Development · Related servers · Disclaimer · License

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, or a comma-separated list) 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: iran-mcp (TOOLS.md, servers.json, llms.txt).

Why

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 too, at a slightly

different rate than 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 Code

claude mcp add otaghak -- uvx otaghak-mcp

Claude Desktop

Settings → Developer → Edit Config, then add:

{

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

</details>

Cursor

Click Install in Cursor above, or add the Claude Desktop block to ~/.cursor/mcp.json.

VS Code (Copilot agent mode)

Click Install in VS Code above, or add to .vscode/mcp.json:

{

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

</details>

Codex CLI

codex mcp add otaghak -- uvx otaghak-mcp

Or in ~/.codex/config.toml:

[mcp_servers.otaghak]

command = "uvx" args = ["otaghak-mcp"]

</details>

Gemini CLI

Add to ~/.gemini/settings.json:

{

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

</details>

Windsurf

Add the Claude Desktop block to ~/.codeium/windsurf/mcp_config.json.

Anything else

It's a standard stdio MCP server: run uvx otaghak-mcp, or pip install otaghak-mcp and run 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."
• "Show the reviews and the host's response rate for room 2512254, then suggest similar rooms for the same dates."
• "Which Iranian holidays fall in the next month, and is late checkout offered by this room?"
• یک کلبه جنگلی در ماسال برای ۴ نفر، آخر هفته بعد، با رزرو آنی پیدا کن.
• قیمت نهایی ویلای شماره ۲۵۱۲۲۵۴ برای ۵ نفر از ۲۰ تا ۲۳ اکتبر چقدر می‌شود؟
• تخفیف‌دارترین اقامتگاه‌های شمال را نشان بده.

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).

🔎 Search (5)

🏠 Room and host (4)

📅 Dates and prices (4)

🧭 Help and guides (2)

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.