Cinve

Tools11, 11 tools

• get_auth_statusStatus of the Cinex, Cines Unidos and Supercines sessions and the next connection step. The Supercines account is optional for prices (without it they are the public ones) and needed for its seat maps. Returns no personal data or secrets. configured does not guarantee that the provider has not revoked the session.
• list_providersLists providers and implemented coverage. This capability catalog does not perform a live availability check.
• connect_accountIn hosted mode, starts Cinve authorization automatically when needed. If the account is already connected, returns connected=true: repeat the original query without asking the user for anything. Otherwise, returns connected=false and a private, single-use link for the user to connect their Cinex, Cines Unidos or Supercines account (Supercines shows public prices without an account, but its seat maps need one: connect it when get_seats returns auth_required for Supercines or the user asks). Present it only to the user in this conversation and do not share it with third parties: whoever uses it connects their account to this access. Do not open or fill in the form as an agent. Never ask for credentials in the chat. Expires in 10 minutes.
• disconnect_accountDisconnects the user's cinema account in Cinve and cancels pending links. Does not revoke the session directly on the cinema's website. Use when the user asks to disconnect.
• get_seatsActual seat map without booking: Cinex and Cines Unidos require cinema_id, session_id and a connected account; Cinepic also requires movie_id, without login; Supercines requires cinema_id, session_id, movie_id, date if the showtime is not today, and a connected account (its website shows the map only inside a purchase, so Cinve opens one with a single ticket, picks no seat and cancels it in the same call). Use IDs from get_showtimes. Returns counters, a PNG image of the map oriented like the cinema's website (image=svg returns it as SVG) and the full ASCII map, where each seat appears with its label and state (O = status available); include_seats=true adds the per-seat detail, which is much longer. No local cache. For seat availability at Cinex, Cines Unidos, Cinepic and Supercines, use get_seats with verified venue and showtime IDs; Cinepic and Supercines also require movie_id, and Supercines the date when it is not today. Show the user the map image get_seats returns (PNG, oriented like the cinema's website, with a legend and the time of the lookup) so they can see or share it; if your client does not show images, show the ascii map in a monospaced text block with its legend and the time of the lookup. Do not describe a screen side the map marks as unverified. Use only each seat's status=available to say it is free; keep occupied, unavailable and unknown separate. The result's status=available means a map was obtained, not that all its seats are free or that the interpretation is complete. Check availability_complete and the counters: available=0 with unknown>0 does NOT mean sold out. If the map is partial, show the confirmed states and the ? marks, explain that Cinve could not interpret part of the map, and do not blame the cinema for that failure or claim that the MCP does not support seats. Do not invent seat positions or turn unknown or restricted seats into free ones. Do not repeat the login because of unknown states: only on auth_required. Lookups do not sel
• list_citiesLists the provider's cities. Use their names when querying Cines Unidos.
• list_cinemasLists venues and IDs, with each venue's area. For a user who names where they are, pass near: venues come nearest first with distance_km. Cines Unidos requires city or near; Supercines accepts an optional city; Cinepic verifies its configured venues Candelaria and VVIP Lido. Providers keep known venues without a verified code (code_status=unverified). Cinex accepts an optional city and includes known venues missing from the current directory (directory_status=not_listed); neither condition indicates a closure.
• list_moviesSearches movies by name. Cinepic requires cinema_id (123300 Candelaria or 123301 VVIP Lido) and filters the day's showtimes; Cines Unidos requires city and allows cinema_id/date. Cinex returns the general catalog without date/venue: only provider, query and paging. Supercines returns its current listings (with presales), overall or for one venue with cinema_id, without a date. Gran Cine returns the titles with showtimes on the date, with optional cinema_id or city. IDs belong to the provider and, for Cinepic, to the venue.
• get_showtimesGets showtimes for a date (today in Caracas by default). Cinepic requires cinema_id (123300 Candelaria or 123301 VVIP Lido); Cines Unidos requires city; Cinex accepts city for all its verified venues in the city in one call, cinema_id for one venue (with optional movie_id to filter), or only movie_id to read the movie's page across all venues; Supercines accepts cinema_id, city or movie_id; Gran Cine (arthouse cinema, includes the Paseo Las Mercedes theaters) accepts cinema_id, city or neither for all its theaters, without provider showtime IDs; use query to filter by title. The venue call resolves titles against the catalog and marks partial when it cannot confirm a movie_id. Returns the IDs needed for prices, screen/format when available and the website URL.
• get_ticket_pricesGets ticket prices (Gran Cine does not publish them). Cinepic requires cinema_id, movie_id and session_id from get_showtimes. Cines Unidos requires cinema_id, session_id and a connected account. Cinex requires cinema_id, session_id and a connected account. Supercines requires cinema_id, movie_id and session_id, and date if the showtime is not today; it does not require an account (if the user connected theirs, prices are read with it). Returns USD/VES when verifiable, Cinex breakdown in VES. Does not return final purchase totals.
• get_concessionsGets concessions by venue. Cinepic and Cines Unidos require only cinema_id, via a public API; Cinepic may return an empty catalog. Cinex requires cinema_id and a connected account. Supercines requires only cinema_id. Stock only when verified; does not use zero for missing prices.