Atlas / MCP servers / laksh-star / TMDB Server

TMDB ServerSAFE

Name: TMDB Server
Author: laksh-star

mcp/laksh-star/tmdb-server

MCP server by laksh-star · Audited 2026-10-07

⚑ Report / re-scan Source ↗

MCP Server with TMDB

Verdict

SAFE

Grade

Trust score

89 /100

Exposed tools

24 23r · 1w · 0d

Transport

stdio

License

MIT

Stars

Overview

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

An MCP server for The Movie Database (TMDB) API. It provides movie and TV search, streaming availability, cast and crew details, and recommendations for assistants such as Codex and Claude Desktop.

For the architecture split between the reusable MCP server and higher-level feature workflows, see USERGUIDE.md.

Tools

Movie Discovery

get_weekend_watchlist — Ranked weekend shortlist by mood, country, language, runtime, rating, and services
plan_watch_party — Group movie-night plan with a primary pick, backup, wildcard, party-fit reasons, provider availability, and avoided-title filtering
build_franchise_watch_order — Franchise/universe guide with release order, suggested order, total runtime, and provider-aware notes
build_collection_gap_plan — Franchise completion plan with watched/missing entries, remaining runtime, provider availability, and completion path
recommend_from_taste_profile — Recommendations from liked/disliked titles with provider-aware scoring, match reasons, and cautions
build_release_calendar_watchlist — Release-window watchlist with upcoming movies, provider-ready picks, broad-room baselines, and watch-later scoring
search_movies — Search by title/keywords → titles, IDs, ratings, overviews
get_trending — Top 10 trending movies (timeWindow: "day" | "week")
get_weekly_trending_by_language — Weekly trending movies grouped by original language into English, Hindi, and Telugu
search_by_genre — Movies by genre name, optional year filter
advanced_search — Filter by genre, year, min rating, sort, language
search_by_keyword — Find movies by theme/keyword (e.g. "zombie", "heist")

Movie Details

get_movie_details — Full details: cast, crew, runtime, genres, reviews (by movieId)
compare_movies — Side-by-side comparison for 2-5 movie IDs with ratings, runtime, cast, director, providers, and best-fit notes
**get_recommendations

Read from source at commit 1a235f6c4415OBSERVED · 2026-10-07

Connect

Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.

claude-code

claude mcp add mcp-server-tmdb --env ACCESS_TOKEN=${ACCESS_TOKEN} --env TMDB_API_KEY=${TMDB_API_KEY} --env TMDB_MCP_ACCESS_TOKEN=${TMDB_MCP_ACCESS_TOKEN} -- npx -y [email protected]

claude-desktop

{
  "mcpServers": {
    "mcp-server-tmdb": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "ACCESS_TOKEN": "${ACCESS_TOKEN}",
        "TMDB_API_KEY": "${TMDB_API_KEY}",
        "TMDB_MCP_ACCESS_TOKEN": "${TMDB_MCP_ACCESS_TOKEN}"
      }
    }
  }
}

Exposed tools (24)

23 read · 1 write · 0 destructive.

Tool	Risk	Description
`advanced_search`	read	Advanced movie search with multiple filters
`build_collection_gap_plan`	read	Build a franchise completion plan by comparing watched titles or TMDB IDs against a collection, with missing entries, remaining runtime, provider availability, and a recommended completion path
`build_franchise_watch_order`	write	Build a franchise or universe watch guide with release order, suggested order, total runtime, provider availability, and start/skip guidance
`build_person_watch_path`	read	Build a watch path for an actor, director, or crew member with best-rated, available-now, recent, and starter picks
`build_release_calendar_watchlist`	read	Build a release-window watchlist with upcoming movies, provider-ready picks, broad-room baselines, and watch-later scoring
`compare_movies`	read	Compare 2 to 5 movies side by side with ratings, runtime, genres, cast, director, watch providers, and best-fit notes
`find_where_to_watch`	read	Find where one or more movie titles are available by searching titles, matching TMDB movies, and checking streaming, rental, and purchase providers
`get_movie_details`	read	Get full details for a movie including cast, crew, runtime, budget, and reviews
`get_now_playing`	read	Get movies currently playing in theaters. Returns titles, ratings, release dates, and overviews for movies now in cinemas.
`get_person_details`	read	Get full biography and filmography for an actor or director
`get_recommendations`	read	Get movie recommendations based on a movie ID
`get_similar_movies`	read	Get movies similar to a given movie (uses TMDB similarity algorithm, different from recommendations)
`get_trending`	read	Get trending movies for a time window
`get_trending_tv`	read	Get trending TV shows for a time window
`get_watch_providers`	read	Get streaming, rental, and purchase availability for a movie by country
`get_weekend_watchlist`	read	Generate a ranked movie shortlist for a weekend watch session using mood, country, language, runtime, rating, and streaming services
`get_weekly_trending_by_language`	read	Get weekly trending movies grouped into English, Hindi, and Telugu by TMDB original_language
`plan_watch_party`	read	Plan a group movie night by merging mood scans, provider availability, runtime fit, ratings, and avoided titles into a primary pick, backup pick, and wildcard
`recommend_from_taste_profile`	read	Recommend movies from liked and disliked titles with provider-aware scoring, match reasons, and watch-out notes
`search_by_genre`	read	Search for movies by genre
`search_by_keyword`	read	Search for movies by keywords or themes
`search_movies`	read	Search for movies by title or keywords
`search_person`	read	Search for actors, directors, or other people in the film industry
`search_tv_shows`	read	Search for TV shows and series by title

Trust audit

SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.

Layer	What it checks	Result
L0	Provenance & inventory	PASS
L1	Static analysis of the code	PASS
L2	Instruction surface (what it tells the agent)	PASS
L3	Class-specific surface	PASS
L4	Behavioural (sandbox)	SKIPPED

What the source does

Filesystem: declared (2 observation(s))
Network: declared (5 observation(s))
Shell: none-observed
Dependencies: not all pinned
Secrets in source: none-found

Findings (10)

LOWInsecure crypto · crypto.weak_hash · CWE-327, CWE-338

plugins/tmdb/scripts/install-local-integrations.mjs:203

.createHash("sha1")

LOWFilesystem / path · fs.traversal · CWE-22, CWE-59

plugins/tmdb/scripts/run-server.sh:6

REPO_ROOT="$(cd -- "$SCRIPT_DIR/../../.." && pwd)"

LOWFilesystem / path · fs.traversal · CWE-22, CWE-59

plugins/tmdb/scripts/smoke-test.mjs:10

const repoRoot = path.resolve(scriptDir, "../../..");