Cinve

In 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 (optional: Supercines shows public prices without an account; connect it only if 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.

Disconnects 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.

Status of the Cinex, Cines Unidos and Supercines sessions and the next connection step. The Supercines account is optional: without it, prices are the public ones. Returns no personal data or secrets. configured does not guarantee that the provider has not revoked the session.

Gets 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.

Actual seat map without booking: Cinex and Cines Unidos require cinema_id, session_id and a connected account; Cinepic also requires movie_id, without login. Use IDs from get_showtimes. Returns counters 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 and Cinepic, use get_seats with verified venue and showtime IDs; Cinepic also requires movie_id. Show the ascii map in a monospaced text block with its legend and the time of the lookup. 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 select or reserve seats; availability may change before purchase.

Gets 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.

Gets 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.

Lists venues and IDs. Cines Unidos requires city; 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.

Lists the provider's cities. Use their names when querying Cines Unidos.

Searches 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.

Lists providers and implemented coverage. This capability catalog does not perform a live availability check.