alibaba-ir-mcp
This read-only MCP server lets AI agents search Alibaba (alibaba.ir) travel options and prices in Iran and abroad; it cannot book, hold seats, or pay.
Look up city/airport codes and whether train or flight service exists, including international airports.
Search one-day or round-trip train tickets with class, compartment type, passengers, price, seats left, and filters.
Find the cheapest train day over a date range.
Search intercity buses with company, type, terminals, price, and seats; find cheapest bus days and view free-seat maps.
Search domestic flights with airline, times, fare classes, passenger pricing, baggage/refund info, round trips, and cheapest day.
Search international flights with stops, duration, cabin, airline, passengers, baggage, round trips, and sorting.
Search villas/holiday homes and get details like amenities, rules, cancellation terms, nightly price calendar, and reviews.
Search hotels by city, stars, rating, price, meal plan, and perks for a stay.
Search tour packages and find cheapest tour departure days around a date.
Accept Gregorian or Jalali dates, show prices in Toman, and return compact JSON.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@alibaba-ir-mcp What's the cheapest train from Tehran to Mashhad next Friday?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
Related MCP server: flytoday-mcp
Quick start
claude mcp add alibaba -- uvx alibaba-ir-mcpOther clients: {"command": "uvx", "args": ["alibaba-ir-mcp"]}.
Tools
Tool | What it does |
| City and airport names to the codes the other tools take (THR, MHD, SYZ...); |
| 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. |
| Lowest train price for each of the next days. |
| 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. |
| Lowest bus price and bus count for each of the next days. |
| Free seats of one bus: counts per status, seat numbers and rows. |
| 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. |
| Lowest domestic fare for each of the next days. |
| International flights (any city Alibaba sells): airline, segments, stops, duration, baggage, price, round trip. |
| Villas, suites, cottages and other holiday homes in a city: price, rating, capacity, filters for type, price, rating. |
| One holiday home: beds, amenities, house rules, cancellation terms, nightly price calendar, reviews. |
| Hotels in a city (Iran and abroad): stars, rating, price for the stay, meal plan, perks. |
| Tour packages (travel plus hotel) to Kish, Mashhad, Istanbul, Dubai and more: hotel, room, price per person. |
| 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 toolsal_busesBus ticketsARead-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 dayARead-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 mapARead-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 codesARead-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 flightsARead-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 dayARead-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 flightsARead-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_hotelsHotelsBRead-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 detailsARead-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 homesARead-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 packagesARead-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 dayARead-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 ticketsARead-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 dayARead-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
Scored across 14 tools
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.
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.
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.
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
Related MCP Connectors
Give AI assistants access to real-time data. Search the web, compare flights, find hotels, and more.
Airbnb, hotel and TripAdvisor search as agent tools.
Travel tools for AI agents: plan and edit real trips, search stays and tours, import travel videos.
Free web search, 130M+ business records, local search, weather and travel data for AI agents.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables 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.22313 PyPI2PolyForm Noncommercial 1.0.0
- AlicenseNot gradedqualityBmaintenanceEnables 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 PyPI2PolyForm Noncommercial 1.0.0
- AlicenseAqualityBmaintenanceEnables 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.1490 PyPIPolyForm Noncommercial 1.0.0
- AlicenseAqualityBmaintenanceEnables 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.109PolyForm Noncommercial 1.0.0