Unofficial read-only Flytoday: Iranian and international flights, hotels, villas, trains, buses.

GitHub stars
270

Install

/plugin install flytoday@iran-mcp

Run it inside Claude Code after adding the marketplace with /plugin marketplace add sepehr071/iran-mcp.

Contents

Discovered from source

Skills 1

Flytoday

Unofficial read-only Flytoday: Iranian and international flights, hotels, villas, trains, buses.

The tools below come from the flytoday-mcp MCP server. If they are not available, install it with claude mcp add flytoday -- uvx flytoday-mcp, or add "flytoday": {"command": "uvx", "args": ["flytoday-mcp"]} to the client's MCP servers config. It needs uv. Restart the session after installing.

Tools

  • ft_find_bus_city: Bus city ids (4 digits) for a city name, or the popular cities when query is empty.
  • ft_bus_calendar: Cheapest bus seat price per day for the next weeks (the site's price strip), in one cheap call.
  • ft_search_buses: Buses between two cities on a date: company, terminals, departure, bus type, seats left, price per seat.
  • ft_cip: CIP / VIP airport lounge service with prices for a date and passenger mix, plus paid add-ons.
  • ft_esim_plans: eSIM data plans for a country with data amount, validity days and price, cheapest first.
  • ft_visa: Visa services of Flytoday: the country list with from-prices, or one country's prices, documents and process.
  • ft_activities: Tours, tickets and experiences in a destination that are on sale in the date range, with from-prices.
  • ft_activity: One activity: description, highlights, options with adult prices, and the cheapest days in the range.
  • ft_find_airport: Find the IATA codes the flight tools need, for domestic and international places.
  • ft_search_flights: Search flights for a date: times, airline, seats left, price and fare_source_code per flight.
  • ft_flight_calendar: Cheapest one-adult fare per departure day around a date, in one cheap call (no search needed).
  • ft_flight_details: Refund and change rules, confirmed baggage per segment and (international) entry notes of one fare.
  • ft_find_hotel_place: Find the place ids the hotel and stay tools need.
  • ft_search_hotels: Priced hotels of a city (Iran) or region (abroad) for dates, one row per hotel with its cheapest room offer.
  • ft_hotel: One hotel for dates: every room and meal-plan offer with whole-stay price, rooms left and cancellation terms, the room details (size, beds, features) and the hotel basics (address, stars, score, facilities, check-in time).
  • ft_hotel_reviews: Guest reviews of a hotel: score (1-10), text, pros, cons, trip type and nights.
  • ft_search_stays: Villas, apartments and other private stays in Iran for dates, cheapest first.
  • ft_stay: One villa / apartment: details (capacity, rooms, facilities, rules, host), the per-night price calendar with blocked days, and the review summary with the latest reviews.
  • ft_find_station: Train station codes (station_code) for a city name, or the 8 most popular stations when query is empty.
  • ft_search_trains: Trains between two stations on a date: one row per train class (wagon) with price per adult and seats left.
  • ft_train_calendar: Cheapest train price per day for the next ~16 days, with sold-out days flagged.
  • ft_train_stops: Stops of one train with arrival and departure times, plus (with wagon_id) the class amenities and extra meals.

Rules

  • Prices are Toman. Convert before comparing with a Rial figure from anywhere else.
  • Read-only: no login, basket, booking, order or payment. Give the user the link to finish on the site.
  • Keep request rates low. These are undocumented site APIs that can change or rate-limit.
  • On timeouts or HTTP 403 outside Iran, set FLYTODAY_MCP_PROXY to an HTTP proxy with an Iranian IP.
  • Searches are rate-limited per IP. Do not repeat a search the user did not ask for.

Maintainer

Sepehr Radmard: open-source MCP servers for the Iranian web

Built and maintained by Sepehr Radmard (سپهر رادمرد): LinkedIn · GitHub. More servers for Iranian websites: iran-mcp.

MCP servers 1

Sponsors

Details

Marketplace
sepehr071/iran-mcp
Source
plugins/flytoday
Category
Travel

More from sepehr071/iran-mcp

All 96