# Flytoday [Health: Active]

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

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

## Tools
Capabilities this server exposes over MCP:

- **ft_find_airport** — Finds IATA codes for Iranian and international cities and airports, or lists the popular ones
- **ft_search_flights** — Searches one-way or round-trip flights with filters, sorting and paging, in Toman, with fare_source_code and search_id
- **ft_flight_calendar** — Shows the cheapest fare per departure day around a date and marks the cheapest day
- **ft_flight_details** — Gives the refund and change rules, baggage and international entry notes of one fare
- **ft_find_hotel_place** — Find city, region and hotel ids for hotels, and region codes for villa stays; popular places when empty
- **ft_search_hotels** — Priced hotels of a city or region for dates: whole-stay and per-night Toman, stars, score, refundable, meal
- **ft_hotel** — One hotel: room and meal offers with price, rooms left and cancellation terms, room details, basics
- **ft_hotel_reviews** — Guest reviews of a hotel with score, text, pros and cons
- **ft_search_stays** — Villas and apartments in Iran for dates, cheapest first, Toman per night and total
- **ft_stay** — One villa or apartment: details, price calendar with blocked days, reviews
- **ft_find_station** — Train station codes by city name, or the popular stations
- **ft_search_trains** — Trains between two stations on a date: company, class, times, seats left, price per adult
- **ft_train_calendar** — Cheapest train price per day for the next ~16 days, sold-out days flagged
- **ft_train_stops** — Stops and times of one train, plus class amenities and meals
- **ft_find_bus_city** — Bus city ids by name, or the popular cities
- **ft_bus_calendar** — Cheapest bus seat price per day for the next weeks (the site's price strip)
- **ft_search_buses** — Buses between two cities on a date: company, terminals, type, seats left, price per seat
- **ft_cip** — CIP / VIP airport lounge prices and add-ons at IKA and MHD for a date and passengers, per passport nationality
- **ft_esim_plans** — eSIM data plans for a country (GB, days, price in Toman), cheapest first
- **ft_visa** — Visa country list with from-prices, or one country's prices, documents and processing time
- **ft_activities** — Tours, tickets and activities in a destination with from-prices for a date range
- **ft_activity** — One activity: description, options, prices and cheapest days

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

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

## Documentation

## What Flytoday MCP server does

The Flytoday MCP server exposes read-only travel search tools for Flytoday, an Iranian travel website. It covers domestic and international flights, hotels, villas and apartments, trains, buses, airport CIP services, eSIM plans, visas, tours and activities. Queries can be made in Persian or English, while most prices are returned in Toman.

Flight tools find airport and city IATA codes, search one-way or return fares, compare prices across nearby departure dates, and retrieve fare conditions. Fare details can include refund and change rules, baggage allowances and international entry notes. Search results support filters, sorting and paging.

Accommodation tools resolve hotel, city, region and villa identifiers before searching. Hotel results include stay and nightly prices, star ratings, scores, meal information and refundability. A hotel lookup provides room offers, remaining availability, cancellation terms and room details. Review lookups return guest scores, text, positive points and negative points. Stay tools cover villas and apartments in Iran, including total and nightly prices, blocked dates and reviews.

## How it works

The Flytoday MCP server runs on the user’s machine and communicates with an AI client through standard MCP over stdio. It then makes HTTPS requests to the same public gateway used by flytoday.ir, including the related Flytoday service endpoints. There is no hosted intermediary and no login or API key requirement described by the project.

Each travel area uses its own identifiers. Flights use IATA codes; hotels and stays use city, hotel or region identifiers; trains use station codes; and buses use numeric city IDs. Finder tools can return popular locations when no search term is supplied, which helps an agent obtain the identifiers needed by later searches.

Calendar tools are useful for reducing repeated searches. Flight calendars compare fares around a selected date, train calendars cover roughly the next 16 days, and bus calendars show the site’s price strip for the coming weeks. Search results and details can then be narrowed to a specific fare or property.

## Setup and configuration

Install Python 3.10 or newer and `uv`, then register the server with an MCP client using `uvx flytoday-mcp`. The standard command is:

```bash
claude mcp add flytoday -- uvx flytoday-mcp
```

It can also be installed with `pip install flytoday-mcp` and run as `flytoday-mcp`. The README documents configurations for Claude Desktop, Cursor, VS Code with Copilot agent mode and Claude Code. A standard stdio-compatible MCP client can run the same command.

Set `FLYTODAY_MCP_PROXY` to an HTTP proxy URL only when the network cannot reach Flytoday or the client’s IP is rate limited. No other environment variable or authentication credential is required.

## Tools and capabilities

The 22 tools use the `ft_` prefix and cover:

- Airports, hotels, stays, train stations and bus cities
- Flight, hotel, villa, train and bus searches
- Flight, train and bus date-based price calendars
- Flight fare rules, baggage and entry notes
- Hotel rooms, meals, cancellation terms and reviews
- Train stops, times, amenities and meals
- CIP and VIP lounge pricing at IKA and MHD
- Country-specific eSIM plans and visa pricing, documents and processing times
- Destination activities, tickets, options and cheapest dates

Results use Gregorian dates in `YYYY-MM-DD` format. Flight searches return values such as `search_id` and `fare_source_code`; these identifiers generally expire after about 15 minutes.

## Limitations and notes

The Flytoday MCP server is read-only. It does not log in, hold seats, confirm bookings, accept payments or replace the checkout process on flytoday.ir. Availability, prices and remaining seats can change between calls. Searches are rate limited per IP, so calendar queries and paging are preferable to making many repeated searches. Visa and some activity prices may use a foreign currency rather than Toman.

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