Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
TMDB_REGIONNoRegion for localization (e.g., US, RU) (optional)
OMDB_API_KEYNoOMDb API key for ratings enrichment (optional)
TMDB_LANGUAGENoLanguage for localization (e.g., en-US, ru-RU) (optional)
TMDB_API_TOKENYesTMDB v4 Read Access Token (required)

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
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 region, and links (TMDB + IMDb). By default also includes IMDb/Rotten Tomatoes/Metacritic ratings from OMDb (set include_ratings=false to skip). Get the id from search_movies.

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 region, and links. By default also includes IMDb/Rotten Tomatoes/Metacritic ratings from OMDb (set include_ratings=false to skip). Get the id from search_tv.

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 collection field in get_movie.

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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

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