CarteleraCines.es MCP Server

Busca películas por título con tolerancia a errores o búsquedas inexactas. Úsala cuando el usuario no escriba correctamente el nombre de la película o haya ambigüedad, por ejemplo: - "mision imposibl" - "avenger endgam" - "la de oppenheimer esa" Devuelve posibles coincidencias para identificar correctamente la película antes de buscar sesiones o cartelera.

Busca en qué cines y horarios se proyecta una película. Úsala cuando el usuario quiera saber dónde o cuándo ver una película concreta, por ejemplo: - "dónde echan Dune en Córdoba" - "cuándo ponen Minecraft mañana" - "en qué cine puedo ver Oppenheimer" - "dónde la ponen en VOSE" Permite filtrar por ciudad, cine, rango de fechas, versión (VOSE/doblada) o franja horaria. Es la tool principal para responder preguntas sobre disponibilidad de una película, incluida la URL de compra de entradas de cada sesión.

Da la ficha completa de una película: sinopsis, reparto (actores), dirección, géneros, país, año, duración, puntuación y calificación por edad. Úsala cuando el usuario pregunte, por ejemplo: - "de qué va Oppenheimer" - "quién sale en esa película" - "quién la dirige" - "cuánto dura" / "qué puntuación tiene" No la uses para saber dónde o cuándo verla (para eso, find_movie_showtimes) ni para cartelera general (get_cartelera_localidad).

Obtiene la cartelera real de un cine concreto entre dos fechas. Úsala cuando el usuario mencione un cine específico o quiera saber qué películas hay en un cine determinado, por ejemplo: - "qué ponen en Cinesur Córdoba hoy" - "cartelera de Kinépolis este sábado" - "qué películas hay en ese cine" Sirve para obtener todas las películas y sesiones disponibles en ese cine. Admite los mismos filtros que get_cartelera_localidad (niños, duración, puntuación, estrenos, géneros, versión, franja horaria).

Obtiene la cartelera real de una ciudad entre dos fechas. Úsala cuando el usuario quiera saber qué películas están disponibles en una localidad, por ejemplo: - "qué ponen hoy en Córdoba" - "qué puedo ver este fin de semana en Sevilla" - "qué hay en cartelera mañana en Málaga" También permite filtrar resultados según: - películas aptas para niños - duración máxima - puntuación mínima - solo estrenos - géneros específicos - versión (VOSE, doblada...) o franja horaria (hora_desde/hora_hasta) Si el usuario pide recomendaciones generales en una ciudad, puedes usar esta tool como base.

Busca personas (actores o directores) por nombre con tolerancia a errores. Úsala cuando el usuario no escriba correctamente un nombre o haya ambigüedad, por ejemplo: - "almodovar" - "scorcesse" - "di caprio" Puede filtrar por tipo (actor o director) y priorizar personas con películas en cartel. Es útil antes de consultar la última película o filmografía relevante.

Devuelve TODAS las películas de un actor o director que están en cartelera ahora mismo (con sesiones futuras reales), no solo la más reciente. Úsala cuando el usuario pregunte por la filmografía actual de alguien, por ejemplo: - "qué películas hay de Almodóvar en cartelera" - "qué puedo ver de Cruz en el cine ahora" - "todo lo que hay de Nolan ahora mismo" Diferencia con get_latest_movie_by_person: esa tool está pensada para "la última de X" (una sola película, priorizando la más reciente aunque no esté en cartel); esta siempre filtra a cartelera real y no limita a la más reciente. Útil como base para recomendaciones por gustos de actor/director.

Obtiene la película más reciente asociada a una persona (actor o director). Úsala cuando el usuario pregunte por la última película de alguien, por ejemplo: - "la última de Stallone" - "la última de Scorsese" - "qué es lo último de DiCaprio" Opcionalmente puede limitarse a: - solo películas actualmente en cartel - una ciudad concreta Es útil como paso previo para luego buscar dónde ver esa película.

Busca cines cercanos a un punto, para "qué cines tengo cerca" o "cines cerca de mí"/"cerca de tal sitio". Si el cliente puede compartir coordenadas reales del usuario, pásalas en lat/lng; si no, pasa una localidad (p.ej. "Córdoba") y se usa el centro de esa localidad como referencia. Devuelve los cines ordenados por distancia en km dentro del radio indicado.

Recomienda películas basadas en la cartelera real de una ciudad y fechas concretas. Úsala cuando el usuario pida sugerencias o recomendaciones, por ejemplo: - "qué me recomiendas ver este finde" - "qué puedo ver hoy" - "recomiéndame una película en Córdoba" Admite filtros como: - películas para niños - duración máxima - puntuación mínima - solo estrenos - géneros preferidos o a evitar - versión (VOSE, doblada...) o franja horaria Debe basarse siempre en películas que estén realmente disponibles en cartelera.

Indica en qué plataformas de streaming (suscripción, alquiler o compra) está disponible una película, si tenemos ese dato. Úsala cuando el usuario pregunte, por ejemplo: - "dónde puedo ver Oppenheimer en streaming" - "está en Netflix Dune" - "en qué plataforma puedo alquilar esa película" Si la película no tiene datos de streaming registrados, dilo explícitamente en vez de inventar una plataforma: no todas las películas de la base de datos tienen esta información.