# Trakt MCP for AI Agents AI Agent Connect > Trakt lets you pull movie and TV show data directly into your AI workflow. You can search for specific titles, grab cast and crew details, check out what's trending globally, and manage your personal watchlist or watch history without leaving your chat window. It turns your AI into a personal media librarian that knows exactly what you've seen and what's coming up next on your favorite shows. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_Sg0Pbv7nL0FsgSCaVIZPXUhsbUe0AXBm3IeakuaT/ai-agent-connect - **Tags:** media-tracking, watch-history, tv-shows, movies, ratings, content-discovery ## Description Imagine you're trying to plan a movie night or research a specific actor's filmography. Usually, that means opening five different tabs, scrolling through messy fan sites, and trying to remember which show you were halfway through last week. This Trakt connection changes that by giving your agent a direct line to one of the world's biggest media databases. Instead of hunting for info, you just ask. You can grab a full breakdown of a TV series, see who is in the cast, or find out what is currently popular in real-time. It handles the heavy lifting of data retrieval so you can focus on the actual watching. When you use the Vinkius Marketplace to connect this Trakt MCP, your agent starts acting like a media expert. You can build a custom recommendation list based on what you have already watched, or get a precise schedule of upcoming episodes for every show on your list. It is about moving from searching to knowing. Whether you are a hardcore cinephile keeping a meticulous log or a creator looking for specific cast data for a script, this tool puts the data in your hands. You do not have to go looking for the ratings or the genres; the agent just brings them to you. ## Tools ### get_calendar Fetch a list of upcoming episode air dates and times for shows. This helps you stay on top of your favorite series. ### get_movie_people List the cast and crew members for a particular movie. Use this to quickly see who acted in or directed a film. ### get_movie_ratings See the breakdown of how users have rated a specific film. This shows you the consensus on a movie's quality. ### get_popular See what movies and shows are currently seeing the most engagement. This helps you find what everyone is watching. ### get_related_movies Find films that are similar to a movie you already like. Use this to discover new content based on your taste. ### get_related_shows Discover new TV series that are similar to a show you enjoy. This helps you find your next favorite binge. ### get_show_episodes Get a list of every episode for a specific season of a show. This helps you navigate through a long series. ### get_show_people Pull the full cast and crew list for a specific TV series. Use this to see the talent behind any show. ### get_show_ratings View the average scores and rating distributions for a TV show. This helps you judge the quality of a series. ### get_show_seasons List all available seasons for a show along with their air dates. This helps you see the full scope of a series. ### get_trending See what content is currently being watched by the most people. This helps you find real-time popular media. ### search Look up movies, shows, people, or lists using specific keywords. This is your primary way to find any media title. ### get_show Pull the complete details for a TV show including its network and status. This gives you a full breakdown of a series. ### get_collection Pull the items you have saved in your personal Trakt collection. This lets your agent see your curated media. ### get_history Retrieve a list of shows and movies you have already watched. It helps you track your viewing progress accurately. ### get_movie Get a full overview of a specific movie including its rating and runtime. This provides a quick summary of any film. ### get_watched Pull your personal watch history with play counts and timestamps. This keeps your personal viewing records accurate. ### get_watchlist Retrieve all the movies and shows you have saved to your watchlist. This lets your agent see what you want to watch next. ## Prompt Examples **Prompt:** ``` What's trending in sci-fi right now? ``` **Response:** ``` ### Currently Trending in Sci-Fi | Title | Viewers | Rating | | :--- | :--- | :--- | | **Dune: Part Two** | 3.2K | 8.9/10 | | **The Creator** | 2.1K | 7.5/10 | | **Foundation** | 1.8K | 8.2/10 | *These titles are currently seeing high engagement on Trakt.* ``` **Prompt:** ``` Who directed Inception and who's in it? ``` **Response:** ``` **Inception (2010)** * **Director:** Christopher Nolan * **Lead Cast:** * Leonardo DiCaprio as Cobb * Joseph Gordon-Levitt as Arthur * Ellen Page as Ariadne * Tom Hardy as Eames ``` **Prompt:** ``` Give me a list of episodes for Season 1 of Stranger Things. ``` **Response:** ``` **Stranger Things: Season 1** * **Episode 1:** Eleven (Oct 15, 2016) * **Episode 2:** OG (Oct 22, 2016) * **Episode 3:** The Vanishing of Will Byers (Oct 29, 2016) * **Episode 4:** The Body (Nov 5, 2016) * **Episode 5:** The Haunting of Hill House (Nov 12, 2016) * **Episode 6:** The Secret of One (Nov 19, 2016) ``` ## Capabilities ### Search movies and actors Find specific titles, people, or lists using natural language. ### Retrieve show details Get full season breakdowns, episode lists, and cast information. ### Track your watch history Keep a record of what you have seen and your personal collections. ### Discover trending content See what is currently popular on a global scale in real-time. ### View release calendars Check upcoming air dates and premiere times for your favorite shows. ### Find related media Get recommendations for movies and shows similar to your favorites. ## Use Cases ### Planning a binge A user asks for shows similar to a specific drama. The agent uses `get_related_shows` to find comparable titles. ### Researching a lead A writer asks for the cast of a movie to check availability. The agent uses `get_movie_people` to pull the list. ### Checking the schedule A fan asks when the next episode of a series airs. The agent uses `get_calendar` to provide the exact time. ### Reviewing a film A critic wants to see how people rated a new release. The agent uses `get_movie_ratings` to show the distribution. ## Benefits - Stop tab switching by using `search` to find movies and actors in one place. - Keep your media log updated automatically with `get_watched` and `get_history`. - Plan your viewing schedule with `get_calendar` to see upcoming episode dates. - Find your next binge-watch quickly using `get_related_shows` and `get_related_movies`. - Get deep cast and crew insights instantly with `get_show_people` and `get_movie_people`. - Analyze audience sentiment by pulling rating distributions with `get_movie_ratings`. ## How It Works The bottom line is you get instant access to a massive movie and TV database without ever leaving your AI chat. 1. Subscribe to the Trakt MCP via the Vinkius Marketplace. 2. Provide your Trakt Client ID from your developer account settings. 3. Ask your AI client to find trending shows or check your watchlist. ## Frequently Asked Questions **Can the Trakt MCP help me find shows similar to what I like?** Yes, it can find related shows based on your favorites. It looks at your preferences to suggest new content you might enjoy. **How does the Trakt MCP handle my personal watch history?** It pulls your actual watched items and play counts from your account. This helps your agent keep your personal viewing records accurate. **Can I use the Trakt MCP to see when my favorite show airs next?** Yes, it pulls upcoming episode dates and times for shows. You can ask your agent for the schedule of any series in your list. **Does the Trakt MCP work for movie ratings too?** Yes, it shows the average score and the vote distribution for movies. This helps you judge the quality of a film before watching. **Can the Trakt MCP search for specific actors?** Yes, it can find people, their IDs, and their filmographies. You can ask for any actor's work history or cast details. **How do I get my personal watchlist into my AI client?** By connecting this Connector, your agent gains access to your saved items. You can then ask it to tell you what is on your list to watch. **How do I get a Trakt Client ID?** Sign up for a free Trakt account at [**trakt.tv**](https://trakt.tv), go to [**OAuth Applications**](https://trakt.tv/oauth/applications), click 'Create an Application' and fill in the details. Your Client ID is displayed immediately. **Can I use IDs from IMDb or TVDB?** Yes! Trakt accepts Trakt IDs, URL slugs (e.g. 'the-matrix'), IMDb IDs (e.g. 'tt0133093') and TMDB IDs for movies. For shows it accepts Trakt IDs, slugs, TVDB IDs and TMDB IDs. **What's the difference between trending and popular?** Trending shows what users are actively watching RIGHT NOW (real-time). Popular shows have the highest overall engagement over time. Trending is more dynamic and changes frequently. **Can I sync my watchlist and history?** Yes! Use get_watchlist, get_watched, get_collection and get_history with OAuth authentication. These endpoints require an access token in addition to your Client ID. Visit trakt.tv/oauth/applications to set up OAuth.