# Jabama [Health: Active]

**Category:** 🚆 Travel & Transportation  
**Repository:** https://github.com/sepehr071/jabama-mcp  
**GitHub Stars:** 2  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/jabama

## Description
Unofficial read-only Jabama: villas and stays with exact prices, group tours, events and theater.

## Tools
Capabilities this server exposes over MCP:

- **jb_find_destination** — Persian place name → ready search arguments (city, area, landmark, complex)
- **jb_parse_request** — Free-text request → search arguments, using Jabama's AI parser
- **jb_search_stays** — Search stays for dates and guests with filters, whole-stay prices, sorting
- **jb_categories** — Themed lists (special pool, luxury, cheap, jungle, pet friendly, last-minute, ...)
- **jb_stay** — Capacity, beds, rules, amenities and missing ones, cancellation policy, host, review scores
- **jb_stay_calendar** — Free nights and nightly prices with weekend and holiday flags (~76 days)
- **jb_price_quote** — Exact payable amount for dates and guests, night by night; unit options for complexes
- **jb_similar_stays** — Similar stays nearby (priced for your dates) and other units of the same property
- **jb_reviews** — Guest reviews, newest or best/worst first, with host replies
- **jb_host** — A host's listings and reviews across all of them
- **jb_help** — Jabama's rules: cancellation, refunds, payment, tax (help center + support answers)
- **jb_travel_guide** — Jabama magazine travel guides for a destination
- **jb_search_events** — Events and experiences by city, category, date, price and rating
- **jb_event** — One event: details, address, rules, sessions with seats left, reviews, organizer
- **jb_event_seats** — Free seats of a seated session by section and row, with section prices
- **jb_theaters** — Theater plays on sale: venue, from-price, rating, cast
- **jb_theater** — One play: showtimes with live seats left; free seats of a showtime
- **jb_event_filters** — Event cities and categories with counts
- **jb_search_tours** — Tours by place, dates, category, tags, duration, price, difficulty, rating
- **jb_tour** — One tour: departures with free seats and package prices, day plan, inclusions, cancellation, reviews
- **jb_tour_places** — Place name → place id for the tour search

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

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

## Documentation

## What Jabama MCP server does

The Jabama MCP server gives an MCP-compatible AI client read-only access to public information from Jabama and its related tour and event services. It covers short-term stays such as villas, suites, and eco-lodges, along with group tours, events, and theater listings in Iran.

For stays, the server can turn Persian place names or free-text requests into search parameters, find properties for selected dates and guest counts, and return filters, sorting, and whole-stay prices. Separate tools provide property details, amenities, house rules, cancellation information, host data, reviews, similar properties, calendar availability, and an exact payable quote. Prices are returned in Toman.

The Jabama MCP server also supports travel planning beyond accommodation. Tour tools expose destinations, departures, package prices, remaining seats, itineraries, inclusions, cancellation terms, and reviews. Event and theater tools cover listings, sessions, ratings, venues, showtimes, seat availability, and section or row pricing where provided.

## How it works

The server runs on the user’s machine and communicates with an AI client through MCP over stdio. It then makes HTTPS JSON requests to the public endpoints used by Jabama’s websites, including stay, help, magazine, tour, event, and theater services. There is no hosted intermediary described in the documentation, and the server does not require an API key or user login.

A typical stay workflow starts with `jb_find_destination` or `jb_parse_request`, continues with `jb_search_stays`, and then uses `jb_stay_calendar` and `jb_price_quote` for availability and date-specific pricing. Tours commonly use `jb_tour_places`, `jb_search_tours`, and `jb_tour`; events can use `jb_search_events`, `jb_event`, and `jb_event_seats`. Numeric listing identifiers are passed between related calls.

## Setup and configuration

Install `uv`, then run the server with `uvx jabama-mcp`. Claude Code can add it with `claude mcp add jabama -- uvx jabama-mcp`. Claude Desktop, Cursor, and VS Code can use a stdio configuration with `uvx` as the command and `jabama-mcp` as its argument. Alternatively, install the package with pip and run `jabama-mcp` directly.

No authentication configuration is required. `JABAMA_MCP_PROXY` is available as an optional HTTP proxy setting if Jabama blocks the network connection. The documented runtime requirement is Python 3.10 or newer when installing or running the package through the supported tooling.

## Tools and capabilities

The 21 tools use the `jb_` prefix and return compact JSON. Capabilities include:

- Resolving Persian cities, areas, landmarks, and tour places.
- Parsing natural-language stay requests with Jabama’s AI parser.
- Filtering stays by dates, guests, type, amenities, region, rooms, price, instant booking, and rating.
- Comparing nightly prices, weekends, holidays, discounts, and exact totals.
- Reading cancellation policies, host information, review scores, and guest reviews.
- Finding tours, events, theater plays, sessions, departures, and available seats.
- Retrieving help-center and support answers about cancellation, refunds, payment, and tax.

## Limitations and notes

The Jabama MCP server is read-only. It does not log users in, create bookings, hold seats, or process payments, so the user must complete those actions on the relevant website. Availability and prices can change, and search-card prices may differ from the date- and guest-specific quote.

Place names are expected in Persian, although the README says an agent can translate English names. Dates use Gregorian `YYYY-MM-DD`, ratings use a 0–5 scale, and prices use Toman. The tool documentation describes calendar coverage as approximately 76 days, so it should not be treated as an unrestricted long-range availability source.

_Full upstream README: https://allmcps.com/mcp/jabama/readme_