MCP server

Tmdb

io.github.pipeworx-io/tmdb

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

TMDB v3 MCP.

Website Source

At a glance

Type

MCP server

Publisher

pipeworx.io (verified by the MCP Registry)

Status

Working at last check

Tools

61

Token cost

About 28,701 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http tmdb https://gateway.pipeworx.io/tmdb/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.tmdb]
url = "https://gateway.pipeworx.io/tmdb/mcp"

Gemini CLI

{"mcpServers":{"tmdb":{"httpUrl":"https://gateway.pipeworx.io/tmdb/mcp"}}}

Cursor

{"mcpServers":{"tmdb":{"url":"https://gateway.pipeworx.io/tmdb/mcp"}}}

VS Code

{"servers":{"tmdb":{"type":"http","url":"https://gateway.pipeworx.io/tmdb/mcp"}}}

Antigravity

agy mcp add tmdb https://gateway.pipeworx.io/tmdb/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"tmdb","server_url":"https://gateway.pipeworx.io/tmdb/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"tmdb","server_url":"https://gateway.pipeworx.io/tmdb/mcp"}

Tools

• configuration ~87 tokens
  Fetch TMDB API configuration including base image URL, supported poster/backdrop sizes, and change keys. Use to construct full poster/backdrop image URLs from relative paths returned by other tools.
• discover_movie ~109 tokens
  Discover TMDB movies using advanced filters passed as query params (genre, year, certification, vote average, sort order, etc.). Use `genres_movie` to get valid genre IDs first.
• discover_tv ~98 tokens
  Discover TMDB TV shows using advanced filters passed as query params (genre, first_air_date, vote average, network, sort order, etc.). Use `genres_tv` to get valid genre IDs first.
• genres_movie ~81 tokens
  TMDb movie genre directory: Action, Comedy, Drama, Horror, Documentary, etc. with genre IDs. Use to filter discover_movie by genre.
• genres_tv ~83 tokens
  TMDb TV genre directory: Action & Adventure, Drama, Reality, Documentary, Animation, etc. with genre IDs. Use to filter discover_tv by genre.
• movie ~149 tokens
  Fetch full TMDB movie details by `movie_id`. Returns title, tagline, overview, runtime, genres, release date, budget, revenue, vote average, and production companies. Optionally append credits/videos/images via `append_to_response`.
• movie_credits ~109 tokens
  TMDb full cast + crew for a movie by ID. Returns actor names, characters, order, department, job. Use for "who played X in Y", "who directed Y", "behind-the-scenes credits".
• movie_recommendations ~125 tokens
  Fetch TMDB-recommended movies similar to a given movie by `movie_id`. Returns title, overview, release date, popularity, vote average, and poster path for each recommended film.
• movie_videos ~104 tokens
  Fetch trailers, teasers, clips, and featurettes for a TMDB movie by `movie_id`. Returns video name, site (YouTube/Vimeo), key (video ID), type, and official flag.
• person ~128 tokens
  Fetch TMDB person details by `person_id`. Returns full name, biography, birthday, deathday, place of birth, known-for department, and profile image path.
• person_combined_credits ~109 tokens
  Fetch all movie and TV credits for a TMDB person by `person_id`. Returns cast and crew entries with title, character/job, media type, release date, and vote average.
• search_movie ~178 tokens
  Search TMDB for movies by title keyword. Optionally filter by year or primary_release_year. Returns title, release date, overview, popularity, vote average, and TMDB movie_id needed by `movie` and `movie_credits`.
• search_multi ~145 tokens
  Search TMDB across movies, TV shows, and people simultaneously with a single keyword query. Returns mixed results each tagged with media_type (movie/tv/person), useful when the content type is unknown.
• search_person ~143 tokens
  Search TMDB for actors, directors, or crew members by name. Returns person name, popularity, known-for department, profile path, and TMDB person_id needed by `person` and `person_combined_credits`.
• search_tv ~168 tokens
  TMDb (The Movie Database) — search TV shows by title. Returns show name, first-air date, popularity, overview, poster path, TMDb tv_id. Use to resolve a TV title into the tv_id needed by tv, tv_season, tv_episode.
• trending ~187 tokens
  TMDb trending movies, TV shows, or people for a time window (day or week). Returns ranked list with name, popularity, vote average, overview. Use for "what is popular this week", "trending celebrities", weekly entertainment summary.
• tv ~124 tokens
  Fetch full TMDB TV show details by `tv_id`. Returns name, overview, first/last air date, number of seasons and episodes, genres, networks, status, and vote average.
• tv_episode ~145 tokens
  Fetch details for a specific TV episode by `tv_id`, `season_number`, and `episode_number`. Returns episode name, overview, air date, runtime, vote average, guest stars, and crew.
• tv_season ~126 tokens
  Fetch details for a specific TV season by `tv_id` and `season_number`. Returns season name, overview, air date, episode count, and a list of episodes with name, air date, and overview.

Browse

• GitHub tools
• GitHub and code hosting
• Databases
• YouTube

Related MCP servers

• Namaste America
  Agent-first directory for Indians from India in the USA — restaurants, temples, events & more.
• Itunes Search
  iTunes Search MCP — Apple's public catalog search
• Watchmode
  Watchmode MCP.
• Comicvine
  Comic Vine MCP.
• Aclimação
  Aclimação — neighborhood directory: local places, events, menus, offers, and services.
• Tapercraft — VHS Label Maker
  Compose printable VHS, DVD, cassette, CD and vinyl packaging from any movie, show, or album.
• zinema
  Turn movie/TV recommendations into playable trailer pages: permanent, free, every title plays.
• SceneF — California, Florida and Hawaii Movie Showtimes
  56 California, Florida and Hawaii movie boards: chains, indies, repertory. Verified daily. Free.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.pipeworx-io/tmdb.svg)](https://aptlynx.net/servers/io.github.pipeworx-io/tmdb)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents