# Tmdb

> Tmdb is a freemium MCP server for news and media. Pipeworx-hosted MCP server giving AI clients access to TMDB movie, TV and people data. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/tmdb
- **Repository:** https://github.com/pipeworx-io/mcp-tmdb
- **MCP Registry name:** io.github.pipeworx-io/tmdb
- **Categories:** [news and media](https://ai-powered.com/categories/news-and-media)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/tmdb/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [Entertainment Feeds](https://ai-powered.com/mcp/entertainment-feeds): Entertainment Feeds is a freemium MCP server for news and media.
- [Newsapi](https://ai-powered.com/mcp/newsapi): Newsapi is a freemium MCP server for news and media.
- [Tech Feeds](https://ai-powered.com/mcp/tech-feeds): Tech Feeds is a freemium MCP server for news and media.
- [Crypto Feeds](https://ai-powered.com/mcp/crypto-feeds): Crypto Feeds is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/tmdb
