tmdb-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TMDB_REGION | No | Region for localization (e.g., US, RU) (optional) | |
| OMDB_API_KEY | No | OMDb API key for ratings enrichment (optional) | |
| TMDB_LANGUAGE | No | Language for localization (e.g., en-US, ru-RU) (optional) | |
| TMDB_API_TOKEN | Yes | TMDB v4 Read Access Token (required) |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_moviesA | 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. |
| search_tvA | Search TMDB TV shows by name; returns compact summaries with the TMDB id that get_tv and the other TV tools require. |
| search_multiA | 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. |
| search_peopleA | Search TMDB people (actors, directors, crew) by name; returns the TMDB id needed by get_person plus their best-known titles. |
| search_keywordsA | 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. |
| get_movieA | Get full details for one movie by TMDB id: overview, genres, runtime, budget/revenue, vote average, the age/content rating (certification) for |
| get_tvA | Get full details for one TV show by TMDB id: overview, genres, seasons/episodes counts, networks, status, the age/content rating (certification) for |
| get_personA | Get full details for one person by TMDB id: biography, birthday/deathday, department, and links (TMDB + IMDb). Get the id from search_people or a credits list. |
| get_movie_creditsA | List the top-billed cast and the headline crew (director, writers, composer, DoP, …) of a movie by TMDB id. Get the id from search_movies. |
| get_tv_creditsA | List the main cast and headline crew (creators, writers, …) of a TV show by TMDB id. Get the id from search_tv. |
| get_movie_recommendationsA | Get movies TMDB recommends as similar to the given movie id. Get the id from search_movies. |
| get_tv_recommendationsA | Get TV shows TMDB recommends as similar to the given show id. Get the id from search_tv. |
| get_similarA | Get titles TMDB considers similar to a given movie or TV show (its algorithmic 'similar' list, distinct from get_movie_recommendations). Get the id from search_movies/search_tv. |
| get_reviewsA | Get user reviews for a movie or TV show (author, their rating, and the review text). Get the id from search_movies/search_tv. |
| get_collectionA | 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 a movie's |
| get_trendingA | 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'. |
| get_movie_genresA | List TMDB movie genres with their numeric ids and names (reference data; rarely changes). |
| get_tv_genresA | List TMDB TV genres with their numeric ids and names (reference data; rarely changes). |
| discover_moviesA | Find movies by structured filters instead of a title query: genres (include/exclude), year or release-date range, rating range, vote count, runtime range, original language, cast/crew/people, companies, keywords, watch providers, certification, and sort order. Use for 'popular sci-fi from the 1990s rated above 7 available on Netflix'. Resolve ids with get_movie_genres, search_people, search_keywords. |
| discover_tvA | Find TV shows by structured filters (genres, first-air year or date range, rating range, vote count, runtime, language, companies, networks, keywords, watch providers, sort). The TV counterpart of discover_movies; use with_networks for 'HBO shows', etc. |
| get_watch_providersA | 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 plus the regions that have data. Get the id from search_movies/search_tv. |
| get_person_creditsA | List the movies and TV shows a person is known for (cast roles and crew jobs), most popular first. Use for 'what has this actor/director been in'. Get the id from search_people. |
| get_videosA | 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. |
| find_by_imdb_idA | 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. |
| get_tv_seasonA | Get one season of a TV show (by show id + season number): overview and the episode list with air dates, runtimes and ratings. Season 0 is usually specials. Get the show id from search_tv. |
| get_tv_episodeA | Get one episode of a TV show by show id + season number + episode number: overview, air date, runtime, rating, guest stars and director/writer. Get the show id from search_tv. |
| get_ratingsA | Look up IMDb, Rotten Tomatoes and Metacritic ratings from OMDb by IMDb id (preferred, e.g. 'tt0133093') or by title (+ optional year). Prefer get_movie/get_tv when you have a TMDB id — they already include these ratings. Requires OMDB_API_KEY. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Grinv/tmdb-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server