IMDb MCP server for AI agents
Let Claude, ChatGPT or your own agent read IMDb: 9 typed functions through one MCP server. No IMDb API key needed.
- Site
- imdb.com
- Functions
- 9
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for IMDb alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/imdbOne MCP server for IMDb and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.
Functions
Open a function to see its arguments, what it returns and how to call it.
getPersonReads a person's biography, birth year, filmography, awards, and known roles.Arguments
Name Type Required idstringYes Returns
ImdbPersoninterface ImdbKnownFor { id: string; title: string; titleType: string | null; year: number | null; } interface ImdbPerson { id: string; url: string; name: string; birthDate: string | null; deathDate: string | null; bio: string | null; professions: string[]; imageUrl: string | null; knownFor: ImdbKnownFor[]; awardWins: number | null; awardNominations: number | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/imdb/getPersonCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.imdb.getPerson("nm0634240");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.imdb.getPerson("nm0634240"))curl -X POST https://api.bowmark.ai/v1/sites/imdb/getPerson \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"id":"nm0634240"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.imdb.getPerson("nm0634240");getTitleReads a title's full details: year, runtime, genres, plot, ratings, cast, crew, release dates.Arguments
Name Type Required idstringYes Returns
ImdbTitleinterface ImdbCredit { id: string; name: string; /** Cast only: the characters played. */ characters: string[]; } interface ImdbTitle { id: string; url: string; title: string; originalTitle: string | null; titleType: string | null; year: number | null; endYear: number | null; /** ISO date, as precise as IMDb knows it (YYYY, YYYY-MM or YYYY-MM-DD). */ releaseDate: string | null; runtimeMinutes: number | null; certificate: string | null; rating: number | null; voteCount: number | null; metascore: number | null; genres: string[]; plot: string | null; posterUrl: string | null; countries: string[]; languages: string[]; directors: ImdbCredit[]; writers: ImdbCredit[]; /** Top-billed cast, up to 15. */ cast: ImdbCredit[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/imdb/getTitleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.imdb.getTitle("tt1375666");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.imdb.getTitle("tt1375666"))curl -X POST https://api.bowmark.ai/v1/sites/imdb/getTitle \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"id":"tt1375666"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.imdb.getTitle("tt1375666");getTitleReviewsReads user reviews for a title, with user rating, text, and helpfulness count.Arguments
Name Type Required idstringA title id (tt…) or an imdb.com/title/… URL.Yes limitnumber1-25, default 10.No Returns
ImdbReviewsResponseinterface ImdbReview { id: string; author: string | null; /** The reviewer's own 1-10 rating, when they gave one. */ rating: number | null; headline: string | null; text: string; upVotes: number; downVotes: number; date: string | null; spoiler: boolean; } interface ImdbReviewsResponse { id: string; title: string | null; totalReviews: number; reviews: ImdbReview[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/imdb/getTitleReviewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.imdb.getTitleReviews({ id: "tt1375666", limit: 3 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.imdb.getTitleReviews({"id": "tt1375666", "limit": 3}))curl -X POST https://api.bowmark.ai/v1/sites/imdb/getTitleReviews \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"tt1375666","limit":3}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.imdb.getTitleReviews({ id: "tt1375666", limit: 3 });listCustomListsReads the signed-in caller's own IMDb custom lists.Arguments
Name Type Required limitnumber1-50, default 25.No afterstringCursor for pagination.No Returns
ImdbCustomListsResponseinterface ImdbCustomList { id: string; name: string; description: string | null; /** "PUBLIC" or "PRIVATE", as IMDb's own id for the list's visibility setting. */ visibility: string | null; /** IMDb's own id for what the list holds, e.g. "TITLES". */ listType: string | null; itemCount: number | null; /** ISO date the caller created this list. */ createdDate: string | null; } interface ImdbCustomListsResponse { lists: ImdbCustomList[]; /** How many custom lists the caller has, across every page. */ total: number | null; next?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/imdb/listCustomListsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.imdb.listCustomLists();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.imdb.listCustomLists())curl -X POST https://api.bowmark.ai/v1/sites/imdb/listCustomLists \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.imdb.listCustomLists();listRatingsReads the signed-in caller's own IMDb star ratings.Arguments
Name Type Required limitnumber1-50, default 25.No afterstringCursor for pagination.No Returns
ImdbRatingsResponseinterface ImdbRatingsItem { id: string; title: string; url: string; titleType: string | null; year: number | null; endYear: number | null; /** IMDb's own aggregate rating, distinct from the caller's own rating below. */ rating: number | null; voteCount: number | null; imageUrl: string | null; /** The caller's own 1-10 star rating for this title. */ userRating: number | null; /** ISO date the caller rated it. */ userRatingDate: string | null; } interface ImdbRatingsResponse { items: ImdbRatingsItem[]; /** How many titles the caller has rated, across every page. */ total: number | null; next?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/imdb/listRatingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.imdb.listRatings();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.imdb.listRatings())curl -X POST https://api.bowmark.ai/v1/sites/imdb/listRatings \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.imdb.listRatings();listWatchlistReads the signed-in caller's IMDb Watchlist.Arguments
Name Type Required limitnumber1-50, default 25.No afterstringCursor for pagination.No Returns
ImdbWatchlistResponseinterface ImdbWatchlistItem { id: string; title: string; url: string; titleType: string | null; year: number | null; endYear: number | null; rating: number | null; voteCount: number | null; imageUrl: string | null; /** ISO instant the caller added this title to their Watchlist. */ addedDate: string | null; } interface ImdbWatchlistResponse { items: ImdbWatchlistItem[]; /** How many titles are on the caller's Watchlist, across every page. */ total: number | null; next?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/imdb/listWatchlistCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.imdb.listWatchlist();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.imdb.listWatchlist())curl -X POST https://api.bowmark.ai/v1/sites/imdb/listWatchlist \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.imdb.listWatchlist();searchFull-text search across titles and people, returning matching results ranked by relevance.Arguments
Name Type Required querystringFree text, a title, a person's name, or both, e.g. "inception" or "christopher nolan".Yes type"title" | "person" | "all""title", "person" or "all" (default).No limitnumber1-50, default 10.No Returns
ImdbSearchResponseinterface ImdbSearchResult { kind: "title" | "person"; /** tt… for a title (pass to getTitle), nm… for a person (pass to getPerson). */ id: string; name: string; url: string; /** Title only: "Movie", "TV Series", "Short"… */ titleType: string | null; year: number | null; endYear: number | null; rating: number | null; voteCount: number | null; /** Person only: their primary professions. */ professions: string[]; /** Person only: the title they are best known for. */ knownFor: string | null; imageUrl: string | null; } interface ImdbSearchResponse { query: string; results: ImdbSearchResult[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/imdb/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.imdb.search({ query: "inception", type: "title", limit: 5 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.imdb.search({"query": "inception", "type": "title", "limit": 5}))curl -X POST https://api.bowmark.ai/v1/sites/imdb/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"inception","type":"title","limit":5}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.imdb.search({ query: "inception", type: "title", limit: 5 });searchSuggestionsTypeahead search for quick title and person completion as the user types.Arguments
Name Type Required querystringYes Returns
ImdbSuggestionsResponseinterface ImdbSuggestion { id: string; kind: "title" | "person" | "other"; name: string; /** Title: the year label, e.g. "2010" or "2008-2013". Person: null. */ yearLabel: string | null; /** Title: top-billed cast. Person: what they are known for, e.g. "Director, Oppenheimer (2023)". */ detail: string | null; titleType: string | null; url: string; imageUrl: string | null; } interface ImdbSuggestionsResponse { query: string; suggestions: ImdbSuggestion[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/imdb/searchSuggestionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.imdb.searchSuggestions("oppenheimer");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.imdb.searchSuggestions("oppenheimer"))curl -X POST https://api.bowmark.ai/v1/sites/imdb/searchSuggestions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"oppenheimer"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.imdb.searchSuggestions("oppenheimer");searchTitlesAdvanced title search: filter by type, genre, release year, rating and vote count; sort by votes, rating or date; paginate.Arguments
Name Type Required titleTypestring | string[]'movie', 'tvSeries', 'tvEpisode', 'short', 'tvMiniSeries', etc..No genresstring[]Genre names like 'action', 'drama', 'sci-fi'.No releaseYear{ min?: number; max?: number }Release year range: { min?: number, max?: number }.No minVotesnumberMinimum vote count (e.g., 50000 for popular titles).No minRatingnumberMinimum IMDb rating (e.g., 7.5 for highly-rated titles).No sortstringImdb.com/search's own sort param.No limitnumberNumber of results per page: 1-50, default 10.No afterstringCursor for pagination.No Returns
ImdbSearchTitlesResponseinterface ImdbSearchTitlesResult { id: string; title: string; titleType: string | null; year: number | null; rating: number | null; voteCount: number | null; } interface ImdbSearchTitlesResponse { results: ImdbSearchTitlesResult[]; /** How many titles match the filters, across every page. */ total: number | null; next?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/imdb/searchTitlesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.imdb.searchTitles({ titleType: "movie", minVotes: 100000, sort: "num_votes,desc", limit: 3 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.imdb.searchTitles({ "titleType": "movie", "minVotes": 100000, "sort": "num_votes,desc", "limit": 3 }))curl -X POST https://api.bowmark.ai/v1/sites/imdb/searchTitles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"titleType":"movie","minVotes":100000,"sort":"num_votes,desc","limit":3}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.imdb.searchTitles({ titleType: "movie", minVotes: 100000, sort: "num_votes,desc", limit: 3 });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/imdb/<function> - OpenAPI
/v1/sites/imdb/openapi.json