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.
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-mcporclaude 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_internationalfor one day;al_*_cheapestthen the search for the chosen day;al_staysthenal_stay_detail;al_citieswhen 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-11or Jalali1405-08-20; times are Iran local time. - Machine-readable:
server.json.
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. قیمت‌ها به تومان و تاریخ‌ها به شمسی (۱۴۰۵-۰۸-۲۰) یا میلادی پذیرفته می‌شود. خرید بلیت از طریق این ابزار ممکن نیست.
MIT License. Sepehr Radmard (سپهر رادمرد): github.com/sepehr071
1 maintainer
Metadata
1 maintainer
Release files for alibaba-ir-mcp 0.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| alibaba_ir_mcp-0.1.2.tar.gz | 144.1 kB | With provenance | Details for alibaba_ir_mcp-0.1.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| alibaba_ir_mcp-0.1.2-py3-none-any.whl | Python 3 | none | any | Details for alibaba_ir_mcp-0.1.2-py3-none-any.whl |
Total release size: 178.8 kB
Release files / alibaba_ir_mcp-0.1.2.tar.gz
| Download URL | alibaba_ir_mcp-0.1.2.tar.gz |
|---|---|
| Size | 144.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fd9e5f2a656985fca60072815bd208fcb7b7257dd341a8063ddc858cd84e9e3e
|
|
BLAKE2b-256 checksum How to use checksums |
ad8db513425f2ba31749c5a409c131914a20400253d30af48de6043992e0d7bd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 3, 2026.
Transparency logRelease files / alibaba_ir_mcp-0.1.2-py3-none-any.whl
| Download URL | alibaba_ir_mcp-0.1.2-py3-none-any.whl |
|---|---|
| Size | 34.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0313fc31c8eea5be4b77a7d40d0c948d837042c3c082711294daac68935f425f
|
|
BLAKE2b-256 checksum How to use checksums |
8bfdcdb58339c4992392b287c3f9597ced274fe24a0f1f6dcf70134710b4f841
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 3, 2026.
Transparency logSecurity for alibaba-ir-mcp 0.1.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for alibaba_ir_mcp-0.1.2.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 3, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
