Netflix MCP server for AI agents

Let Claude, ChatGPT or your own agent read and act on Netflix: 22 typed functions through one MCP server. No Netflix API key needed.

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

Connect

Just Netflix

An MCP server for Netflix 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/netflix
Every site

One MCP server for Netflix 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 19
  • browseGenreLists the titles in one Netflix genre.

    Arguments

    NameTypeRequired
    genreIdstringYes

    Returns NetflixTitleMatch[]

    interface NetflixTitleMatch {
      id: string;
      title: string;
      type: "series" | "movie";
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/netflix/browseGenre

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.netflix.browseGenre("83");
  • findTitlesFinds Netflix titles by name.

    Arguments

    NameTypeRequired
    querystringYes

    Returns NetflixTitleSearch

    interface NetflixTitleMatch {
      id: string;
      title: string;
      type: "series" | "movie";
      url: string;
    }
    
    interface NetflixTitleSearch {
      query: string;
      matches: NetflixTitleMatch[];
      /** How many distinct titles the public catalogue pages listed, the pool searched. */
      searched: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/netflix/findTitles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.netflix.findTitles("stranger things");
  • getAccountReads the signed-in caller's own Netflix account.

    Arguments

    None.

    Returns NetflixAccount

    interface NetflixAccount {
      name?: string;
      email?: string;
      /** e.g. "CURRENT_MEMBER". */
      membershipStatus: string;
      /** Two-letter country, e.g. "US". */
      countryOfSignup?: string;
      currentCountry?: string;
      memberSince?: string | number;
      isInFreeTrial?: boolean;
      isKids?: boolean;
      /** e.g. "en-US". */
      locale?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/netflix/getAccount

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.netflix.getAccount();
  • getContinueWatchingReads the signed-in caller's own Netflix Continue Watching row.

    Arguments

    None.

    Returns NetflixTitleMatch[]

    interface NetflixTitleMatch {
      id: string;
      title: string;
      type: "series" | "movie";
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/netflix/getContinueWatching

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.netflix.getContinueWatching();
  • getEpisodesLists a Netflix series' episodes by its numeric title id.

    Arguments

    NameTypeRequired
    titleIdstringYes
    seasonnumberNo

    Returns NetflixEpisodeList

    interface NetflixEpisode {
      id: string;
      number: number;
      title: string;
      synopsis?: string;
      runtimeSeconds?: number;
      imageUrl?: string;
    }
    
    interface NetflixSeason {
      /** The season's own video id. */
      id: string;
      /** 1-based position in the title's season list. */
      number: number;
      /** e.g. "Season 1", "Part 2" or "Limited Series". */
      label?: string;
      title?: string;
      episodes: NetflixEpisode[];
    }
    
    interface NetflixEpisodeList {
      id: string;
      title?: string;
      url: string;
      seasons: NetflixSeason[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/netflix/getEpisodes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.netflix.getEpisodes("80057281", 1);
  • getMostPopularGets Netflix's all-time Most Popular lists.

    Arguments

    None.

    Returns NetflixMostPopularEntry[]

    interface NetflixMostPopularEntry {
      category: "TV" | "Films";
      language: "English" | "Non-English";
      rank: number;
      title: string;
      seasonTitle?: string;
      /** Views in the title's first 91 days (hours viewed divided by runtime). */
      views?: number;
      hoursViewed?: number;
      /** Runtime in hours. */
      runtimeHours?: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/netflix/getMostPopular

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.netflix.getMostPopular();
  • getMyListReads the signed-in caller's own Netflix My List.

    Arguments

    None.

    Returns NetflixTitleMatch[]

    interface NetflixTitleMatch {
      id: string;
      title: string;
      type: "series" | "movie";
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/netflix/getMyList

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.netflix.getMyList();
  • getNewOnNetflixLists what Netflix shows in its New on Netflix row right now, TV shows then films.

    Arguments

    None.

    Returns NetflixTitleMatch[]

    interface NetflixTitleMatch {
      id: string;
      title: string;
      type: "series" | "movie";
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/netflix/getNewOnNetflix

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.netflix.getNewOnNetflix();
  • getProfilesLists the profiles on the signed-in caller's own Netflix account.

    Arguments

    None.

    Returns NetflixProfileList

    interface NetflixAccountProfile {
      guid: string;
      avatarTitle?: string;
      avatarKey?: string;
      avatarUrl?: string;
    }
    
    interface NetflixProfileList {
      canCreateProfile?: boolean;
      profiles: NetflixAccountProfile[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/netflix/getProfiles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.netflix.getProfiles();
  • getSimilarTitlesLists the titles Netflix recommends alongside one title (its "More Like This" picks) by numeric title id.

    Arguments

    NameTypeRequired
    titleIdstringYes

    Returns NetflixTitleMatch[]

    interface NetflixTitleMatch {
      id: string;
      title: string;
      type: "series" | "movie";
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/netflix/getSimilarTitles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.netflix.getSimilarTitles("80057281");
  • getTitleReads a public Netflix title page by its numeric id (the number in netflix.com/title/<id>).

    Arguments

    NameTypeRequired
    titleIdstringYes

    Returns NetflixTitle

    interface NetflixTitle {
      id: string;
      title: string;
      description?: string;
      imageUrl?: string;
      releaseYear?: number;
      runtime?: number;
      maturityRating?: string;
      genres?: string[];
      /** e.g. "5 Seasons", present on a series, absent on a film. */
      seasons?: string;
      starring?: string[];
      creators?: string[];
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/netflix/getTitle

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.netflix.getTitle("80057281");
  • getTop10Gets Netflix's current Top 10 list for the week.

    Arguments

    None.

    Returns NetflixTop10Entry[]

    interface NetflixTop10Entry {
      rank: number;
      category: "TV" | "Films";
      /** Netflix ranks English and non-English titles separately within each category. */
      language: "English" | "Non-English";
      title: string;
      weeklyViews?: number;
      weeklyHours?: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/netflix/getTop10

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.netflix.getTop10();
  • getTop10ByCountryGets this week's Netflix Top 10 in one country.

    Arguments

    NameTypeRequired
    countrystringYes
    category"films" | "tv"No

    Returns NetflixCountryTop10

    interface NetflixCountryTop10Entry {
      rank: number;
      /** As Netflix lists it; a show carries its season, e.g. "Black Doves: Season 2". */
      title: string;
      /** How many weeks this title has spent in this country's Top 10. */
      weeksInTop10?: number;
    }
    
    interface NetflixCountryTop10 {
      country: string;
      /** The country slug Netflix uses in /tudum/top10/<slug>. */
      countrySlug: string;
      /** The week the list covers, as Netflix labels it, e.g. "11/2/26 - 11/8/26". */
      week?: string;
      films?: NetflixCountryTop10Entry[];
      tv?: NetflixCountryTop10Entry[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/netflix/getTop10ByCountry

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.netflix.getTop10ByCountry("united-kingdom");
  • getTudumArticleReads one article on Tudum, Netflix's editorial site, by its slug or URL.

    Arguments

    NameTypeRequired
    articlestringYes

    Returns NetflixTudumArticle

    interface NetflixTudumArticle {
      slug: string;
      url: string;
      headline: string;
      description?: string;
      /** Tudum's own section label, e.g. "Explainer". */
      section?: string;
      datePublished?: string;
      dateModified?: string;
      authors: string[];
      imageUrl?: string;
      /** The article text, one paragraph per block, subheads prefixed "## ". */
      body: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/netflix/getTudumArticle

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.netflix.getTudumArticle("about-tudum");
  • getViewingHistoryReads the signed-in caller's own Netflix viewing history, most recent first, 100 per page (page 0, 1, …).

    Arguments

    NameTypeRequired
    pagenumberNo

    Returns NetflixViewingHistoryEntry[]

    interface NetflixViewingHistoryEntry {
      titleId: string;
      title: string;
      lastWatchedDate?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/netflix/getViewingHistory

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.netflix.getViewingHistory();
  • listGenresLists the browsable sub-genres Netflix shows on its public TV Shows, Movies and Only on Netflix hub pages (e.g. "TV Dramas", "Suspenseful TV Shows")…

    Arguments

    None.

    Returns NetflixGenre[]

    interface NetflixGenre {
      id: string;
      name: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/netflix/listGenres

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.netflix.listGenres();
  • listTudumArticlesLists the articles on Netflix's Tudum front page right now.

    Arguments

    None.

    Returns NetflixTudumArticleLink[]

    interface NetflixTudumArticleLink {
      slug: string;
      url: string;
      headline: string;
      summary?: string;
      imageUrl?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/netflix/listTudumArticles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.netflix.listTudumArticles();
  • searchTudumSearches Netflix's weekly Top 10 history by title, returning every week and category the title ranked in with its rank and views.

    Arguments

    NameTypeRequired
    querystringYes

    Returns NetflixTudumSearchResult

    interface NetflixTudumSearchEntry {
      title: string;
      /** The title's season/part, e.g. "Stranger Things 5", absent when the row is not a season. */
      seasonTitle?: string;
      category: "TV" | "Films";
      language: "English" | "Non-English";
    
      week: string;
      rank: number;
      weeklyViews?: number;
      weeklyHours?: number;
    }
    
    interface NetflixTudumSearchResult {
      query: string;
      matches: NetflixTudumSearchEntry[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/netflix/searchTudum

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.netflix.searchTudum("stranger things");
Act 3
  • addToMyListAdds a title to the signed-in caller's own Netflix My List by its numeric id (from findTitles, search or netflix.com/title/<id>), returning the title…

    Arguments

    NameTypeRequired
    titleIdstringYes

    Returns NetflixMyListChange

    interface NetflixMyListChange {
      id: string;
      title?: string;
      inMyList: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/netflix/addToMyList

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.netflix.addToMyList("<titleId>");
  • rateTitleRates a title on the signed-in caller's own Netflix account by its numeric id.

    Arguments

    NameTypeRequired
    titleIdstringYes
    rating"up" | "down" | "love"Yes

    Returns NetflixRating

    interface NetflixRating {
      id: string;
      /** THUMBS_DOWN = "Not for me", THUMBS_UP = "I like this", THUMBS_WAY_UP = "Love this!" */
      rating: "THUMBS_DOWN" | "THUMBS_UP" | "THUMBS_WAY_UP";
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/netflix/rateTitle

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.netflix.rateTitle("<titleId>", "up");
  • removeFromMyListRemoves a title from the signed-in caller's own Netflix My List by its numeric id, returning the title and whether it is still on the list.

    Arguments

    NameTypeRequired
    titleIdstringYes

    Returns NetflixMyListChange

    interface NetflixMyListChange {
      id: string;
      title?: string;
      inMyList: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/netflix/removeFromMyList

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.netflix.removeFromMyList("<titleId>");

Use it from code