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 titles by primary_title substring. Returns title + rating per hit, sorted by num_votes desc. Optional filters: title_type, year range, genre, min_votes.
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. Returns title, year, runtime, genres, rating, and crew 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.
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 episodes for a TV series in season/episode order with per-episode ratings.
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");