jagir-mcp

<p align="center"> <img src="https://raw.githubusercontent.com/thejimbow/jagir-mcp/main/assets/banner.png" alt="Jagir: search and compare vacation rentals across Jabama, Jajiga and Otaghak from Claude" width="100%"> </p> <p align="center"> <a href="https://www.npmjs.com/package/jagir-mcp"><img src="https://img.shields.io/npm/v/jagir-mcp?color=0E8A63&label=npm" alt="npm version"></a> <a href="https://github.com/thejimbow/jagir-mcp/releases/latest"><img src="https://img.shields.io/github/v/release/thejimbow/jagir-mcp?color=0E8A63&label=Claude%20Desktop%20extension" alt="Claude Desktop extension"></a> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-0E8A63" alt="MIT license"></a> <img src="https://img.shields.io/badge/node-%E2%89%A520-0E8A63" alt="Node 20+"> <img src="https://img.shields.io/badge/MCP-read--only-1DB584" alt="Read-only MCP server"> </p> <p align="center"> <b>English</b> · <a href="#فارسی">فارسی</a> </p>

---

Jagir (جاگیر, "place-finder") is a Model Context Protocol server that lets Claude and other AI assistants search Jabama, Jajiga and Otaghak, Iran's largest vacation-rental platforms, at the same time.

Ask in plain Persian or English. Jagir fans out to all three platforms, normalizes the results (Toman, Gregorian or Jalali dates, one schema), and gives your assistant everything it needs to compare: prices, availability, amenities, cleanliness scores and full guest reviews.

«یه ویلا با ویو جنگل نزدیک رشت برای ۵ نفر، ۱۵ تا ۱۸ مهر، امتیاز بالای ۴.۵ و خیلی تمیز پیدا کن.»

Claude searches all three sites, filters by cleanliness sub-rating, reads the reviews for complaints, quotes the exact total for 5 guests, and hands you a comparison table with booking links.

Why Jagir

• One search, three platforms. Results are merged and sorted together (by price, rating or relevance). If one platform is down, the others still answer.
• Built for Iran. Prices in Toman (Jabama's Rial is converted), dates in Jalali (1405-07-15) or Gregorian (2026-10-07), Persian labels kept as-is.
• Everything a listing has. Amenities and what's missing, house rules, bed layout, area, privacy, view and setting, distance to the sea or city center, check-in times, cancellation policy, discounts and every photo.
• Cleanliness and sub-ratings. Each platform's rating breakdown (cleanliness, accuracy, host, location, value…) plus the star distribution.
• Full guest reviews. Complete review text, dates, host replies and, on Otaghak, the positives and negatives each guest listed.
• Real prices. Per-night calendars and quotes for your exact dates and number of guests, including extra-guest charges and service fees.
• Read-only and private. No login, no booking, no tracking. It never returns host phone numbers or names, and reviewer names are dropped.

Quick start

Claude Desktop: one-click extension (recommended)

1. Download jagir.mcpb from the latest release.
2. Double-click it. Claude Desktop opens an install dialog; click Install.

No Node.js needed: Claude Desktop runs the extension with its built-in runtime.

Claude Code

claude mcp add jagir -- npx -y jagir-mcp

Other MCP clients (manual config)

Requires Node.js 20+.

{
  "mcpServers": {
    "jagir": { "command": "npx", "args": ["-y", "jagir-mcp"] }
  }
}

Claude Desktop's config file lives at ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows). Restart the app after editing it.

Tools

| Tool | What it does | |---|---| | search_stays | Search a city or region on all three platforms at once. Filters: dates, guests, price range, sort, platforms. Returns merged, normalized results. | | get_stay | Everything about one listing: amenities and missing amenities, rules, rating breakdown (incl. cleanliness), beds, area, privacy, view and setting, distances, discounts, all photos. | | get_reviews | Guest reviews with full text, rating, date, host reply and (Otaghak) positive and negative points. Up to 200 per call. | | get_stay_calendar | Per-night availability and price for up to 120 days. | | get_quote | Exact total for given dates and guests: nightly breakdown, extra-guest cost and fees. | | resolve_location | How a place name is known on each platform (useful for villages and regions). |

Stay ids look like jabama:800749, jajiga:3237270 or otaghak:2397109, and every result includes a direct link to the listing.

Example prompts

• «ارزون‌ترین ویلاهای رامسر برای ۴ نفر از ۲۳ تا ۲۵ مهر رو از هر سه سایت مقایسه کن»
• «برای این اقامتگاه همه نظرات رو بخون و بگو کسی از تمیزی یا سروصدا شکایت کرده یا نه»
• «تقویم این ویلا رو برای آبان نشون بده؛ کدوم آخر هفته‌ها خالیه و چنده؟»
• "Find a beachfront stay in Kish for 2 guests next weekend under 3 million Toman a night, sorted by rating."
• "Compare the top 3 cabins near Masuleh by cleanliness score and total price for 3 nights."

How it works

             ┌──────────── search_stays ────────────┐
Claude  ──►  │  Jagir (stdio, runs on your machine)  │
             └───────┬───────────┬───────────┬──────┘
                     ▼           ▼           ▼
                  Jabama      Jajiga      Otaghak
                (public web APIs the sites themselves use)

Each platform has an adapter that calls the same public JSON endpoints its website uses and maps the response to one shared schema. Requests run in parallel. Failures are isolated per platform and reported in an errors field instead of failing the whole search.

Notes on prices:

• With dates, price.total is the stay total for the requested guests, as each platform's search reports it.
• get_quote adds service fees where a platform charges them (Jajiga).
• Otaghak quotes are computed from its calendar and extra-guest price and are marked estimated: true.

These endpoints are undocumented and can change without notice. If something breaks, please open an issue.

Privacy and scope

• Read-only: Jagir never logs in, books, messages hosts or calls any write endpoint.
• No host phone numbers, host names or host ids are ever returned. Reviewer names are dropped.
• Runs locally over stdio. Nothing is sent anywhere except the three platforms' public APIs.

Development

git clone https://github.com/thejimbow/jagir-mcp.git
cd jagir-mcp
npm install
npm test             # unit tests against recorded fixtures
npm run test:live    # smoke test against the real platforms
npm run build        # compile to dist/
npm run pack:mcpb    # build the Claude Desktop extension (jagir.mcpb)

Project layout: src/platforms/ holds one adapter per platform, src/core/ holds dates, HTTP and the aggregator, and src/server.ts defines the MCP tools.

Contributions are welcome, especially adapters for more platforms (Shab, Homsa…) and fixes when a platform changes its API.

<br> <div dir="rtl" align="right">

فارسی

جاگیر یه سرور MCP هست که به Claude و بقیه‌ی دستیارهای هوش مصنوعی اجازه می‌ده هم‌زمان توی جاباما، جاجیگا و اتاقک دنبال اقامتگاه بگردن.

به فارسی بپرس. جاگیر هر سه سایت رو با هم می‌گرده، قیمت‌ها رو به تومان یکدست می‌کنه، تاریخ شمسی و میلادی رو می‌فهمه و همه‌ی اطلاعات لازم برای مقایسه رو به دستیار می‌ده: قیمت دقیق، تقویم خالی بودن، امکانات، امتیاز تمیزی و نظرات کامل مهمون‌ها.

چه کارهایی می‌کنه

• یه جستجو، سه سایت: نتایج با هم ادغام و مرتب می‌شن. اگه یکی از سایت‌ها از دسترس خارج باشه، بقیه جواب می‌دن.
• همه‌ی اطلاعات آگهی: امکانات (و امکاناتی که نداره)، قوانین، چیدمان تخت‌ها، متراژ، دربست یا اشتراکی، ویو و بافت، فاصله تا دریا و مرکز شهر، تخفیف‌ها و همه‌ی عکس‌ها.
• ریزامتیازها: امتیاز تمیزی، صحت مطالب، برخورد میزبان، موقعیت و ارزش به قیمت، به‌علاوه‌ی توزیع ستاره‌ها.
• نظرات کامل: متن کامل، تاریخ، پاسخ میزبان و نکات مثبت و منفی (اتاقک).
• قیمت واقعی: تقویم شبانه و قیمت نهایی برای تاریخ و تعداد نفرات شما، با هزینه‌ی نفر اضافه و کارمزد.
• فقط خواندنی: نه لاگین می‌کنه، نه رزرو. شماره و اسم میزبان و اسم نظردهنده‌ها هیچ‌وقت برگردونده نمی‌شه.

نصب

Claude Desktop: فایل jagir.mcpb رو دانلود کن و روش دابل‌کلیک کن. نیازی به نصب Node نیست.

Claude Code:

</div>

claude mcp add jagir -- npx -y jagir-mcp

<div dir="rtl" align="right">

یه نمونه پرامپت

</div>

با جاگیر یه اقامتگاه در رشت یا اطراف نزدیکش پیدا کن.
ورود ۱۴۰۵/۰۷/۱۵، خروج ۱۴۰۵/۰۷/۱۸، ۵ نفر.
امتیاز ۴.۵ به بالا با حداقل ۱۰ نظر، امتیاز تمیزی ۴.۷ به بالا، ویو جنگل یا کوه.
نظرات ۵ گزینه‌ی برتر رو بخون و هر شکایتی از تمیزی یا سروصدا رو گزارش کن.
برای ۳ گزینه‌ی نهایی قیمت دقیق ۵ نفر رو بگیر و یه جدول مقایسه با لینک بده.

---

Disclaimer

Jagir is an independent open-source project and is not affiliated with, endorsed by or sponsored by Jabama, Jajiga or Otaghak. All trademarks belong to their owners. Prices and availability come directly from the platforms and can change at any time; always confirm on the platform before booking.

License

MIT