MCP-Server

CarteleraCines.es

es.carteleracines/cartelera
Karten & Standort Medien & Inhalte Öffentlich und erreichbar MCP 2026-07-28

Was dieses MCP kann

Searches Spanish cinemas, films, people, showtimes, local listings, recommendations, movie details, and streaming availability.

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.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': 'OBLIGATORIO. Título o fragmento del título que se desea identificar.'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Opcional. Número máximo de coincidencias; por defecto 10.'}}, 'additionalProperties': False}
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.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'required': ['pelicula'], 'properties': {'cine': {'type': 'string', 'description': 'Opcional. Limita la búsqueda a este cine.'}, 'version': {'type': 'string', 'description': 'Ej: VOSE, Doblada, 3D. Coincidencia parcial.'}, 'pelicula': {'type': 'string', 'description': 'OBLIGATORIO. Título de la película; admite aproximaciones.'}, 'fecha_fin': {'type': 'string', 'format': 'date', 'description': 'Opcional. Fecha final YYYY-MM-DD. Máximo 14 días desde fecha_inicio cuando se indican ambas.'}, 'localidad': {'type': 'string', 'description': 'Opcional. Limita la búsqueda a esta ciudad.'}, 'hora_desde': {'type': 'string', 'description': 'Hora mínima de la sesión, formato HH:MM.'}, 'hora_hasta': {'type': 'string', 'description': 'Hora máxima de la sesión, formato HH:MM.'}, 'fecha_inicio': {'type': 'string', 'format': 'date', 'description': 'Opcional. Fecha inicial YYYY-MM-DD. Si se omite, busca desde ahora.'}}, 'additionalProperties': False}
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.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'properties': {'lat': {'type': 'number', 'maximum': 90, 'minimum': -90, 'description': 'Latitud. Si se usa, lng también es obligatoria.'}, 'lng': {'type': 'number', 'maximum': 180, 'minimum': -180, 'description': 'Longitud. Si se usa, lat también es obligatoria.'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Opcional. Por defecto 10, máximo 50.'}, 'radio_km': {'type': 'number', 'maximum': 200, 'description': 'Opcional. Por defecto 25 km, máximo 200 km.', 'exclusiveMinimum': 0}, 'localidad': {'type': 'string', 'description': 'Ciudad usada como origen cuando no se dispone de lat+lng. Debe indicarse localidad O la pareja lat+lng.'}}, 'additionalProperties': False}
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.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': 'OBLIGATORIO. Nombre o fragmento del nombre.'}, 'tipo': {'enum': ['actor', 'director'], 'type': 'string', 'description': 'Opcional. Filtra por actor o director.'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Opcional. Número máximo de coincidencias; por defecto 10.'}, 'solo_en_cartel': {'type': 'boolean'}}, 'additionalProperties': False}
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).
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'required': ['cine'], 'properties': {'cine': {'type': 'string', 'description': 'OBLIGATORIO. Nombre del cine, por ejemplo "Kinépolis Ciudad de la Imagen".'}, 'generos': {'type': 'array', 'items': {'type': 'string'}}, 'version': {'type': 'string', 'description': 'Ej: VOSE, Doblada, 3D. Coincidencia parcial.'}, 'con_ninos': {'type': 'boolean'}, 'fecha_fin': {'type': 'string', 'format': 'date', 'description': 'Opcional. Fecha final YYYY-MM-DD. Si se omite, coincide con fecha_inicio. Máximo 14 días de rango.'}, 'hora_desde': {'type': 'string', 'description': 'Hora mínima de la sesión, formato HH:MM.'}, 'hora_hasta': {'type': 'string', 'description': 'Hora máxima de la sesión, formato HH:MM.'}, 'duracion_max': {'type': 'integer', 'minimum': 1, 'description': 'Duración máxima en minutos.'}, 'fecha_inicio': {'type': 'string', 'format': 'date', 'description': 'Opcional. Fecha inicial YYYY-MM-DD. Si se omite, se usa hoy.'}, 'solo_estrenos': {'type': 'boolean'}, 'min_puntuacion': {'type': 'number', 'maximum': 10, 'minimum': 0, 'description': 'Puntuación mínima entre 0 y 10.'}}, 'additionalProperties': False}
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.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'required': ['localidad'], 'properties': {'generos': {'type': 'array', 'items': {'type': 'string'}}, 'version': {'type': 'string', 'description': 'Ej: VOSE, Doblada, 3D. Coincidencia parcial.'}, 'con_ninos': {'type': 'boolean'}, 'fecha_fin': {'type': 'string', 'format': 'date', 'description': 'Opcional. Fecha final YYYY-MM-DD. Si se omite, coincide con fecha_inicio. Máximo 14 días de rango.'}, 'localidad': {'type': 'string', 'description': 'OBLIGATORIO. Nombre de la ciudad, por ejemplo "Córdoba".'}, 'hora_desde': {'type': 'string', 'description': 'Hora mínima de la sesión, formato HH:MM.'}, 'hora_hasta': {'type': 'string', 'description': 'Hora máxima de la sesión, formato HH:MM.'}, 'duracion_max': {'type': 'integer', 'minimum': 1, 'description': 'Duración máxima en minutos.'}, 'fecha_inicio': {'type': 'string', 'format': 'date', 'description': 'Opcional. Fecha inicial YYYY-MM-DD. Si se omite, se usa hoy.'}, 'solo_estrenos': {'type': 'boolean'}, 'min_puntuacion': {'type': 'number', 'maximum': 10, 'minimum': 0, 'description': 'Puntuación mínima entre 0 y 10.'}}, 'additionalProperties': False}
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.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'required': ['persona'], 'properties': {'tipo': {'enum': ['actor', 'director'], 'type': 'string', 'description': 'Opcional. Usa "director" solo cuando se busque dirección; por defecto se usa "actor".'}, 'persona': {'type': 'string', 'description': 'OBLIGATORIO. Nombre del actor, actriz o director/a.'}, 'localidad': {'type': 'string'}, 'solo_en_cartel': {'type': 'boolean'}}, 'additionalProperties': False}
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).
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'required': ['pelicula'], 'properties': {'pelicula': {'type': 'string', 'description': 'OBLIGATORIO. Título de la película cuya ficha se solicita.'}}, 'additionalProperties': False}
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.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'required': ['persona'], 'properties': {'tipo': {'enum': ['actor', 'director'], 'type': 'string', 'description': 'Opcional. Por defecto "actor". Usa "director" cuando corresponda.'}, 'persona': {'type': 'string', 'description': 'OBLIGATORIO. Nombre del actor, actriz o director/a.'}, 'localidad': {'type': 'string'}}, 'additionalProperties': False}
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.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'required': ['localidad'], 'properties': {'version': {'type': 'string', 'description': 'Ej: VOSE, Doblada, 3D. Coincidencia parcial.'}, 'con_ninos': {'type': 'boolean'}, 'fecha_fin': {'type': 'string', 'format': 'date', 'description': 'Opcional. Fecha final YYYY-MM-DD. Si se omite, coincide con fecha_inicio. Máximo 14 días de rango.'}, 'localidad': {'type': 'string', 'description': 'OBLIGATORIO. Ciudad en la que deben existir sesiones reales.'}, 'hora_desde': {'type': 'string', 'description': 'Hora mínima de la sesión, formato HH:MM.'}, 'hora_hasta': {'type': 'string', 'description': 'Hora máxima de la sesión, formato HH:MM.'}, 'duracion_max': {'type': 'integer', 'minimum': 1, 'description': 'Duración máxima en minutos.'}, 'fecha_inicio': {'type': 'string', 'format': 'date', 'description': 'Opcional. Fecha inicial YYYY-MM-DD. Si se omite, se usa hoy.'}, 'solo_estrenos': {'type': 'boolean'}, 'evitar_generos': {'type': 'array', 'items': {'type': 'string'}}, 'min_puntuacion': {'type': 'number', 'maximum': 10, 'minimum': 0, 'description': 'Puntuación mínima entre 0 y 10.'}, 'generos_preferidos': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}
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.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'required': ['pelicula'], 'properties': {'pelicula': {'type': 'string', 'description': 'OBLIGATORIO. Título de la película.'}}, 'additionalProperties': False}
Hinzugefügt
get_movie_details
17. September 2026 12:39
Hinzugefügt
find_nearby_cines
17. September 2026 12:39
Hinzugefügt
where_to_watch_online
17. September 2026 12:39
Hinzugefügt
get_person_movies_in_cartelera
17. September 2026 12:39
Hinzugefügt
find_person
17. September 2026 12:39
Hinzugefügt
find_movie
17. September 2026 12:39
Hinzugefügt
get_latest_movie_by_person
17. September 2026 12:39
Hinzugefügt
recommend_movies
17. September 2026 12:39
Hinzugefügt
find_movie_showtimes
17. September 2026 12:39
Hinzugefügt
get_cartelera_cine
17. September 2026 12:39
Hinzugefügt
get_cartelera_localidad
17. September 2026 12:39