Fly Travel Albania

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Cached charter package, hotel facts and tour prices from Fly Travel Albania (Tirana); party-aware.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Fly Travel Albania": {
      "url": "https://flytravel.al/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (12)

• charter_cheapest read-only

  Cheapest flight+hotel charter packages from Tirana (Albania) per destination, from the live booking-engine cache (the 5 cheapest per destination, each on its own date). Use for "what is the cheapest…" only; for advice or filtering use charter_offers. CACHED prices (from recent real searches on flytravel.al — not a live query; every row carries cached_at/age_minutes). Charter prices are PACKAGE TOTALS in EUR for the row's "party" (flight + hotel + transfers), NOT per person. party_match=false means the price is the 2-adult reference, not the total for the requested party — say so. A price belongs ONLY to its own "date": never present it as the price of another date.

  Parameters:

  • destination — string — Optional destination key, e.g. 'antalya' or 'bodrum'. Omit to get every destination.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• charter_hotel read-only

  Cached price(s) for ONE hotel named by the user (e.g. "Granada Luxury Belek") — searches the full price cache (hundreds of hotels). ALWAYS pass the date and the party the user gave: the per-date cache is read for that EXACT party first (party_match=true = real total for that family), then the 2-adult file (party_match=false = reference price). exact_date_matches = real cached prices for the requested date; other_cached_offers belong to their OWN dates (availability_status=reference_other_date). When nothing is cached for the requested date, say so and give hotel_page (it prices any date live). Do NOT call this tool repeatedly to browse — use charter_offers (filters) or compare_hotels (2-6 named hotels) instead. For amenities use hotel_details. CACHED prices (from recent real searches on flytravel.al — not a live query; every row carries cached_at/age_minutes). Charter prices are PACKAGE TOTALS in EUR for the row's "party" (flight + hotel + transfers), NOT per person. party_match=false means the price is the 2-adult reference, not the total for the requested party — say so. A price belongs ONLY to its own "date": never present it as the price of another date.

  Parameters:

  • hotel (required) — string — Hotel name, or part of it.
  • date — string — Desired departure date, format YYYY-MM-DD — exact-date cache is checked and the date is baked into the links.
  • adults — integer — Number of adults (default 2).
  • nights — integer — Trip length in nights. Omit for the standard charter length (6 nights / 7 days). Most departures also sell 3-10 nights.
  • destination — string — Optional destination key ('antalya', 'bodrum') to narrow the search.
  • children_ages — array — Age of each child AT DEPARTURE (0-14 = child; 15+ is counted as an adult automatically).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• charter_offers read-only

  THE discovery tool: filters the whole cached charter inventory (hundreds of hotels) in ONE call by date, TOTAL budget, stars, board, zone, party and hotel features (aquapark, kids club, adults-only, beach, spa, luxury…). Built for "I have X EUR for 2 adults + a child, Antalya, 5 stars, aquapark, near the beach — what do you suggest?". Returns the price range, three quality tiers (economy-but-good / mid / premium) and a shortlist; advise from the tiers, never only the cheapest. Pass the date whenever the user has one (exact availability for that date) and the real party (exact-party cache is used when present). excluded_unknown_features tells how many hotels were dropped because their facilities are unknown. CACHED prices (from recent real searches on flytravel.al — not a live query; every row carries cached_at/age_minutes). Charter prices are PACKAGE TOTALS in EUR for the row's "party" (flight + hotel + transfers), NOT per person. party_match=false means the price is the 2-adult reference, not the total for the requested party — say so. A price belongs ONLY to its own "date": never present it as the price of another date.

  Parameters:

  • spa — boolean — true = only hotels with spa / Turkish bath / sauna.
  • date — string — Departure date, format YYYY-MM-DD (recommended — exact availability for that date).
  • zone — string — Zone/resort filter substring, e.g. 'Belek', 'Alanya', 'Lara', 'Side', 'Kemer'.
  • beach — boolean — true = only hotels with a beach (own or nearby, per the hotel facts).
  • board — string — Board filter substring, e.g. 'all inclusive', 'ultra'.
  • limit — integer — Shortlist size (default 12).
  • adults — integer — Number of adults (default 2).
  • luxury — boolean — true = only hotels tagged luxury.
  • nights — integer — Trip length in nights. Omit for the standard charter length (6 nights / 7 days). Most departures also sell 3-10 nights.
  • aquapark — boolean — true = only hotels with an aquapark / water park.
  • kids_club — boolean — true = only hotels with a kids / mini club.
  • stars_min — integer — Minimum hotel star rating (1-5).
  • adults_only — boolean — true = only adults-only hotels; false = EXCLUDE adults-only hotels (use false for any party with children).
  • destination — string — Optional destination key ('antalya', 'bodrum'). Omit to search all.
  • children_ages — array — Age of each child AT DEPARTURE (0-14 = child; 15+ is counted as an adult automatically).
  • private_beach — boolean — true = only hotels listing a private / own beach.
  • family_friendly — boolean — true = only hotels with family facilities (kids club / kids pool / family rooms) and not adults-only.
  • budget_total_max — integer — Max TOTAL budget in EUR for the whole party.
  • budget_total_min — integer — Optional min total, to skip too-basic offers.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• charter_dates read-only

  Real upcoming charter departure dates from Tirana for a destination (cached calendar), each with the trip lengths (nights_available) really on sale for that departure and a ready booking-search link. Filter with date_from/date_to or month; total_count/has_more say when the calendar holds MORE dates than returned — never present a capped list as the whole calendar. For "which date is cheapest" use charter_flexible_dates.

  Parameters:

  • destination (required) — string — Destination key, e.g. 'antalya' or 'bodrum'.
  • limit — integer — Max dates to return (default 20).
  • month — string — Whole-month window, e.g. '2026-09' (ignored when date_from/date_to given).
  • adults — integer — Number of adults (default 2).
  • nights — integer — Trip length in nights. Omit for the standard charter length (6 nights / 7 days). Most departures also sell 3-10 nights.
  • date_to — string — Only departures on/before this date (YYYY-MM-DD).
  • date_from — string — Only departures on/after this date (YYYY-MM-DD).
  • children_ages — array — Age of each child AT DEPARTURE (0-14 = child; 15+ is counted as an adult automatically).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• tours_list read-only

  Escorted group tours from Tirana with Albanian-speaking guides (cached catalogue): stable id, title, days/nights, cities, transport, next_departure and the PER PERSON price in EUR — unlike charter packages, tour prices are per person. For one tour's full calendar, program and date-specific price use tour_details.

  Parameters:

  • limit — integer — Max tours to return (default 10).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• booking_link read-only

  Deep link into the live charter search results for a destination, date, party and optional trip length — hand this URL to the user to see live availability and book. Children are ages 0-14 at departure; ages 15+ count as adults. Pure URL builder (no data).

  Parameters:

  • destination (required) — string — Destination key, e.g. 'antalya'.
  • date (required) — string — Departure date, format YYYY-MM-DD.
  • adults — integer — Number of adults (default 2).
  • nights — integer — Trip length in nights. Omit for the standard charter length (6 nights / 7 days). Most departures also sell 3-10 nights.
  • children_ages — array — Age of each child AT DEPARTURE (0-14 = child; 15+ is counted as an adult automatically).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• prices_digest read-only

  Today's full machine-readable price digest (charter packages, tours, guides, FAQ) — same content as https://flytravel.al/llms-full.txt (cached, rebuilt hourly). Overview only; for any specific hotel/date/party use the charter_* tools.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• hotel_details read-only

  Static facts we hold about ONE charter hotel: stars, zone, provider-tagged categories, tri-state features (aquapark, kids_club, kids_pool, beach, private_beach, spa, adults_only, luxury, night_entertainment, water_slides — true/false/null where null = unknown), the facility list and a short description. FACTS ONLY: never claim a feature that is null/absent; distances to beach/airport are NOT available — do not estimate them. No prices here (use charter_hotel). Cache/DB read, no live call.

  Parameters:

  • hotel (required) — string — Hotel name, or part of it.
  • destination — string — Optional destination key ('antalya', 'bodrum').

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• compare_hotels read-only

  Side-by-side comparison of 2-6 named hotels for a date and party: cached price (with party_match + cached_at), stars, zone, board, room, features (aquapark, kids club, beach, spa, adults-only…) and a booking link each — one call instead of several charter_hotel calls. Hotels not in the cache are listed in not_found (do NOT say they are unavailable — the cache only holds recently searched offers). CACHED prices (from recent real searches on flytravel.al — not a live query; every row carries cached_at/age_minutes). Charter prices are PACKAGE TOTALS in EUR for the row's "party" (flight + hotel + transfers), NOT per person. party_match=false means the price is the 2-adult reference, not the total for the requested party — say so. A price belongs ONLY to its own "date": never present it as the price of another date.

  Parameters:

  • hotels (required) — array — Hotel names (or parts of them).
  • date — string — Departure date, format YYYY-MM-DD (recommended).
  • adults — integer — Number of adults (default 2).
  • nights — integer — Trip length in nights. Omit for the standard charter length (6 nights / 7 days). Most departures also sell 3-10 nights.
  • destination — string — Optional destination key ('antalya', 'bodrum').
  • children_ages — array — Age of each child AT DEPARTURE (0-14 = child; 15+ is counted as an adult automatically).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• charter_flexible_dates read-only

  For flexible travellers: the lowest CACHED package total for each departure date inside a window (max 31 days) for a destination and party, plus best_value_date. Dates with no cache are returned as availability_status=no_cached_data — NOT as "no offers" (the cache only holds recently searched dates; the search_url prices them live). CACHED prices (from recent real searches on flytravel.al — not a live query; every row carries cached_at/age_minutes). Charter prices are PACKAGE TOTALS in EUR for the row's "party" (flight + hotel + transfers), NOT per person. party_match=false means the price is the 2-adult reference, not the total for the requested party — say so. A price belongs ONLY to its own "date": never present it as the price of another date.

  Parameters:

  • destination (required) — string — Destination key, e.g. 'antalya' or 'bodrum'.
  • adults — integer — Number of adults (default 2).
  • nights — integer — Trip length in nights. Omit for the standard charter length (6 nights / 7 days). Most departures also sell 3-10 nights.
  • date_to — string — Window end, YYYY-MM-DD (default date_from + 14 days; max 31-day window).
  • date_from — string — Window start, YYYY-MM-DD (default today).
  • stars_min — integer — Minimum hotel star rating (1-5).
  • children_ages — array — Age of each child AT DEPARTURE (0-14 = child; 15+ is counted as an adult automatically).
  • budget_total_max — integer — Max TOTAL budget in EUR for the whole party.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• tour_details read-only

  Full cached details for ONE organized group tour: the COMPLETE departure-date calendar, the day-by-day program as text, duration, transport, and the per-person price. Match by `tour` (part of the name/cities, e.g. "Stamboll", "Milano Como") or exact `tour_id` from tours_list. Pass `date` + the party when the user has them: when that departure's group price is warm in cache you get the EXACT group total (price_status=cached_for_date); otherwise price_from is the PER PERSON price of the NEAREST departure (price_status=list_from) — every departure date has its OWN price, never quote one date's price for another; tour_page prices any date live. Answer date questions ONLY from departure_dates — it is the complete current calendar. Seats/availability are confirmed by staff. Cache/DB read, no live call.

  Parameters:

  • date — string — Desired departure date, YYYY-MM-DD — checked against the calendar and baked into tour_page.
  • tour — string — Tour name or city, or part of it (e.g. "Stamboll", "Dubai").
  • adults — integer — Number of adults (default 2).
  • tour_id — integer — Exact tour id from tours_list (preferred when known).
  • children_ages — array — Age of each child, 0-11 (TOURS price 12+ as adults — a DIFFERENT bracket than charter packages).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• holiday_packages read-only

  Our NON-charter holiday packages from Tirana (flight+hotel or bus+hotel: Corfu, Parga, Crete, Malta, Barcelona, Mallorca, Rimini…): which destinations are on sale right now, their validated upcoming departure dates, an INDICATIVE "from €X per person" price and the booking page link. The exact price depends on hotel/room/party and is computed live on the package page (link) — never present price_from as a bookable quote. For Turkey/Egypt beach charters (Antalya, Bodrum…) use the charter_* tools instead. Cached/validated data only, no live call.

  Parameters:

  • date_to — string — Only departures on/before this date (YYYY-MM-DD).
  • date_from — string — Only departures on/after this date (YYYY-MM-DD).
  • destination — string — Package destination key from the no-argument listing (e.g. 'korfuz', 'barcelona', 'kreta'). Omit to list every destination.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.