List the top films currently in cinemas in the configured territory.

Results are ordered by number of showtimes in the MovieGlu database. Each film carries a film_id — use it with movie_showtimes, closest_showing, movie_details or ticket_link.

Args: limit: How many films to return (default 10, max 25).

List films coming soon to cinemas, ordered by release date.

Includes release dates, age ratings and synopses.

Args: limit: How many films to return (default 10, max 15).

Search film titles by name fragment (search-as-you-type).

Results are ordered by popularity (showtime count) and include film_id, release date, duration and age rating.

Args: query: Film title fragment (at least 1 character). limit: Max results (default 5, max 25).

Full metadata for one film: synopsis, cast, directors, genres, ratings, trailers, images and nationwide show dates.

Args: film_id: MovieGlu numeric film id (from search / listing tools). size_category: Image size: small, medium, large, xlarge or xxlarge (comma-separated for multiple).

Trailer URLs (with qualities and regions) for one film.

Args: film_id: MovieGlu numeric film id.

List the cinemas nearest to a location, with addresses and distances.

lat/lng are optional: when omitted, the configured default location (MOVIEGLU_LAT / MOVIEGLU_LNG) is used. Only cinemas with showtimes in the next 10 days are returned.

Args: limit: Max cinemas (default 10, max 25). lat: Latitude (-90..90). lng: Longitude (-180..180).

Search cinema names or towns (min 3 characters, search-as-you-type).

Works best with a geolocation (within 75 miles); without it, results are alphabetical. lat/lng fall back to the configured default location.

Args: query: Cinema chain or town name fragment (3+ chars). limit: Max results (default 5, max 25). lat: Latitude (-90..90), optional. lng: Longitude (-180..180), optional.

All showtimes at one cinema for one date.

With film_id: only that film. Without: every film playing that day. Times are as published by the cinema; times after midnight belong to the previous day (cinema day = 03:00-02:59).

Args: cinema_id: MovieGlu numeric cinema id. date: YYYY-MM-DD (defaults to today). film_id: Optional film id to narrow the schedule to one film. sort: popularity or alphabetical.

Showtimes for one film at the cinemas nearest a location, sorted by distance.

A location is required: pass lat/lng, or set a default location (MOVIEGLU_LAT / MOVIEGLU_LNG).

Args: film_id: MovieGlu numeric film id. date: YYYY-MM-DD (defaults to today). limit: Max cinemas (default 10, max 25). lat: Latitude (-90..90), optional. lng: Longitude (-180..180), optional.

Nearest cinemas showing a film, regardless of date and time.

For 'where can I see this film at all?' A location is required (lat/lng, or the configured default location).

Args: film_id: MovieGlu numeric film id. limit: Max cinemas (default 5, max 20). lat: Latitude (-90..90), optional. lng: Longitude (-180..180), optional.

Deep link to the cinema's ticketing page with film, date and time pre-selected. Use after presenting a showtime to the user.

MovieGlu does not support seat selection or payment; the link goes to the cinema's own website.

Args: cinema_id: MovieGlu numeric cinema id. film_id: MovieGlu numeric film id. date: Showtime date YYYY-MM-DD. time: Showtime time HH:MM (24h) exactly as published.

Diagnose the MovieGlu connection: which credentials are present, and whether a live API call succeeds. Use when other tools fail.