Skip to main content
Glama

alibaba-ir-mcp: Alibaba (علی‌بابا) Iran train, bus, flight, hotel, villa and tour search MCP server for AI agents

alibaba-ir-mcp is an unofficial, read-only MCP server that gives AI agents the train, bus, flight, hotel, villa and tour listings of Alibaba (alibaba.ir), Iran's largest travel site. Its 14 tools look up city codes, search trains, buses, domestic and international flights, hotels, holiday homes and tour packages with prices and availability, show bus seat maps and find the cheapest day to travel. No API key or Alibaba account is needed. It works in Claude, Cursor, Copilot and any other MCP client.

PyPI Python CI License: PolyForm Noncommercial

For AI agents · Quick start · Tools · FAQ · فارسی


For AI agents

  • What: unofficial MCP server (model context protocol) for alibaba.ir: train tickets (company, class, compartments, price, seats left, round trips), intercity buses (company, bus type, terminals, price, free seats), domestic and international flights (airline, times, fare classes, baggage, refund fees, round trips), hotels, villa and holiday-home rentals, tour packages and the cheapest day per route.

  • Install: uvx alibaba-ir-mcp or claude mcp add alibaba -- uvx alibaba-ir-mcp. Transport: stdio. Needs uv (Python 3.10+).

  • Auth: none, no API key or account. Optional ALIBABA_IR_MCP_PROXY (HTTP proxy URL, or a comma-separated list); 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: 14, all prefixed al_. Typical sequences: al_trains / al_buses / al_flights / al_flights_international for one day; al_*_cheapest then the search for the chosen day; al_stays then al_stay_detail; al_cities when unsure of a city code.

  • Use when: the user asks for train, bus or flight options, prices or seats, a hotel, a villa to rent or a tour package, or the cheapest day to travel.

  • Do not use when: the user wants to buy or book (send them to alibaba.ir), or asks about visas and insurance (not covered).

  • Output: compact JSON. Prices are Toman (Alibaba's API uses Rial; the tools divide by 10 as the site does): per adult for transport, for the whole stay for hotels, villas and tours. Dates are accepted as Gregorian 2026-11-11 or Jalali 1405-08-20; times are Iran local time.

  • Machine-readable: server.json.

Related MCP server: flytoday-mcp

Quick start

claude mcp add alibaba -- uvx alibaba-ir-mcp

Other clients: {"command": "uvx", "args": ["alibaba-ir-mcp"]}.

Tools

Tool

What it does

al_cities

City and airport names to the codes the other tools take (THR, MHD, SYZ...); international=true searches airports worldwide.

al_trains

Trains on one day (or a round trip): company, class and compartment, departure and arrival, price, seats left, discount; filter by class, passengers, women-only or men-only compartments.

al_trains_cheapest

Lowest train price for each of the next days.

al_buses

Intercity buses on one day: company, bus type, departure, price, seats, terminals, stops; says when a route has no buses and the next date that has.

al_buses_cheapest

Lowest bus price and bus count for each of the next days.

al_bus_seats

Free seats of one bus: counts per status, seat numbers and rows.

al_flights

Domestic flights on one day (or round trip): airline, flight number, times, aircraft, fare class, price per adult, child and infant, seats, baggage, cancellation fees.

al_flights_cheapest

Lowest domestic fare for each of the next days.

al_flights_international

International flights (any city Alibaba sells): airline, segments, stops, duration, baggage, price, round trip.

al_stays

Villas, suites, cottages and other holiday homes in a city: price, rating, capacity, filters for type, price, rating.

al_stay_detail

One holiday home: beds, amenities, house rules, cancellation terms, nightly price calendar, reviews.

al_hotels

Hotels in a city (Iran and abroad): stars, rating, price for the stay, meal plan, perks.

al_tours

Tour packages (travel plus hotel) to Kish, Mashhad, Istanbul, Dubai and more: hotel, room, price per person.

al_tours_cheapest

Lowest tour price per person for 11 days around a date.

Example: "cheapest way from Tehran to Mashhad next Thursday" -> al_trains_cheapest, al_flights_cheapest, then al_trains / al_flights / al_buses for that day.

FAQ

Is this official? No. It reads the same public JSON the alibaba.ir web app loads for anyone without an account.

Why does a train search sometimes fail? The rail suppliers go offline for maintenance for a while, usually just after midnight Tehran time. The site shows the same message; try again in a few minutes.

Why are there several rows for one flight? Each fare class is its own row; the site hides the repeats by default.

Where do the villas come from? Alibaba resells Jabama's listings; al_stays shows the same places and prices as alibaba.ir/accommodation.

Does it work outside Iran? Yes on most networks, directly or through ALIBABA_IR_MCP_PROXY.

فارسی

سرور MCP غیررسمی و فقط‌خواندنی برای علی‌بابا (alibaba.ir): جستجوی قطار، اتوبوس، پرواز داخلی و خارجی، هتل، ویلا و تور با قیمت و ظرفیت، نقشه صندلی اتوبوس و ارزان‌ترین روز سفر. نصب: uvx alibaba-ir-mcp. قیمت‌ها به تومان و تاریخ‌ها به شمسی (۱۴۰۵-۰۸-۲۰) یا میلادی پذیرفته می‌شود. خرید بلیت از طریق این ابزار ممکن نیست. Sepehr Radmard (سپهر رادمرد): github.com/sepehr071

مجوز استفاده (License)

استفادهٔ شخصی و غیرتجاری رایگان است. استفاده در شرکت، محصول پولی یا پروژهٔ مشتری به مجوز تجاری نیاز دارد؛ از راه لینکدین یا گیت‌هاب با سپهر رادمرد تماس بگیرید. متن کامل: PolyForm Noncommercial 1.0.0. نسخه‌های پیش از 0.2.1 با مجوز MIT منتشر شده‌اند و همان مجوز را دارند.

Free for personal and non-commercial use under the PolyForm Noncommercial License 1.0.0. Using it in a company, a paid product or a client project needs a commercial license: contact Sepehr Radmard on LinkedIn or GitHub. Versions before 0.2.1 were released under MIT and stay under it.

Available Tools

14 tools
al_busesBus ticketsA
Read-onlyIdempotent

Search intercity bus tickets between two Iranian cities on one day: company, bus type, times, price, seats.

Toman per adult. No arrival time is available. from_terminal matters in cities with several terminals.

Inputs: date (required), origin (required), destination (required), sort, +2 more.

al_buses_cheapestCheapest bus per dayA
Read-onlyIdempotent

List the lowest bus price and the number of buses for each day from a start date (the site has no bus calendar).

One search per day, so keep days small. Toman per adult, buses with a free seat only.

Inputs: date (required), origin (required), destination (required), days.

al_bus_seatsBus seat mapA
Read-onlyIdempotent

Show which seats are free on one bus: counts per status and the free seat numbers (no booking).

Use after al_buses. layout gives each free seat's row/column (columns 1-2 left of the aisle, 4-5 right).

Inputs: date (required), origin (required), destination (required), departure_time (required), +1 more.

al_citiesCity and airport codesA
Read-onlyIdempotent

Look up the city codes the other tools take (THR for Tehran, MHD for Mashhad) and what is sold for each city.

train/flight say a city has a station/domestic airport. With international=true it returns airports worldwide; whole_city rows (code ending in ALL) cover all airports of a city.

Inputs: limit, query, international.

al_flightsDomestic flightsA
Read-onlyIdempotent

Search domestic flights between two Iranian airports on one day: airline, flight number, times, fare, seats.

Toman per adult (child_price_toman, infant_price_toman for the others); a flight repeats per fare class. For a flexible date call al_flights_cheapest first. Abroad: al_flights_international.

Inputs: date (required), origin (required), destination (required), sort, +7 more.

al_flights_cheapestCheapest flight per dayA
Read-onlyIdempotent

List the lowest domestic fare for each day from a start date, to pick the cheapest day to fly.

Toman per adult; a day with no flight is missing.

Inputs: date (required), origin (required), destination (required), days.

al_flights_internationalInternational flightsA
Read-onlyIdempotent

Search international flights between Iran and abroad (or any two cities Alibaba sells) on one day.

price_toman is per adult, total_toman for the whole group. With return_date each fare has a return leg. Codes: al_cities with international=true. Takes 10-20 seconds.

Inputs: date (required), origin (required), destination (required), sort, +8 more.

al_hotelsHotelsB
Read-onlyIdempotent

Search hotels in a city for a stay: stars, rating, price for the whole stay, meal plan, perks (domestic and abroad).

Toman for the room for all nights (price_per_night_toman is the average). Takes a few seconds.

Inputs: city (required), checkin (required), sort, limit, +4 more.

al_stay_detailVilla or holiday home detailsA
Read-onlyIdempotent

Show one villa or holiday home in full: capacity, beds, amenities, house rules, cancellation terms, calendar, reviews.

Toman per night (price_base weekday, price_weekend, price_holiday); calendar gives availability and price per day.

Inputs: id (required), reviews, calendar_days.

al_staysVillas and holiday homesA
Read-onlyIdempotent

Search villas, suites, cottages and other holiday homes for rent in a city, with price, rating and capacity.

Toman: price_per_night_toman is the stay average, price_total_toman the whole stay (no VAT). Sorting covers the first 100 places (found is the full count). al_stay_detail takes an id.

Inputs: checkin (required), destination (required), sort, type, +7 more.

al_toursTour packagesA
Read-onlyIdempotent

Search tour packages (round trip plus hotel) from a city to a destination such as Kish, Mashhad, Istanbul or Dubai.

Each result is a hotel with its cheapest package; prices in Toman per person and for the group. Takes a few seconds.

Inputs: checkin (required), destination (required), sort, limit, +5 more.

al_tours_cheapestCheapest tour per dayA
Read-onlyIdempotent

List the lowest tour price per person for 11 departure days around a date (5 before, 5 after), to pick the cheapest day.

Toman per person for nights nights; a day without tours is missing. Then call al_tours.

Inputs: checkin (required), destination (required), nights, origin.

al_trainsTrain ticketsA
Read-onlyIdempotent

Search train tickets between two Iranian cities on one day: company, class, times, price and seats left.

Prices are Toman per adult. seats_left 0 means sold out. Pass return_date for the way back. For a flexible date call al_trains_cheapest first. After midnight the rail suppliers may be down; retry later.

Inputs: date (required), origin (required), destination (required), sort, +6 more.

al_trains_cheapestCheapest train per dayA
Read-onlyIdempotent

List the lowest train price for each day from a start date, to pick the cheapest day to travel.

Toman per adult; a missing day has no train.

Inputs: date (required), origin (required), destination (required), days.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 14 tools

    Disambiguation4/5

    Most tools target a distinct resource+action: trains, buses, flights, hotels, stays, tours, plus dedicated cheapest-calendar variants that descriptions explicitly frame as 'call this first' helpers. The remaining overlap (al_flights vs al_flights_international, al_stays vs al_hotels) is explained in the descriptions but still requires reading them carefully.

    Naming Consistency4/5

    All names share an 'al_' prefix and snake_case, with predictable suffixes (_cheapest, _detail, _seats, _international) for variant tools. The base search tools use bare nouns (al_buses, al_flights) while others use noun_suffix, a minor inconsistency in an otherwise coherent scheme.

    Tool Count5/5

    14 tools is well within a healthy range and each one earns its place: one search tool per vertical plus calendar-price and detail helpers. No obvious redundancy or padding.

    Completeness3/5

    Search, cheapest-day calendars, seat maps, detail and city-code lookup cover discovery well, but there is no booking/purchase flow, no passenger or checkout handling, and no hotel-detail tool comparable to al_stay_detail. Agents can research but hit a dead end when they need to actually reserve.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to search and compare the cheapest flights, trains, buses, private taxis and hotels across Iran, including free seats, baggage allowances, refund rules and exact prices, for a single date or across weeks. All 22 tools are read-only and return compact structured JSON, so an agent can plan multi-mode trips and hotel stays without logging in or booking.
      22
      313 PyPI
      2
      PolyForm Noncommercial 1.0.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to compare and find the cheapest domestic and international flights, hotels, villas, trains and buses in Iran, with exact Toman prices, fare and cancellation rules, baggage details, seats left and hotel reviews. Also covers CIP lounges, eSIM plans, visas and tours, and is read-only, so it never books, holds seats or pays.
      235 PyPI
      2
      PolyForm Noncommercial 1.0.0
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to search Iranian hotels, compare room prices and deals, check facilities, photos, reviews, price calendars, and flight-plus-hotel tours through read-only access to Eghamat24.
      14
      90 PyPI
      PolyForm Noncommercial 1.0.0
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to search Iranian hotels by city, dates, stars, price, and facilities; retrieve hotel details, rooms, nightly price calendars, and guest reviews; and search domestic one-way flights with cheapest-day pricing. It is read-only and requires no API key or account.
      10
      9
      PolyForm Noncommercial 1.0.0