Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use The Movie Database (TMDb) with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Search movies, TV shows, people, get details, cast, trailers, and discover content via TMDb API.

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 15 capabilities

The complete The Movie Database (TMDb) capability set.

These are the exact actions your AI can choose when you ask it to work with The Movie Database (TMDb).

Capability set01 / 04

01-04

4 capabilities in this set.

Part of 15 available through The Movie Database (TMDb).

  1. 01

    Discover movies

    Find movies matching very specific criteria. Available filters: genre (genre IDs, comma-separated for OR), year, sortBy (popularity, rating, revenue, release date), vote_average.gte (minimum rating), with_companies (studio IDs, comma-separated), with_keywords (keyword IDs), primary_release_date.gte/lte (date range YYYY-MM-DD). Sort options: popularity.desc, popularity.asc, release_date.desc, release_date.asc, vote_average.desc, vote_average.asc, revenue.desc, revenue.asc, title.asc, title.desc. Use this for complex queries like "action movies from 2024 with rating above 7", "Warner Bros movies from the last year", or "horror movies sorted by rating". Genre IDs can be obtained from the get_genres capability. Company ID 17 = Warner Bros, 420 = Marvel Studios, 33 = Universal, etc. Discover movies with advanced filtering by genre, year, rating, studio, and more

  2. 02

    Find by external ID

    The externalSource parameter must be one of: "imdb_id", "tvdb_id", "freebase_mid", "freebase_id", "tvrage_id", "wikidata_id". Returns matching movies, TV shows, and/or people from TMDb that have this external ID. Use this when you have an IMDb ID (like "tt0111161" for Shawshank Redemption) and want to find the corresponding TMDb entry. Common use case: converting IMDb IDs to TMDb IDs for use with other capabilities. IMDb IDs for movies start with "tt" followed by numbers (e.g., "tt0137523" for Fight Club). Results include all matching items across movies, TV, and people categories. Find movies, TV shows, or people using external IDs (IMDb, TVDb, etc)

  3. 03

    Get genres

    Each genre includes: id (numeric ID used for filtering in other capabilities) and name (localized genre name). Use this to get genre IDs needed for the discover_movies capability or to answer questions about available genres. Common movie genres: 28=Action, 12=Adventure, 16=Animation, 35=Comedy, 80=Crime, 18=Drama, 14=Fantasy, 27=Horror, 878=Science Fiction, 53=Thriller, 10749=Romance. The type parameter must be "movie" or "tv". Optional language parameter returns localized genre names. Get the complete list of movie or TV show genres with their IDs

  4. 04

    Get movie

    Returns: title, overview, runtime, release date, budget, revenue, vote average, vote count, genres, production companies, production countries, spoken languages, status, tagline, homepage, IMDb ID, poster/backdrop image paths, and collection information (if part of a franchise). Use this after a search to get full details about a specific movie. The movieId parameter is the TMDb ID (integer) returned by search_movies or other movie list capabilities. Optional language parameter returns localized title and overview if available. Get complete details for a specific movie by its TMDb ID

Capability set02 / 04

05-08

4 capabilities in this set.

Part of 15 available through The Movie Database (TMDb).

  1. 05

    Get movie credits

    Returns two arrays: "cast" (actors with their characters, order, and profile images) and "crew" (directors, producers, writers, cinematographers, editors, composers, etc. with their jobs and departments). Use this when users ask "who starred in...", "who directed...", or want the full cast list of a movie. The movieId is the TMDb ID from search results. Cast includes: actor name, character name, order (billing order), profile image path. Crew includes: name, job title (Director, Producer, Screenplay, etc.), department. Get complete cast and crew information for a specific movie

  2. 06

    Get movie recommendations

    TMDb uses an algorithm that considers genre, keywords, cast, crew, and user rating patterns to suggest similar movies that fans of the original might enjoy. Each recommendation includes: title, release date, overview, poster path, vote average, vote count, and TMDb ID. Use this when users ask "if I liked X, what should I watch?", "movies similar to...", or "recommendations for...". The movieId is the TMDb ID of the reference movie. Results are paginated; use the page parameter to get more recommendations. Get movie recommendations based on a specific movie (similar titles)

  3. 07

    Popular movies

    Each movie includes: title, release date, overview, poster path, vote average, vote count, genre IDs, and TMDb ID. Use this when users ask "what movies are popular now?", "what is trending?", or want movie recommendations. Results are updated regularly based on TMDb user activity. Optional: page for pagination, region (ISO 3166-1 country code like "US", "BR") for country-specific popularity, and language for localized titles and descriptions. Get a list of currently popular movies on TMDb

  4. 08

    Popular tv

    Popularity is based on user activity, view counts, and trending data. Each TV show includes: name, first air date, overview, poster path, vote average, vote count, genre IDs, number of seasons, number of episodes, origin country, and TMDb ID. Use this when users ask "what TV shows are popular?", "what should I watch?", or want series recommendations. Optional: page for pagination and language for localized titles and descriptions. Get a list of currently popular TV shows on TMDb

Capability set03 / 04

09-12

4 capabilities in this set.

Part of 15 available through The Movie Database (TMDb).

  1. 09

    Search multi

    Returns results from all three categories with a media_type field indicating the type ("movie", "tv", or "person"). Use this when users provide a general search term and you want to return all relevant results across content types. Ideal for broad queries like "Christopher Nolan" (returns movies directed by him + person profile) or "Star Wars" (returns movies + TV series). The query parameter is required. Optional: page for pagination and language for localized results. Search movies, TV shows, and people simultaneously in the TMDb database

  2. 10

    Top rated movies

    These are the critically acclaimed films with the best user ratings. Each movie includes: title, release date, overview, vote average, vote count, poster path, genre IDs, and TMDb ID. Use this when users ask for "best movies ever", "top rated films", "highest rated movies", or want quality recommendations. This list includes classics like The Shawshank Redemption, The Godfather, and other critically acclaimed films. Optional: page for pagination and language for localized results. Get a list of the highest-rated movies of all time on TMDb

  3. 11

    Top rated tv

    These are the most critically acclaimed series with the best user ratings. Each TV show includes: name, first air date, overview, vote average, vote count, poster path, number of seasons and episodes, and TMDb ID. Use this when users ask for "best TV shows ever", "top rated series", or want quality TV recommendations. This list includes acclaimed series like Breaking Bad, Band of Brothers, Chernobyl, and other top-rated shows. Optional: page for pagination and language for localized results. Get a list of the highest-rated TV shows of all time on TMDb

  4. 12

    Trending

    The mediaType parameter can be: "movie", "tv", "person", or "all" (returns mixed results with media_type field). The timeWindow parameter can be: "day" (trending today) or "week" (trending this week). Each result includes: title/name, overview, poster path, vote average, popularity score, and media type. Use this when users ask "what is trending?", "what is popular today?", or want to see what is currently hot in entertainment. The trending algorithm considers user activity, page views, and search patterns on TMDb. Get trending content (movies, TV shows, or people) on TMDb for today or this week

Capability set04 / 04

13-15

3 capabilities in this set.

Part of 15 available through The Movie Database (TMDb).

  1. 13

    Get movie videos

    Each video result includes: video key (YouTube ID), site (YouTube), type (Trailer, Teaser, Clip, Behind the Scenes, etc.), name, size (resolution), official status, and publish date. Use this when users want to watch trailers, find official promotional videos, or access movie video content. YouTube videos can be viewed at: https://www.youtube.com/watch?v={key}. The movieId is the TMDb movie ID. Get trailers, teasers, clips, and behind-the-scenes videos for a movie

  2. 14

    Search movies

    Returns movie titles, release dates, overview descriptions, poster images, vote averages, and TMDb IDs. Use this when users ask to find movies by title, search for films about a topic, or look up movies from a specific year. The query parameter is required and should be the movie title or search term. Optional parameters: year (YYYY format) to filter by release year, page for pagination (1-500), and language (ISO 639-1 code like "pt-BR", "en-US", "es") to get results in a specific language. Example: query="The Matrix", year="1999" returns the 1999 sci-fi classic. Search for movies by title, keyword, or phrase in the TMDb database

  3. 15

    Search tv

    Returns TV show names, first air dates, episode counts, overview descriptions, poster images, vote averages, and TMDb IDs. Use this when users ask to find TV series, look up shows by title, or search for programs about a specific topic. The query parameter is required. Optional: year to filter by first air date year, page for pagination, and language for localized results. Example: query="Breaking Bad" returns the critically acclaimed drama series. Search for TV shows by title or keyword in the TMDb database

Observed, not estimated

1001ms average. Fast in production.

The Movie Database (TMDb) is checked daily against the live service.

Daily averagePeak 1215ms
Aug 20Today
Fastest day
850ms
Slowest day
1215ms
14-day trend
Slowing+5%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 15 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of The Movie Database (TMDb), so you can see the experience inside your AI.

It does not authenticate your account with The Movie Database (TMDb). Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

The Movie Database (TMDb) Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_PwpTsQbfR9xNdl8ZJhMlsLyVzRo7NqNWmg3ZzOR6/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — The Movie Database (TMDb) capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "the-movie-database-tmdb-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_PwpTsQbfR9xNdl8ZJhMlsLyVzRo7NqNWmg3ZzOR6/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions The Movie Database (TMDb) owners ask.

  • 01

    How do I find movies similar to one I already watched and loved?

    Use the get_movie_recommendations capability with the TMDb ID of the movie you loved. TMDb's algorithm analyzes genre, keywords, cast, crew, and user rating patterns to suggest films you're likely to enjoy. For example, if you loved The Dark Knight (ID: 155), the capability will recommend similar superhero and crime thrillers. You can find the TMDb ID by first using search_movies with the title.

  • 02

    Can I filter movies by a specific studio like Warner Bros. or Marvel?

    Yes! Use the discover_movies capability with the with_companies parameter. Studio IDs include: 17 (Warner Bros.), 420 (Marvel Studios), 33 (Universal Pictures), 2 (Walt Disney Pictures), 5 (Columbia Pictures), 12 (New Line Cinema). You can combine with other filters like genre, year, or minimum rating. For example: genre="878" (Sci-Fi), with_companies="420" returns all Marvel sci-fi movies sorted by popularity.

  • 03

    Can I watch trailers directly through this integration?

    The get_movie_videos capability retrieves all official trailers, teasers, and promotional videos for any movie. Each result includes a YouTube video key. You can watch the trailer by visiting https://www.youtube.com/watch?v={key}. The capability returns videos sorted by type (Trailer, Teaser, Behind the Scenes) with resolution and official status information.

  • 04

    How can I find what movies are trending right now?

    Use the trending capability with media_type="movie" and time_window="day" for today's trending movies, or time_window="week" for this week's trends. You can also use media_type="all" to see mixed results (movies, TV shows, and people) or media_type="tv" for trending series. Results include popularity scores, vote averages, and poster images.

  • 05

    Can I convert an IMDb ID to a TMDb entry?

    Yes! Use the find_by_external_id capability with the IMDb ID (e.g., "tt0111161" for The Shawshank Redemption) and external_source="imdb_id". The capability will return the matching TMDb movie, TV show, or person with the TMDb ID, which you can then use with other capabilities like get_movie, get_movie_credits, or get_movie_videos. This is essential for cross-referencing between IMDb and TMDb databases.

Explore

More in Knowledge Management

Suggestions