
Tmdb
Pipeworx-hosted MCP server giving AI clients access to TMDB movie, TV and people data
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://gateway.pipeworx.io/tmdb/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"tmdb": {
"url": "https://gateway.pipeworx.io/tmdb/mcp"
}
}
}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.