Film & Series
Search movies and TV, get details, trending titles, and watch providers via TMDB. This product uses TMDB and the TMDB APIs but is not endorsed, certified, or otherwise approved by TMDB.
Overview
Film & Series connects your AI client to The Movie Database (TMDB) for movie and TV metadata: search titles and people, fetch details and seasons, browse trending/discover lists, and look up streaming watch providers.
This product uses TMDB and the TMDB APIs but is not endorsed, certified, or otherwise approved by TMDB.
Prerequisites
- A stackgate.ai account
- Optional: your own free TMDB API key for BYOK (bypasses the shared hub daily quota)
Getting credentials
- Open Integrations → Film & Series.
- Click Activate — stackgate.ai can use a shared hub TMDB key so you can start immediately.
- Optional: in TMDB Settings → API, copy your API Key and paste it into the integration settings for higher personal usage (BYOK).
No OAuth connect flow is required.
Using with AI clients
- Dedicated endpoint:
POST /mcp/film-series - Private gateway:
film-series__*tools (e.g.film-series__search_multi)
Connect through stackgate.ai like your other cloud integrations — HTTP MCP endpoint or private gateway with your API token. No local install.
Typical workflow: search multi → get movie / TV series details → season episodes or watch providers → trending/discover when exploring.
Poster and still paths from TMDB are relative; prefix with https://image.tmdb.org/t/p/w500 (or w780 / original).
Troubleshooting
- Hub quota exceeded (429) — daily fair-use limits apply on the shared hub TMDB key. Wait until tomorrow or add your own TMDB API key in integration settings.
- Invalid API key (401) — check the hub key or your BYOK key under TMDB API settings.
- Resource not found (404) — verify the TMDB movie, series, season, or person ID from a search result.
- Rate limit (429) — TMDB asks clients to stay respectful (~40 requests/second soft limit). Reduce request frequency.
- Attribution — when building products on this data, follow TMDB API Terms and logos & attribution.
Available tools
-
search_multi
Search TMDB across movies, TV series, and people in one query.
-
search_movies
Search TMDB for movies by title.
-
search_tv
Search TMDB for TV series by name.
-
get_movie
Get movie details by TMDB movie ID. Optionally append credits, videos, or watch/providers.
-
get_tv_series
Get TV series details by TMDB series ID. Optionally append credits, videos, or watch/providers.
-
get_tv_season
Get details and episode list for a TV season.
-
get_person
Get person (cast/crew) details by TMDB person ID.
-
list_trending
List trending movies, TV series, people, or all media for the day or week.
-
discover_movies
Discover movies with filters such as genre, year, sort, and minimum vote average.
-
discover_tv
Discover TV series with filters such as genre, year, sort, and minimum vote average.
-
get_watch_providers
Get streaming, rent, and buy watch providers for a movie or TV series by country.
MCP endpoint:
https://stackgate.ai/mcp/film-series
(HTTP) or via the
private gateway.