Skip to content
Agentmart
Submit a tool

TMDB MCP Server

MCP server for The Movie Database (TMDB) with IMDb/Rotten Tomatoes/Metacritic ratings via OMDb.

Connector by Grinv · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 5
Write a review

Install

Works with Claude Code, Codex, VS Code, Claude Desktop, Cursor, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install connector/grinv-tmdb-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

MCP server for The Movie Database (TMDB) with IMDb/Rotten Tomatoes/Metacritic ratings via OMDb.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools
33 read · 0 write · 0 deleteRead-only
Secrets
2 (API keys, tokens or passwords)
Install scripts
None found
Runs as
Node.js package

Tools by what they do 33

Read from the source code; the running server may list different tools.

Read 33 · Look things up without changing anything.

  • discover_movies
  • discover_tv
  • find_by_imdb_id
  • get_collection
  • get_movie
  • get_movie_credits
  • get_movie_genres
  • get_movie_recommendations
  • get_movie_releases
  • get_movies
  • get_person
  • get_person_credits
Show 21 more tools
  • get_ratings
  • get_reviews
  • get_similar
  • get_trending
  • get_tv
  • get_tv_credits
  • get_tv_episode
  • get_tv_genres
  • get_tv_recommendations
  • get_tv_season
  • get_tv_shows
  • get_videos
  • get_watch_providers
  • search_collections
  • search_companies
  • search_keywords
  • search_movies
  • search_multi
  • search_people
  • search_tv
  • search_watch_providers

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • OMDB_API_KEY
  • TMDB_API_TOKEN

Other settings (environment variables or headers).

  • TMDB_LANGUAGE
  • TMDB_REGION

Network hosts it talks to 7

  • api.themoviedb.org · found in code
  • github.com · found in install command, code
  • glama.ai · found in code
  • image.tmdb.org · found in code
  • imdb.com · found in code
  • omdbapi.com · found in code
  • themoviedb.org · found in code

Tools (33)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • discover_moviesDiscover movies (filters)read-only

    Find movies by structured filters instead of a title query: genres (include/exclude), year or release-date range, TMDB vote-average range, vote count, runtime range, original language, cast/crew/people, companies (include/exclude), origin country, keywords (include/exclude), watch providers (include/exclude) and access model (subscription/rent/buy/free/ads), certification, a release window in one country by release type (any_release_date_gte/lte + region + with_release_type — e.g. 'movies in German cinemas this month'), an adult-content toggle, and sort order. certification/with_watch_provider…

  • discover_tvDiscover TV shows (filters)read-only

    Find TV shows by structured filters (genres (include/exclude), first-air year or date range, TMDB vote-average range, vote count, runtime, language, origin country, companies (include/exclude), networks, keywords (include/exclude), watch providers (include/exclude) and access model (subscription/rent/buy/free/ads), episodes airing in a date range (air_date_gte/lte), type, status, certification, an adult-content toggle, sort) — but NOT cast/crew/person: this tool doesn't accept those params for TV at all (calling with them is a validation error, not a silent no-op) because TMDB's own /discover/…

  • find_by_imdb_idFind by IMDb idread-only

    Resolve an IMDb id (e.g. 'tt0133093') to TMDB entities — 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 — such an id comes back with every result list empty, indistinguishable from a genuinely unknown id.

  • get_collectionGet a movie collectionread-only

    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.

  • get_movieGet movie detailsread-only

    Get full details for one movie by TMDB id: overview, genres, runtime, budget/revenue, vote average, the age/content rating (certification) for `region` — falling back to the US rating, then any available country, when `region` has none; check `certification_region` to see which one was used — and links (TMDB + IMDb). By default also includes IMDb/Rotten Tomatoes/Metacritic ratings and an awards summary (see include_ratings), plus OMDb's own age rating (`ratings.rated` — separate from this tool's own `certification` above; the two can differ) from OMDb (set include_ratings=false to skip); if un…

  • get_movie_creditsGet movie cast & crewread-only

    List the top-billed cast (up to 20) and the headline crew (director, writers, composer, DoP, …) of a movie by TMDB id. Get the id from search_movies.

  • get_movie_genresList movie genresread-only

    List TMDB movie genres with their numeric ids and names (reference data; rarely changes). Feed the ids into discover_movies' with_genres/without_genres.

  • get_movie_recommendationsGet movie recommendationsread-only

    Get movies TMDB recommends for the given movie id, based on co-viewing/personalization data (what users who liked this also liked) — 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.

  • get_movie_releasesGet movies in or coming to cinemasread-only

    List movies in cinemas now (list='now_playing') or opening soon (list='upcoming') in one country — for 'what's playing in theaters' or 'what comes out next month'. Use get_trending for overall popularity regardless of release, discover_movies for an arbitrary date range. `region` filters to movies with a theatrical release in that country inside the window (a different set per country, not just a re-sort; an unrecognized code such as 'ZZ' returns an empty page, but 'XX' is a real TMDB pseudo-region), and each row's release_date is that country's release date, which can predate the window for a…

  • get_moviesGet compact movie card(s)read-only

    Get a compact card — title, year, genres, vote average, and (opt-in) ratings — 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 the full details for a title (including region-specific certification). A bad/unknown id never fails the whole call — that entry comes back `{id, found:false, reason}` instead, in the same order as `ids`.

  • get_personGet person detailsread-only

    Get full details for one person by TMDB id: biography, birthday/deathday, department, and links (TMDB + IMDb). Does not include filmography — use get_person_credits for that. Get the id from search_people or a credits list.

  • get_person_creditsGet person filmographyread-only

    List the movies and TV shows a person is known for (cast roles and crew jobs), most popular first, capped to the top 25 of each by default; talk-show/awards-show guest appearances ('Self'/'Himself'/'Herself', plus any cast credit on a TV talk or news show) and repeat entries for the same title are excluded so the list stays about actual roles. A cameo credited under the person's own name is kept, since TMDB marks it no differently from a real role (verified live: Tom Hanks's top cast row is The Simpsons as 'Tom Hanks (voice)'). A title with several crew jobs (writer AND director AND producer o…

  • get_ratingsGet IMDb/RT/Metacritic ratingsread-only

    Look up IMDb, Rotten Tomatoes and Metacritic ratings, an awards summary (major-award wins/nominations — Oscars, Emmys, Golden Globes, etc.; free text, not a structured count, for the whole film/show — or for one episode, given an episode's imdb_id — never one person), and OMDb's own age rating (`rated`), from OMDb by IMDb id (preferred, e.g. 'tt0133093') or by title (+ optional year/type). Prefer get_movie/get_tv when you have a TMDB id — they already include this. Requires OMDB_API_KEY. One of imdb_id or title is required; omitting both returns an error. A no-match lookup is not an error: it …

  • get_reviewsGet user reviewsread-only

    Get user reviews for a movie or TV show (author, that one reviewer's own 0-10 `rating` if they left one — 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.

  • get_similarGet similar titlesread-only

    Get titles TMDB considers similar to a given movie or TV show, based on shared genres and keywords — 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 page; the list runs into the whole catalog (total_results 20001 for The Matrix), so only the first page or two are worth reading. Try recommendations first for thematically closer picks; use this when you spe…

Show 18 more tools
  • get_trendingGet trending titlesread-only

    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') — check it to route to the right get_* tool, especially when media_type is left at 'all'.

  • get_tvGet TV show detailsread-only

    Get full details for one TV show by TMDB id: overview, genres, seasons/episodes counts, networks, created_by (the show's creator(s)), status, the age/content rating (certification) for `region` — falling back to the US rating, then any available country, when `region` has none; check `certification_region` to see which one was used — and links. By default also includes IMDb/Rotten Tomatoes/Metacritic ratings and an awards summary (see include_ratings), plus OMDb's own age rating (`ratings.rated` — separate from this tool's own `certification` above; the two can differ) from OMDb (set include_r…

  • get_tv_creditsGet TV cast & crewread-only

    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 — Director, Writer, Teleplay, Story, Executive Producer, Producer, Original Music Composer, Director of Photography — ranked by episode_count, so 'who directed most of it' is the first Director listed. Creators aren't listed here; use get_tv's `created_by`. For one specific episode's director/writer, use get_tv_episode. Get the id from search_tv.

  • get_tv_episodeGet TV episoderead-only

    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 — 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` — pass that id to get_ratings for this one episode's IMDb rating, the only way to get a per-episode IMDb score here. Get the show id from search_tv.

  • get_tv_genresList TV genresread-only

    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.

  • get_tv_recommendationsGet TV recommendationsread-only

    Get TV shows TMDB recommends for the given show id, based on co-viewing/personalization data (what users who liked this also liked) — 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.

  • get_tv_seasonGet TV seasonread-only

    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 — 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 call get_tv_episode when you need one episode's `imdb_id` for get_ratings), capped at 50 episodes (`episode_count` reports the true total). Season 0 is usually specials, which can run to hundreds of bonus cli…

  • get_tv_showsGet compact TV show card(s)read-only

    Get a compact card — name, year, genres, vote average, season/episode counts, and (opt-in) ratings — for 1-20 TV shows by TMDB id in one call. A quick way to spot short/miniseries shows (low episode count) across many candidates without a per-title get_tv call. Deliberately trimmed otherwise (no overview, the actual episode list, networks, certifications, etc.): use this for a single id too when you only need that headline info and not the full get_tv payload, not just for checking many at once. Call get_tv instead when you need the full details for a title (including region-specific certifica…

  • get_videosGet trailers & videosread-only

    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.

  • get_watch_providersWhere to watchread-only

    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.

  • search_collectionsSearch movie collectionsread-only

    Resolve a franchise/series name (e.g. 'harry potter', 'james bond') to its TMDB collection id — 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 movies, and a TV series name finds nothing (e.g. 'breaking bad' → 0 results). A name can match several collections ('star wars' also returns 'LEGO Star Wars Collection' and other spin-off groupings) — pick by n…

  • search_companiesSearch production companiesread-only

    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 — TMDB can have several unrelated companies sharing the same name (e.g. two different 'A24's, one US and one GB) — check origin_country and logo_url to tell rows apart when a name matches more than one.

  • search_keywordsSearch keywordsread-only

    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.

  • search_moviesSearch moviesread-only

    Search TMDB movies by title; returns compact summaries with the TMDB id that the other movie tools (get_movie, get_movie_credits, …) 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) — verified live, it does not filter which movies match or reorder them; for actual region-based availability use get_watch_providers instead.

  • search_multiSearch everythingread-only

    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.

  • search_peopleSearch peopleread-only

    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.

  • search_tvSearch TV showsread-only

    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.

  • search_watch_providersSearch streaming/rental providersread-only

    Resolve a streaming/rental/purchase service's name (e.g. 'Netflix', 'Disney Plus') to its TMDB numeric provider id. Feed the id into discover_movies/discover_tv's with_watch_providers (with watch_region set to the same region given here, if any) to find top titles on that service — TMDB has no name-based lookup of its own for this, only numeric ids, and there are hundreds of providers (269+ for the US alone, more elsewhere), so don't guess an id. A provider's id and even whether it's offered at all can differ by region (e.g. a service bundled as a channel add-on in one country vs. standalone i…

Compare and alternatives

    Featured in

    Signals

    Stars
    5
    Forks
    0
    Open issues
    0
    Last commit
    Oct 22, 2026 (6 days ago)
    Last release
    Oct 22, 2026 (6 days ago)

    From GitHub (fetched Oct 24, 2026).

    Details

    Registry name
    io.github.Grinv/tmdb-mcp
    Version
    0.14.0
    Auth
    API key
    Packages
    npm tmdb-mcpmcpb https://github.com/Grinv/tmdb-mcp/releases/download/v0.14.0/tmdb-mcp.mcpb
    License
    MIT
    Repository
    github.com/Grinv/tmdb-mcp
    First seen
    Oct 24, 2026
    Last checked
    Oct 24, 2026
    Source
    Official MCP Registrygithub-graphql

    More from Grinv

    Cite this page

    TMDB MCP Server. Agent Mart. https://agentmart.dev/connectors/grinv-tmdb-mcp (last updated 2026-10-24)