# Trakt MCP > Trakt MCP Server tracks your entire media life—movies and TV shows. It lets your AI client search titles, pull deep movie details (cast, ratings), manage your watchlists, and check what's trending right now. If you need to track content consumption or research film data programmatically, this is it. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** media-tracking, watch-history, tv-shows, movies, ratings, content-discovery ## Description Trakt's the deal when you need to track media—movies and TV shows—programmatically. Your agent can read deep metadata from this server, letting you do way more than just look up a title. You’ll be able to pull everything from cast lists to your personal viewing history. ### Discovery and Searching You gotta find content fast. Use `search` to check across the whole library for any kind of stuff—a movie, a show, an episode, or even a person—just by title or name. If you’re curious what people are watching right now, run `get_trending` or use `get_popular` to see titles spiking in engagement. Need something similar? You can run `get_related_movies` to find films comparable to one you know, or check out `get_related_shows` for series that share a genre with another show. ### Content Deep Dives and Details When you’ve found a title, you need the stats. Use `get_movie` to grab detailed metadata for any film, including its overview, runtime, genre list, and poster URLs. For TV shows, `get_show` pulls up details like the network, status, genres, and posters. To get full context on a series, first use `get_show_seasons`, which lists every season number, its episode count, and when it aired. Then, you can drill down with `get_show_episodes` to list all episodes for a specific season, getting the air date and runtime for each one. If you need cast info, you’re covered. Use `get_movie_people` to pull names and job titles associated with a specific movie's crew or cast. For entire TV series, `get_show_people` retrieves the complete list of cast and crew members. You can get rating metrics for any film using `get_movie_ratings`, which gives you total ratings, average scores, and vote counts. Similarly, `get_show_ratings` returns a breakdown of the show’s score distribution, average, and how many votes it got. ### Tracking Your Consumption and Schedule This is where your agent gets personal. It can check what you've watched in the past using `get_history`, which gives you a list of content titles you viewed before, letting you filter by type or ID. For current status, `get_watched` shows you content items you’ve seen, along with play counts and exact timestamps for when you last tuned in. You can keep an eye on your future viewing schedule using `get_calendar`, which retrieves upcoming air dates, times, and full show details based on whether you scope it to just yourself or all shows. You'll also manage what you plan to watch with two key tools: use `get_watchlist` to pull up every movie and/or show you added to your personal list. And if you want episode specifics for a user, `get_show_episodes` lists them out for a specific season. ### Your AI Client's Power Your agent can’t just read one thing; it connects all the dots. It uses `get_collection` to return every item you manually flagged on Trakt, giving metadata and media links all in one place. You can check out everything that's trending right now using `get_trending`, which pulls up movies or shows currently spiking based on activity and viewing counts. ## Tools ### get_calendar Retrieves upcoming episode air dates, times, and full show information for a given scope (user or all shows). ### get_collection Returns the items you have manually collected on Trakt, including metadata and media links. ### get_history Retrieves a list of content titles you've watched in the past, optionally filtered by type or ID. ### get_movie Gets detailed metadata for one movie, including its overview, runtime, genre, and poster URLs. ### get_movie_people Finds the cast or crew members associated with a specific film, giving their name and job title. ### get_movie_ratings Provides the total ratings, average score, and vote counts for any given movie. ### get_popular Returns a paginated list of movies or shows that are generally popular right now based on overall engagement. ### get_related_movies Finds other movies similar to one you specified, including their title, rating, and overview. ### get_related_shows Identifies TV shows that are related to a specific show, giving titles and ratings for comparison. ### get_show Gets detailed metadata for one TV show, including its network, status, genres, and poster URLs. ### get_show_episodes Lists all episodes belonging to a specific season of a TV show, including their air date and runtime. ### get_show_people Retrieves the full cast and crew list for any given television series. ### get_show_ratings Returns the rating distribution, average score, and vote counts specific to a TV show. ### get_show_seasons Lists all seasons for a TV show, providing the season number, episode count, and air date. ### get_trending Returns movies or shows that are currently spiking in popularity based on user activity and viewing counts. ### get_watched Shows the authenticated user a list of content items they have watched, along with play counts and last viewed timestamps. ### get_watchlist Retrieves all movies and/or shows that the authenticated user has added to their personal watchlist. ### search Searches across Trakt for any content type—movie, show, episode, person, or list—by title or name. ## Prompt Examples **Prompt:** ``` What movies are trending right now? ``` **Response:** ``` Top trending movies: 1. Dune: Part Two (3.2K viewers) — 2. Oppenheimer (2.8K) — 3. Deadpool & Wolverine (2.1K) — 4. The Batman (1.9K) — 5. Poor Things (1.5K). All with viewer counts and ratings. ``` **Prompt:** ``` Show me info about Breaking Bad. ``` **Response:** ``` Breaking Bad (2008-2013) — Rating: 9.5/10 from 125K votes. Genres: Drama, Crime, Thriller. Network: AMC. 5 seasons, 62 episodes. Overview: A high school chemistry teacher diagnosed with terminal cancer turns to manufacturing meth to secure his family's future. ``` **Prompt:** ``` Who directed The Matrix and who starred in it? ``` **Response:** ``` The Matrix (1999) — Directors: Lana Wachowski, Lilly Wachowski. Cast: Keanu Reeves (Neo), Laurence Fishburne (Morpheus), Carrie-Anne Moss (Trinity), Hugo Weaving (Agent Smith), Joe Pantoliano (Cypher). ``` ## Capabilities ### Search and Discovery Find specific content—movies, shows, or people—and see what's currently popular or trending. ### Content Metadata Retrieval Get detailed information on a movie or show, including cast lists (`get_movie_people`), full season breakdowns, and ratings metrics. ### Personal Consumption Tracking Access authenticated data like your viewing history, items saved to your watchlist, or upcoming episode air dates. ### Relationship Mapping Find related content. You can get movies similar to a title (`get_related_movies`) or shows in the same genre (`get_related_shows`). ## Use Cases ### A writer needs a guide for an article on classic sci-fi. The writer prompts their agent: 'Give me stats and cast info for *Blade Runner*.' The agent runs `get_movie` to get the overview, then calls `get_movie_people` to list the main stars. Finally, it checks `get_related_movies` to find other titles that fit the genre, building a comprehensive draft in one go. ### A user wants to know when their favorite show airs next. Instead of checking the network's website, the user asks: 'When is Season 5 of *The Great* airing?' The agent runs `get_show` first, then uses `get_show_seasons` and finally calls `get_calendar`. It reports back the next premiere date directly. ### A student needs to track their own viewing metrics for a class project. The agent runs `get_watched` to pull every title played, along with timestamps. Then it uses `get_collection` to see what the user marked as 'must-watch.' This gives the student a complete, programmatically retrieved history of their media consumption. ### A marketer needs ideas for related content promotion. The prompt is: 'Suggest three movies similar to *Parasite*.' The agent runs `get_movie` on the source title, and then uses `get_related_movies`. It pulls titles with ratings and overviews, giving immediate suggestions for cross-promotion. ## Benefits - See exactly what's popular right now by calling `get_trending`. This tells you which shows are spiking in viewership, letting you build timely content around real-time metrics. You don't have to check multiple sites for this info. - Deeply research any title using `get_movie` or `get_show`. These tools give you genre breakdowns, runtime, and network data instantly—all without leaving your chat window. It’s perfect for fact-checking content guides. - Keep track of personal media habits by pulling history from `get_watched` or managing what you plan to see using `get_watchlist`. This keeps all your consumption metrics centralized for analysis. - Understand the full scope of a show's production. Use `get_show_seasons` to get season counts and air dates, then use `get_show_episodes` to drill down into specific episode runtimes and titles. - Cross-reference content instantly. Need to know who directed a film? Use `get_movie_people`. This tool pulls the director/cast list directly tied to the movie's metadata. ## How It Works The bottom line is, your AI client handles the API calls; you just ask it what media info you need. 1. First, subscribe to the Trakt server and provide your required OAuth Client ID. 2. Next, prompt your AI client with a request (e.g., 'What are the cast members of *Dune*?'). 3. The agent routes the query through the appropriate tool (like `get_movie` or `get_movie_people`) and returns structured data. ## Frequently Asked Questions **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. **When I use get_history, does the tool show every single watch event?** It shows your authenticated viewing history. This list includes play counts and timestamps for when you watched items. You can also optionally filter this data by type or specific item ID. **How do I narrow down results when running the search tool?** You pass a 'type' parameter to restrict the results. Use 'movie', 'show', 'episode', 'person', or 'list'. This tells the agent exactly what kind of content you are looking for. **What extra details does get_movie provide beyond just the title and rating?** The tool delivers comprehensive metadata. You get the year, overview, runtime, genre list, certification data, and direct links to posters and trailers. It's much deeper than a basic search result. **How should I handle large amounts of content when using get_popular?** The results are paginated, meaning they come in batches. You must check the response payload for a cursor or next page token to retrieve all available data. Don't assume everything loads at once.