Allociné

This MCP server lets you retrieve film data and showtimes from Allociné. You can search for a movie by title to obtain its Allociné ID, and fetch showtimes across multiple days for a given location, along with cinema details and formats like VF, VOST, 3D, or IMAX.

How to use

You will use a client that supports MCP servers to query Allociné data. Start by finding a movie’s Allociné ID with search_movies. Then request showtimes for that movie in a specific location and date range with get_showtimes or fetch a cinema’s full schedule with get_cinema_showtimes. You can also discover cinemas that accept certain cards with get_cinemas_by_card and retrieve booking links for a movie in a cinema with get_movie_booking_links. All results reflect the information scraped from the source site, including dates and cinema formats.

Getting movie IDs and showtimes

First, find a movie ID using search_movies by providing the movie title. Then use get_showtimes with the returned movie_id and a location to see available showtimes across dates.

What you can retrieve with each tool

• search_movies returns a movie ID from a title.

• get_movies_now_showing returns currently playing titles (pagination controls how many pages to load).

• search_cinemas finds cinemas by name or city.

• get_showtimes returns showtimes for a movie at a location, potentially across several days, with an optional date filter.

• get_cinema_showtimes returns a cinema’s full schedule for an optional date.

• get_cinemas_by_card lists cinemas that accept a specific card (e.g., UGC Illimité or Pathé Cinépass) and can filter by location.

• get_movie_booking_links returns booking links for a movie in a cinema.

Note on scraping behavior

This server relies on scraping HTML pages via axios and cheerio. It depends on the site structure remaining stable. If the site changes, you may need to adjust the parsing logic to keep results accurate.

Configuration for MCP clients

To enable this Allociné MCP server in a client, add a configuration entry that points to the local server executable and its startup path.

Example configuration snippet

{
  "mcpServers": {
    "allocine": {
      "command": "node",
      "args": ["/chemin/vers/allocine-mcp-server/build/index.js"]
    }
  }
}

Available tools

search_movies

Find a movie by title and obtain its Allociné ID.

get_movies_now_showing

Retrieve the list of movies currently showing, with optional paging control.

search_cinemas

Search cinemas by name or city.

get_showtimes

Get showtimes for a movie at a location, across multiple days if needed, with optional date filtering.

get_cinema_showtimes

Get the full schedule for a specific cinema and optional date.

get_cinemas_by_card

List cinemas that accept a specific card type and filter by location.

get_movie_booking_links

Retrieve booking links for a movie in a cinema.