IMDB
live MediaMoviesTVDataIMDB 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_search
required: query Search titles by primary_title substring. Returns title + rating per hit, sorted by num_votes desc. Optional filters: title_type, year range, genre, min_votes.
query req string Title substring (e.g. "godfather") title_type opt string movie | tvSeries | tvMiniSeries year_from opt number Minimum start year year_to opt number Maximum start year genre opt string Genre filter (e.g. "Comedy") min_votes opt number Minimum num_votes (default 0) limit opt number 1-100 (default 20) Try it
imdb_get_title
required: imdb_id Full detail for one IMDB title by tconst id. Returns title, year, runtime, genres, rating, and crew nconst arrays.
imdb_id req string tconst, e.g. "tt0111161" Try it
imdb_top_rated Highest-rated titles, filterable by title_type, genre, year range, and min vote count.
title_type opt string movie | tvSeries | tvMiniSeries (default movie) genre opt string Genre filter year_from opt number Minimum start year year_to opt number Maximum start year min_votes opt number Minimum num_votes (default 10000) limit opt number 1-100 (default 25) Try it
imdb_episodes
required: series_id List episodes for a TV series in season/episode order with per-episode ratings.
series_id req string Series tconst, e.g. "tt0903747" season opt number Optional: filter to one season limit opt number Max 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");Related packs
Other Pipeworx packs in the same categories (Media, Movies, TV, Data):