IMDB
liveFilm/TVEntertainmentIMDB title/ratings/crew/episode data from the public non-commercial bulk dumps, ingested daily. Search, top-rated lookups, episode lists. No auth required.
Tools
imdb_searchrequired: querySearch IMDB titles by primary_title (case-insensitive substring). Joins ratings inline so each hit includes average_rating + num_votes. Optionally filter by title_type, year range, or genre. Returns u
queryreqstringTitle substring (e.g. "godfather")title_typeoptstringmovie | tvSeries | tvMiniSeriesyear_fromoptnumberMinimum start yearyear_tooptnumberMaximum start yeargenreoptstringGenre filter (e.g. "Comedy")min_votesoptnumberMinimum num_votes (default 0)limitoptnumber1-100 (default 20)Try it
imdb_get_titlerequired: imdb_idFull detail for one IMDB title by tconst id (e.g. "tt0111161"). Returns title, year, runtime, genres, plus rating (average + votes) and crew (directors/writers as nconst arrays).
imdb_idreqstringtconst, e.g. "tt0111161"Try it
imdb_top_ratedHighest-rated titles, filterable by title_type, genre, year range, and min vote count. Use min_votes to filter out obscure titles with inflated averages (e.g. min_votes=10000 for IMDB-Top-250-style li
title_typeoptstringmovie | tvSeries | tvMiniSeries (default movie)genreoptstringGenre filteryear_fromoptnumberMinimum start yearyear_tooptnumberMaximum start yearmin_votesoptnumberMinimum num_votes (default 10000)limitoptnumber1-100 (default 25)Try it
imdb_episodesrequired: series_idList every episode for a TV series, in season/episode order. Returns parent series detail plus episode list with title and rating per episode.
series_idreqstringSeries tconst, e.g. "tt0903747"seasonoptnumberOptional: filter to one seasonlimitoptnumberMax episodes (default 500, max 2000)Try it
Test with curl
The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.
curl -X POST https://gateway.pipeworx.io/imdb/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'curl -X POST https://gateway.pipeworx.io/imdb/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"imdb_search","arguments":{"query": "hello"}}}'Use with the SDK
Install @pipeworx/sdk to call tools from any TypeScript/Node project.
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("imdb_search", {"query":"example"});// Or ask in plain English:
const answer = await px.ask("imdb title/ratings/crew/episode data from the public non-commercial bulk dumps, ingested daily");