# CarteleraCines.es MCP server

Cartelera de España: películas, cines, sesiones, recomendaciones y enlaces de compra.

## Links
- Registry page: https://www.getdrio.com/mcp/es-carteleracines-cartelera
- Repository: https://github.com/surferkoala/cartelera-cines
- Website: https://www.carteleracines.es/

## Install
- Endpoint: https://www.carteleracines.es/mcp_server.php
- Auth: Not captured

## Setup notes
- Remote endpoint: https://www.carteleracines.es/mcp_server.php

## Tools
- get_cartelera_localidad - 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. Endpoint: https://www.carteleracines.es/mcp_server.php
- get_cartelera_cine - 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). Endpoint: https://www.carteleracines.es/mcp_server.php
- find_movie_showtimes - 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. Endpoint: https://www.carteleracines.es/mcp_server.php
- recommend_movies - 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. Endpoint: https://www.carteleracines.es/mcp_server.php
- get_latest_movie_by_person - 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. Endpoint: https://www.carteleracines.es/mcp_server.php
- find_movie - 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. Endpoint: https://www.carteleracines.es/mcp_server.php
- find_person - 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. Endpoint: https://www.carteleracines.es/mcp_server.php
- get_person_movies_in_cartelera - 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. Endpoint: https://www.carteleracines.es/mcp_server.php
- where_to_watch_online - 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. Endpoint: https://www.carteleracines.es/mcp_server.php
- find_nearby_cines - 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. Endpoint: https://www.carteleracines.es/mcp_server.php
- get_movie_details - 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). Endpoint: https://www.carteleracines.es/mcp_server.php

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: es.carteleracines
- Version: 1.1.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 23, 2026
- Source: https://registry.modelcontextprotocol.io
