Jabama

jabama-mcp: Jabama MCP server for AI agents

Unofficial, read-only MCP server for Jabama (جاباما): let your AI agent plan stays in Iran.

Search villas, suites and eco-lodges on Jabama with the exact price for your dates and guests, read rules and reviews,

and find group tours on Jabama Tours, events and theater seats on Jabama Events, 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

For AI agents

• What: unofficial, read-only MCP server (model context protocol) for Jabama (جاباما, jabama.com), the Iranian short-term rental marketplace, plus its group-tour site jabama.tours and its event and theater ticket site jabama.events. Place names must be in Persian (the agent translates English ones).
• Install: uvx jabama-mcp or claude mcp add jabama -- uvx jabama-mcp. Transport: stdio. Needs uv (Python 3.10+).
• Auth: none, no API key or account. Optional JABAMA_MCP_PROXY (HTTP proxy URL, or a comma-separated list) if Jabama blocks your network; system proxy settings are ignored.
• Access: read-only. It cannot log in, book, hold seats or pay, so no confirmation is needed before calling any tool.
• Tools: 21, all prefixed jb_. Stays: jb_find_destination (or jb_parse_request for free text) → jb_search_stays → jb_stay_calendar → jb_price_quote. Tours: jb_tour_places → jb_search_tours → jb_tour. Events: jb_event_filters → jb_search_events → jb_event → jb_event_seats. Theater: jb_theaters → jb_theater.
• Units: prices in Toman (1 Toman = 10 Rial); tours Toman per person, events and theater Toman per ticket. Dates Gregorian YYYY-MM-DD (convert Jalali first), times Tehran local, ratings 0-5 (no key = not rated; null values are left out).
• Use when: the user wants to compare stays, tours, events or theater seats in Iran, or needs the exact total for dates and guests.
• Do not use when: the user wants to book, pay or hold a seat (they do that on the site), or asks about other services.
• Identifiers: pass the numeric listing code (328353) between stay tools; tours use an 8-digit id; events and plays use the id in their page URL.
• Machine-readable: server.json; catalog of all Iranian MCP servers: iran-mcp (TOOLS.md, servers.json, llms.txt).

Why

On Jabama (jabama.com) a search card shows one price, but the real cost of a stay depends on the nights you pick (weekends and holidays are priced differently), how many guests come (every guest above the base count adds a nightly charge) and long-stay discounts. An agent with jabama-mcp reads the search, the nightly calendar and the site's own price quote, so the number it gives you is the number you pay:

You: A cheap eco-lodge near Ramsar for 4 people, 20 to 23 October?

Agent: *calls* jb_find_destination(query="رامسر") → jb_search_stays(keyword="city-ramsar", check_in="2026-10-20", check_out="2026-10-23", guests=4, types=["ecotourism"], sort="cheapest") → jb_price_quote(code=328353, check_in="2026-10-20", check_out="2026-10-23", guests=4)

| Night | Type | Night price | 2 extra guests | Total |

|---|---|---:|---:|---:|

| 20 Oct | weekday | 600,000 | 300,000 | 900,000 |

| 21 Oct | weekend | 520,000 | 300,000 | 820,000 |

| 22 Oct | weekend | 520,000 | 300,000 | 820,000 |

نسا - افرا in Tonekabon: 2,540,000 Toman for 3 nights and 4 guests (or 4 parts of 635,000). The host must

accept the booking first; cancelling up to 24 Mehr costs 10% of the first night and 10% of the rest.

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

Every reply is compact JSON, so it does not flood the agent's context.

What it can do

• Find a place: Persian city, area or landmark names (a beach, a mall, an airport) to search filters
• Understand a request: free text like «ویلای استخردار در رامسر برای ۶ نفر» becomes filters, with Jabama's own AI parser
• Search stays by dates and guests with type, amenities, region, rooms, price, instant booking and rating filters
• Get the exact price for dates and guests, night by night, with discounts and the cancellation windows
• See the calendar: free nights and nightly prices for the next ~76 days, with weekends and holidays
• Check quality: house rules, amenities (and what is missing), reviews, host reputation, similar stays
• Group tours (jabama.tours): search, departures with free seats and per-package prices, day plans
• Events and theater (jabama.events): what is on, sessions, seats left, free seats by row and price
• Answer rules questions: cancellation, refunds, payment and tax from Jabama's help center, plus travel guides from its magazine
• Read-only by design: no login, no booking, no seat holds, no payment

Example prompts:

• "Cheapest villa with a pool in Ramsar for 6 people next weekend, and the exact total?"
• "Which nights is this cottage free in November, and which are cheapest?"
• "Compare the reviews and house rules of these two cottages near Tehran."
• "A one-day nature tour from Tehran this month, with free seats for 3."
• "What's on in Tehran on Friday evening under 500,000 Toman? Show the free seats."
• ارزان‌ترین ویلای استخردار رامسر برای ۶ نفر از ۲۸ مهر تا ۱ آبان، با قیمت نهایی؟
• قوانین کنسلی جاباما چیست و چقدر از پول برمی‌گردد؟
• کدام شب‌های آبان این اقامتگاه خالی است و ارزان‌ترین شب کدام است؟
• یک تور یک‌روزه طبیعت‌گردی از تهران با ۳ صندلی خالی پیدا کن.

Quick start

You need uv. No API key or account.

Claude Code

claude mcp add jabama -- uvx jabama-mcp

Claude Desktop

Settings → Developer → Edit Config, then add:

{

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

</details>

Cursor

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

VS Code (Copilot agent mode)

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

{

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

</details>

Codex CLI

codex mcp add jabama -- uvx jabama-mcp

Or in ~/.codex/config.toml:

[mcp_servers.jabama]

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

</details>

Gemini CLI

Add to ~/.gemini/settings.json:

{

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

</details>

Windsurf

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

Anything else

It is a standard stdio MCP server: run uvx jabama-mcp, or pip install jabama-mcp and run jabama-mcp.

Tools

Listings are identified by their numeric code (328353, the number in jabama.com/stay/ecotourism-328353); tours by an 8-digit id, events and plays by the id in their page URL.

Stay search (4)

One stay (6)

Help and guides (2)

Events and theater (6)

Group tours (3)