Skip to content
MCP server

Tmdb

Pipeworx-hosted MCP server giving AI clients access to TMDB movie, TV and people data

Install
Pricing
Freemium
Platforms
API, CLI, self-hosted
Runs
Locally or Remotely
Version
0.2.1
Listing updated
today

Similar MCP servers

About Tmdb

Tmdb is a freemium MCP server for news and media. It can run locally on your machine or as a hosted remote server.

The README says this is an unofficial TMDB v3 integration that Pipeworx runs as a gateway, so the upstream API key is a platform key and per-call keys can be passed through an _apiKey argument. The server exposes 19 pack tools covering movie and TV search, detail lookups, cast and crew, trailers, recommendations, episode and season data, person credits, trending lists and discover filters with genre directories.

The hosted endpoint also lists shared Pipeworx meta-tools such as ask_pipeworx alongside the pack's own tools, so a connected client can route questions across other data sources. The npm package is a local stdio bridge that forwards calls to the same gateway and needs network access.

It suits developers and assistants that need film and television lookups inside an MCP-enabled workflow, such as answering cast questions or pulling trending titles. Usage is metered by daily call caps that rise with a free account.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://gateway.pipeworx.io/tmdb/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tmdb": {
      "url": "https://gateway.pipeworx.io/tmdb/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.

Tools this server provides (19)

Taken from the project documentation; the running server may differ.

configuration
Image config and change keys.
search_movie
Search movies by title.
search_tv
Search TV shows by title.
search_person
Search actors and crew by name.
search_multi
Search movies, TV and people together.
movie
Movie details by movie_id.
movie_credits
Cast and crew for a movie.
movie_videos
Trailers and clips for a movie.
movie_recommendations
Recommended movies for a title.
tv
TV show details by tv_id.
tv_season
Season details for a TV show.
tv_episode
Episode details for a TV show.
person
Person details by person_id.
person_combined_credits
Movie and TV credits for a person.
trending
Trending movies, TV or people by time window.
discover_movie
Discover movies with filters.
discover_tv
Discover TV shows with filters.
genres_movie
Movie genre directory with IDs.
genres_tv
TV genre directory with IDs.

What it does

Movie and TV search
Search films, television shows, people or all types at once by keyword.
Detailed title records
Retrieve runtime, genres, budget, networks, air dates and episode counts for movies and shows.
Cast and crew credits
Look up actors, characters, directors and other crew for a given film or person.
Trailers and recommendations
List trailers, teasers and clips, plus films TMDB recommends for a title.
Trending and discover filters
Pull trending lists by day or week and filter discovery by genre, year and rating.
Image URL configuration
Fetch the base image URL and size options needed to build poster and backdrop links.

Good for

  • Answer who played a character or directed a film during a chat session
  • Find the TMDB identifier for a title and fetch its episodes or seasons
  • Build a weekly list of trending movies or shows for a newsletter
  • Recommend films similar to one a user already likes
  • Pull trailers and poster images for a movie browsing interface

Pricing

Freemium, from $49 a month

Free anonymous and free account tiers with daily caps; paid pay-as-you-go and $49/$99 monthly subscriptions

Prices change. Check pipeworx.io before you buy.

Tmdb FAQ

Does it work without an API key?

The npm package notes that without a Pipeworx key calls are anonymous and capped at 50 a day; a free account raises the cap to 200 a day.

Which tools does the hosted endpoint list?

The README says the endpoint lists the pack's tools plus about 30 shared Pipeworx meta-tools such as ask_pipeworx.

Can I use my own TMDB key?

The README says the pack accepts a per-call _apiKey argument to supply your own key.

Is Tmdb free?

Tmdb has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

How do I add Tmdb to Claude Code?

Run this command in your terminal: claude mcp add --transport http tmdb https://gateway.pipeworx.io/tmdb/mcp

What are the best alternatives to Tmdb?

The closest alternatives to Tmdb are Entertainment Feeds, Newsapi, Tech Feeds and Crypto Feeds.

Where this comes from

  • Description: written from the project's README, the project's website and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers