{"name":"io.github.Grinv/tmdb-mcp","slug":"grinv-tmdb-mcp","title":"TMDB MCP Server","description":"MCP server for The Movie Database (TMDB) with IMDb/Rotten Tomatoes/Metacritic ratings via OMDb.","url":"https://mcp.market/server/grinv-tmdb-mcp","rating":null,"grade":"B","score":75,"certified":false,"status":"active","category":"data","tags":["data"],"presence":{"score":33,"stars":4,"forks":0,"downloads_week":207,"last_push_at":"2026-10-22T08:50:11.000Z","license":"MIT"},"uptime":null,"claimed":false,"transport":"mixed","callable_via_gateway":false,"default_price_micros":0,"repository":"https://github.com/Grinv/tmdb-mcp","website":null,"version":"0.14.0","remotes":[],"packages":[{"registryType":"npm","identifier":"tmdb-mcp","version":"0.14.0","runtimeHint":"npx","transport":{"type":"stdio"},"environmentVariables":[{"description":"Required. TMDB v4 'Read Access Token' from themoviedb.org/settings/api (sent as a Bearer token).","isRequired":true,"isSecret":true,"name":"TMDB_API_TOKEN"},{"description":"Optional. Free key from omdbapi.com — enables IMDb/Rotten Tomatoes/Metacritic ratings.","isSecret":true,"name":"OMDB_API_KEY"},{"description":"Optional. Default response language as ISO-639-1, optionally with a region (e.g. ru-RU, en-US, ja).","default":"en-US","name":"TMDB_LANGUAGE"},{"description":"Optional. Default ISO-3166-1 country code (e.g. US, RU, GB) for region-specific results.","default":"US","name":"TMDB_REGION"}]},{"registryType":"mcpb","identifier":"https://github.com/Grinv/tmdb-mcp/releases/download/v0.14.0/tmdb-mcp.mcpb","version":"0.14.0","fileSha256":"d14b1cb16f037665c66e17121af98be3000274eea3cb3ca09adf6dd7fe1fccc7","transport":{"type":"stdio"},"environmentVariables":[{"description":"Required. TMDB v4 'Read Access Token' from themoviedb.org/settings/api (sent as a Bearer token).","isRequired":true,"isSecret":true,"name":"TMDB_API_TOKEN"},{"description":"Optional. Free key from omdbapi.com — enables IMDb/Rotten Tomatoes/Metacritic ratings.","isSecret":true,"name":"OMDB_API_KEY"},{"description":"Optional. Default response language as ISO-639-1, optionally with a region (e.g. ru-RU, en-US, ja).","default":"en-US","name":"TMDB_LANGUAGE"},{"description":"Optional. Default ISO-3166-1 country code (e.g. US, RU, GB) for region-specific results.","default":"US","name":"TMDB_REGION"}]}],"tools":[{"name":"discover_movies","description":"","write_action":false,"price_micros":0,"input_schema":null},{"name":"discover_tv","description":"","write_action":false,"price_micros":0,"input_schema":null},{"name":"find_by_imdb_id","description":"Resolve an IMDb id (e.g. 'tt0133093') to TMDB entities \\u2014 returns matching movie, TV and person results. Use when you only have an IMDb id and need the TMDB id for the other tools. Only matches whole movies/shows/people: IMDb also assigns 'tt' ids to individual episodes (verified live, e.g. Breaking Bad's pilot 'tt0959621'), which this tool does not resolve \\u2014 such an id comes back with ev","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_collection","description":"Get a movie collection/franchise and all its parts in release order (e.g. the whole 'The Dark Knight Collection'). Get the collection id from search_collections (by franchise name) or from a movie's `collection` field in get_movie.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_movie","description":"","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_movie_credits","description":"List the top-billed cast (up to 20) and the headline crew (director, writers, composer, DoP, \\u2026) of a movie by TMDB id. Get the id from search_movies.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_movie_genres","description":"List TMDB movie genres with their numeric ids and names (reference data; rarely changes). Feed the ids into discover_movies' with_genres/without_genres.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_movie_recommendations","description":"Get movies TMDB recommends for the given movie id, based on co-viewing/personalization data (what users who liked this also liked) \\u2014 usually the more thematically relevant list. Prefer this over get_similar as the default choice; get_similar matches on shared genres/keywords, a blunter heuristic that can surface tonally unrelated titles. Get the id from search_movies.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_movie_releases","description":"","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_movies","description":"Get a compact card \\u2014 title, year, genres, vote average, and (opt-in) ratings \\u2014 for 1-20 movies by TMDB id in one call. Deliberately trimmed (no overview, cast, budget, certifications, production companies, etc.): use this for a single id too when you only need that headline info and not the full get_movie payload, not just for checking many at once. Call get_movie instead when you need t","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_person","description":"Get full details for one person by TMDB id: biography, birthday/deathday, department, and links (TMDB + IMDb). Does not include filmography \\u2014 use get_person_credits for that. Get the id from search_people or a credits list.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_person_credits","description":"","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_ratings","description":"","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_reviews","description":"Get user reviews for a movie or TV show (author, that one reviewer's own 0-10 `rating` if they left one \\u2014 a single person's score, not the aggregate `vote_average` and not an IMDb/RT/Metacritic value; it can be null, and the review text, clipped to ~1500 characters). Get the id from search_movies/search_tv.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_similar","description":"Get titles TMDB considers similar to a given movie or TV show, based on shared genres and keywords \\u2014 a blunter heuristic than get_movie_recommendations'/get_tv_recommendations' behavioral (co-viewing) data, so results are often thematically noisy (verified live: The Matrix's first page mixes Videodrome and Dune with The Man with the Golden Gun). Returned exactly as TMDB ranks them, 20 per pag","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_trending","description":"Get what's trending on TMDB. media_type selects movies, TV, people, or all; time_window is the trending period (today vs this week). Good for 'what's popular right now'. Each result row carries its own media_type ('movie' | 'tv' | 'person') \\u2014 check it to route to the right get_* tool, especially when media_type is left at 'all'.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_tv","description":"","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_tv_credits","description":"List a TV show's cast and key crew across its whole run, by TMDB id: up to 20 cast members ranked by how many episodes they appear in (each with their main character and episode_count), plus up to 5 people per key crew job \\u2014 Director, Writer, Teleplay, Story, Executive Producer, Producer, Original Music Composer, Director of Photography \\u2014 ranked by episode_count, so 'who directed most of","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_tv_episode","description":"Get one episode of a TV show by show id + season number + episode number: overview, air date, runtime, TMDB vote average (`vote_average`, TMDB's own 0-10 user score \\u2014 not an IMDb/RT/Metacritic score; get_movie/get_tv's `ratings` are whole-show only and this tool makes no OMDb call), guest stars (up to 15) and director/writer. Also returns the episode's own `imdb_id`/`imdb_url` \\u2014 pass tha","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_tv_genres","description":"List TMDB TV genres with their numeric ids and names (reference data; rarely changes). Feed the ids into discover_tv's with_genres/without_genres.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_tv_recommendations","description":"Get TV shows TMDB recommends for the given show id, based on co-viewing/personalization data (what users who liked this also liked) \\u2014 usually the more thematically relevant list. Prefer this over get_similar as the default choice; get_similar matches on shared genres/keywords, a blunter heuristic that can surface tonally unrelated titles. Get the id from search_tv.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_tv_season","description":"Get one season of a TV show (by show id + season number): overview and the episode list with air dates, runtimes and TMDB vote averages (per-episode `vote_average`, TMDB's own 0-10 user score \\u2014 not the IMDb/RT/Metacritic scores get_movie/get_tv return as `ratings`, which are whole-show only; this tool makes no OMDb call, and TMDB's season payload carries no per-episode IMDb ids either, so cal","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_tv_shows","description":"","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_videos","description":"List trailers, teasers and clips for a movie or TV show; YouTube entries include a watch URL. Get the id from search_movies/search_tv. Returns videos in the server's configured TMDB_LANGUAGE (default 'en-US') plus English, the title's original language (e.g. Spirited Away's Japanese trailer) and untagged ones; each entry's `language` (ISO-639-1) says which. No per-call language override.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_watch_providers","description":"Find where a movie or TV show can be streamed, rented or bought in a given country (JustWatch data via TMDB). Returns provider names per access type for that country; if it has no data, returns `available:false` plus `available_regions` to retry with. Get the id from search_movies/search_tv.","write_action":false,"price_micros":0,"input_schema":null},{"name":"search_collections","description":"Resolve a franchise/series name (e.g. 'harry potter', 'james bond') to its TMDB collection id \\u2014 a collection is TMDB's grouping of a movie series' films. Pass the id to get_collection for every part in release order. Use this when you only have the franchise name; if you already have one of its movies, get_movie's `collection` field carries the same id. Movies only: collection parts are movie","write_action":false,"price_micros":0,"input_schema":null},{"name":"search_companies","description":"Resolve a production company's name to its TMDB numeric id (e.g. 'A24', 'Pixar'). Feed the id into discover_movies/discover_tv via with_companies. Company names aren't unique \\u2014 TMDB can have several unrelated companies sharing the same name (e.g. two different 'A24's, one US and one GB) \\u2014 check origin_country and logo_url to tell rows apart when a name matches more than one.","write_action":false,"price_micros":0,"input_schema":null},{"name":"search_keywords","description":"Resolve keyword names to TMDB keyword ids (e.g. 'time travel', 'based on true story'). Feed the ids into discover_movies/discover_tv via with_keywords / without_keywords.","write_action":false,"price_micros":0,"input_schema":null},{"name":"search_movies","description":"Search TMDB movies by title; returns compact summaries with the TMDB id that the other movie tools (get_movie, get_movie_credits, \\u2026) require, plus pagination info. Use this over search_multi when you already know the result is a movie. `region` here only picks which country's release_date is shown per result (e.g. a title's US vs. India theatrical date) \\u2014 verified live, it does not filte","write_action":false,"price_micros":0,"input_schema":null},{"name":"search_multi","description":"Search movies, TV shows and people in one call. Each result carries a media_type ('movie' | 'tv' | 'person') so you can route to the right get_* tool. Use when the user's query could be any of these; if you already know the type, search_movies/search_tv/search_people are more precise.","write_action":false,"price_micros":0,"input_schema":null},{"name":"search_people","description":"Search TMDB people (actors, directors, crew) by name; returns the TMDB id needed by get_person plus their top 5 best-known titles (known_for). Use this over search_multi when you already know the result is a person.","write_action":false,"price_micros":0,"input_schema":null},{"name":"search_tv","description":"Search TMDB TV shows by name; returns compact summaries with the TMDB id that get_tv and the other TV tools require. Use this over search_multi when you already know the result is a TV show.","write_action":false,"price_micros":0,"input_schema":null},{"name":"search_watch_providers","description":"","write_action":false,"price_micros":0,"input_schema":null}],"scan":{"score":75,"grade":"B","scanned_at":"2026-11-03T19:41:49.458Z","report":{"scannerVersion":"0.1.10","scannedAt":"2026-11-03T19:41:49.420Z","components":{"code":{"score":20,"max":25,"notes":["2 source files scanned"]},"reliability":{"score":-1,"max":20,"notes":["no gateway calls yet and no remote to probe"]},"poisoning":{"score":-1,"max":15,"notes":["tools not inspected (local package is not executed); not counted"]},"auth":{"score":6,"max":15,"notes":["static API keys via environment variables"]},"maintenance":{"score":15,"max":15,"notes":["last push 12 days ago"]},"identity":{"score":8,"max":10,"notes":["registry namespace matches repository owner","GitHub account older than a year"]}},"findings":[{"id":"exec.eval","severity":"medium","component":"code","title":"eval / new Function used","evidence":"dist/index.js: …&(A=this.opts.code.process(A,_));let ee=new Function(`${o.default.self}`,`${o.default.scope}`…"}],"inputs":{"packages":[{"registryType":"npm","identifier":"tmdb-mcp","version":"0.14.0","found":true,"license":"MIT","hasInstallScripts":false,"dependencyCount":2,"publishedAt":"2026-10-22T08:40:30.848Z","repositoryUrl":"git+https://github.com/Grinv/tmdb-mcp.git","weeklyDownloads":207}],"repo":{"found":true,"owner":"Grinv","repo":"tmdb-mcp","archived":false,"pushedAt":"2026-10-22T08:50:11Z","stars":4,"forks":0,"openIssues":0,"ownerType":"User","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/4070730?v=4","ownerCreatedAt":"2013-04-05T16:23:24Z","license":"MIT"},"icon":{"url":"https://avatars.githubusercontent.com/u/4070730?v=4&s=128","source":"registry"},"presence":{"stars":4,"forks":0,"downloadsWeek":207,"license":"MIT","lastPushAt":"2026-10-22T08:50:11.000Z","score":33}}}},"grade_history":[],"reviews":[]}