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.

Functions
9
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just IMDb

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/imdb
Every site

One MCP server for IMDb and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both 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.

Read 9
  • getPersonReads a person's biography, birth year, filmography, awards, and known roles.

    Arguments

    NameTypeRequired
    idstringYes

    Returns ImdbPerson

    interface 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/getPerson

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.imdb.getPerson("nm0634240");
  • getTitleReads a title's full details: year, runtime, genres, plot, ratings, cast, crew, release dates.

    Arguments

    NameTypeRequired
    idstringYes

    Returns ImdbTitle

    interface 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/getTitle

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.imdb.getTitle("tt1375666");
  • getTitleReviewsReads user reviews for a title, with user rating, text, and helpfulness count.

    Arguments

    NameTypeRequired
    idstring
    A title id (tt…) or an imdb.com/title/… URL.
    Yes
    limitnumber
    1-25, default 10.
    No

    Returns ImdbReviewsResponse

    interface 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/getTitleReviews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.imdb.getTitleReviews({ id: "tt1375666", limit: 3 });
  • listCustomListsReads the signed-in caller's own IMDb custom lists.

    Arguments

    NameTypeRequired
    limitnumber
    1-50, default 25.
    No
    afterstring
    Cursor for pagination.
    No

    Returns ImdbCustomListsResponse

    interface 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/listCustomLists

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.imdb.listCustomLists();
  • listRatingsReads the signed-in caller's own IMDb star ratings.

    Arguments

    NameTypeRequired
    limitnumber
    1-50, default 25.
    No
    afterstring
    Cursor for pagination.
    No

    Returns ImdbRatingsResponse

    interface 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/listRatings

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.imdb.listRatings();
  • listWatchlistReads the signed-in caller's IMDb Watchlist.

    Arguments

    NameTypeRequired
    limitnumber
    1-50, default 25.
    No
    afterstring
    Cursor for pagination.
    No

    Returns ImdbWatchlistResponse

    interface 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/listWatchlist

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.imdb.listWatchlist();
  • searchSuggestionsTypeahead search for quick title and person completion as the user types.

    Arguments

    NameTypeRequired
    querystringYes

    Returns ImdbSuggestionsResponse

    interface 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/searchSuggestions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    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
    minVotesnumber
    Minimum vote count (e.g., 50000 for popular titles).
    No
    minRatingnumber
    Minimum IMDb rating (e.g., 7.5 for highly-rated titles).
    No
    sortstring
    Imdb.com/search's own sort param.
    No
    limitnumber
    Number of results per page: 1-50, default 10.
    No
    afterstring
    Cursor for pagination.
    No

    Returns ImdbSearchTitlesResponse

    interface 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/searchTitles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.imdb.searchTitles({
      titleType: "movie",
      minVotes: 100000,
      sort: "num_votes,desc",
      limit: 3
    });

Use it from code