CarteleraCines.es

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

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

Measured statistics

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "CarteleraCines.es": {
      "url": "https://www.carteleracines.es/mcp_server.php",
      "transport": "streamable-http"
    }
  }
}

Measured tools (11)

• get_cartelera_localidad read-only

  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.

  Parameters:

  • localidad (required) — string — OBLIGATORIO. Nombre de la ciudad, por ejemplo "Córdoba".
  • generos — array
  • version — string — Ej: VOSE, Doblada, 3D. Coincidencia parcial.
  • con_ninos — boolean
  • fecha_fin — string — Opcional. Fecha final YYYY-MM-DD. Si se omite, coincide con fecha_inicio. Máximo 14 días de rango.
  • hora_desde — string — Hora mínima de la sesión, formato HH:MM.
  • hora_hasta — string — Hora máxima de la sesión, formato HH:MM.
  • duracion_max — integer — Duración máxima en minutos.
  • fecha_inicio — string — Opcional. Fecha inicial YYYY-MM-DD. Si se omite, se usa hoy.
  • solo_estrenos — boolean
  • min_puntuacion — number — Puntuación mínima entre 0 y 10.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_cartelera_cine read-only

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

  Parameters:

  • cine (required) — string — OBLIGATORIO. Nombre del cine, por ejemplo "Kinépolis Ciudad de la Imagen".
  • generos — array
  • version — string — Ej: VOSE, Doblada, 3D. Coincidencia parcial.
  • con_ninos — boolean
  • fecha_fin — string — Opcional. Fecha final YYYY-MM-DD. Si se omite, coincide con fecha_inicio. Máximo 14 días de rango.
  • hora_desde — string — Hora mínima de la sesión, formato HH:MM.
  • hora_hasta — string — Hora máxima de la sesión, formato HH:MM.
  • duracion_max — integer — Duración máxima en minutos.
  • fecha_inicio — string — Opcional. Fecha inicial YYYY-MM-DD. Si se omite, se usa hoy.
  • solo_estrenos — boolean
  • min_puntuacion — number — Puntuación mínima entre 0 y 10.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• find_movie_showtimes read-only

  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.

  Parameters:

  • pelicula (required) — string — OBLIGATORIO. Título de la película; admite aproximaciones.
  • cine — string — Opcional. Limita la búsqueda a este cine.
  • version — string — Ej: VOSE, Doblada, 3D. Coincidencia parcial.
  • fecha_fin — string — Opcional. Fecha final YYYY-MM-DD. Máximo 14 días desde fecha_inicio cuando se indican ambas.
  • localidad — string — Opcional. Limita la búsqueda a esta ciudad.
  • hora_desde — string — Hora mínima de la sesión, formato HH:MM.
  • hora_hasta — string — Hora máxima de la sesión, formato HH:MM.
  • fecha_inicio — string — Opcional. Fecha inicial YYYY-MM-DD. Si se omite, busca desde ahora.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• recommend_movies read-only

  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.

  Parameters:

  • localidad (required) — string — OBLIGATORIO. Ciudad en la que deben existir sesiones reales.
  • version — string — Ej: VOSE, Doblada, 3D. Coincidencia parcial.
  • con_ninos — boolean
  • fecha_fin — string — Opcional. Fecha final YYYY-MM-DD. Si se omite, coincide con fecha_inicio. Máximo 14 días de rango.
  • hora_desde — string — Hora mínima de la sesión, formato HH:MM.
  • hora_hasta — string — Hora máxima de la sesión, formato HH:MM.
  • duracion_max — integer — Duración máxima en minutos.
  • fecha_inicio — string — Opcional. Fecha inicial YYYY-MM-DD. Si se omite, se usa hoy.
  • solo_estrenos — boolean
  • evitar_generos — array
  • min_puntuacion — number — Puntuación mínima entre 0 y 10.
  • generos_preferidos — array

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_latest_movie_by_person read-only

  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.

  Parameters:

  • persona (required) — string — OBLIGATORIO. Nombre del actor, actriz o director/a.
  • tipo — string — Opcional. Usa "director" solo cuando se busque dirección; por defecto se usa "actor".
  • localidad — string
  • solo_en_cartel — boolean

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• find_movie read-only

  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.

  Parameters:

  • q (required) — string — OBLIGATORIO. Título o fragmento del título que se desea identificar.
  • limit — integer — Opcional. Número máximo de coincidencias; por defecto 10.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• find_person read-only

  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.

  Parameters:

  • q (required) — string — OBLIGATORIO. Nombre o fragmento del nombre.
  • tipo — string — Opcional. Filtra por actor o director.
  • limit — integer — Opcional. Número máximo de coincidencias; por defecto 10.
  • solo_en_cartel — boolean

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_person_movies_in_cartelera read-only

  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.

  Parameters:

  • persona (required) — string — OBLIGATORIO. Nombre del actor, actriz o director/a.
  • tipo — string — Opcional. Por defecto "actor". Usa "director" cuando corresponda.
  • localidad — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• where_to_watch_online read-only

  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.

  Parameters:

  • pelicula (required) — string — OBLIGATORIO. Título de la película.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• find_nearby_cines read-only

  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.

  Parameters:

  • lat — number — Latitud. Si se usa, lng también es obligatoria.
  • lng — number — Longitud. Si se usa, lat también es obligatoria.
  • limit — integer — Opcional. Por defecto 10, máximo 50.
  • radio_km — number — Opcional. Por defecto 25 km, máximo 200 km.
  • localidad — string — Ciudad usada como origen cuando no se dispone de lat+lng. Debe indicarse localidad O la pareja lat+lng.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_movie_details read-only

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

  Parameters:

  • pelicula (required) — string — OBLIGATORIO. Título de la película cuya ficha se solicita.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.