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.
- Site
- netflix.com
- Functions
- 22
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
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/netflixOne MCP server for Netflix 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.
browseGenreLists the titles in one Netflix genre.Arguments
Name Type Required genreIdstringYes Returns
NetflixTitleMatch[]interface NetflixTitleMatch { id: string; title: string; type: "series" | "movie"; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/netflix/browseGenreCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.netflix.browseGenre("83");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.netflix.browseGenre("83"))curl -X POST https://api.bowmark.ai/v1/sites/netflix/browseGenre \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"genreId":"83"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.netflix.browseGenre("83");findTitlesFinds Netflix titles by name.Arguments
Name Type Required querystringYes Returns
NetflixTitleSearchinterface 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/findTitlesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.netflix.findTitles("stranger things");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.netflix.findTitles("stranger things"))curl -X POST https://api.bowmark.ai/v1/sites/netflix/findTitles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"stranger things"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.netflix.findTitles("stranger things");getAccountReads the signed-in caller's own Netflix account.Arguments
None.
Returns
NetflixAccountinterface 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/getAccountCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.netflix.getAccount();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.netflix.getAccount())curl -X POST https://api.bowmark.ai/v1/sites/netflix/getAccount \ -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.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/getContinueWatchingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.netflix.getContinueWatching();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.netflix.getContinueWatching())curl -X POST https://api.bowmark.ai/v1/sites/netflix/getContinueWatching \ -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.netflix.getContinueWatching();getEpisodesLists a Netflix series' episodes by its numeric title id.Arguments
Name Type Required titleIdstringYes seasonnumberNo Returns
NetflixEpisodeListinterface 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/getEpisodesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.netflix.getEpisodes("80057281", 1);import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.netflix.getEpisodes("80057281", 1))curl -X POST https://api.bowmark.ai/v1/sites/netflix/getEpisodes \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"titleId":"80057281","season":1}'// The body of a run: the MCP run tool, or POST /v1/run return 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/getMostPopularCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.netflix.getMostPopular();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.netflix.getMostPopular())curl -X POST https://api.bowmark.ai/v1/sites/netflix/getMostPopular \ -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.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/getMyListCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.netflix.getMyList();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.netflix.getMyList())curl -X POST https://api.bowmark.ai/v1/sites/netflix/getMyList \ -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.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/getNewOnNetflixCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.netflix.getNewOnNetflix();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.netflix.getNewOnNetflix())curl -X POST https://api.bowmark.ai/v1/sites/netflix/getNewOnNetflix \ -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.netflix.getNewOnNetflix();getProfilesLists the profiles on the signed-in caller's own Netflix account.Arguments
None.
Returns
NetflixProfileListinterface 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/getProfilesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.netflix.getProfiles();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.netflix.getProfiles())curl -X POST https://api.bowmark.ai/v1/sites/netflix/getProfiles \ -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.netflix.getProfiles();getSimilarTitlesLists the titles Netflix recommends alongside one title (its "More Like This" picks) by numeric title id.Arguments
Name Type Required titleIdstringYes Returns
NetflixTitleMatch[]interface NetflixTitleMatch { id: string; title: string; type: "series" | "movie"; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/netflix/getSimilarTitlesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.netflix.getSimilarTitles("80057281");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.netflix.getSimilarTitles("80057281"))curl -X POST https://api.bowmark.ai/v1/sites/netflix/getSimilarTitles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"titleId":"80057281"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.netflix.getSimilarTitles("80057281");getTitleReads a public Netflix title page by its numeric id (the number in netflix.com/title/<id>).Arguments
Name Type Required titleIdstringYes Returns
NetflixTitleinterface 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/getTitleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.netflix.getTitle("80057281");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.netflix.getTitle("80057281"))curl -X POST https://api.bowmark.ai/v1/sites/netflix/getTitle \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"titleId":"80057281"}'// The body of a run: the MCP run tool, or POST /v1/run return 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/getTop10Call it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.netflix.getTop10();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.netflix.getTop10())curl -X POST https://api.bowmark.ai/v1/sites/netflix/getTop10 \ -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.netflix.getTop10();getTop10ByCountryGets this week's Netflix Top 10 in one country.Arguments
Name Type Required countrystringYes category"films" | "tv"No Returns
NetflixCountryTop10interface 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/getTop10ByCountryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.netflix.getTop10ByCountry("united-kingdom");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.netflix.getTop10ByCountry("united-kingdom"))curl -X POST https://api.bowmark.ai/v1/sites/netflix/getTop10ByCountry \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"country":"united-kingdom"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.netflix.getTop10ByCountry("united-kingdom");getTudumArticleReads one article on Tudum, Netflix's editorial site, by its slug or URL.Arguments
Name Type Required articlestringYes Returns
NetflixTudumArticleinterface 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/getTudumArticleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.netflix.getTudumArticle("about-tudum");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.netflix.getTudumArticle("about-tudum"))curl -X POST https://api.bowmark.ai/v1/sites/netflix/getTudumArticle \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"article":"about-tudum"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required pagenumberNo Returns
NetflixViewingHistoryEntry[]interface NetflixViewingHistoryEntry { titleId: string; title: string; lastWatchedDate?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/netflix/getViewingHistoryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.netflix.getViewingHistory();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.netflix.getViewingHistory())curl -X POST https://api.bowmark.ai/v1/sites/netflix/getViewingHistory \ -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.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/listGenresCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.netflix.listGenres();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.netflix.listGenres())curl -X POST https://api.bowmark.ai/v1/sites/netflix/listGenres \ -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.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/listTudumArticlesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.netflix.listTudumArticles();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.netflix.listTudumArticles())curl -X POST https://api.bowmark.ai/v1/sites/netflix/listTudumArticles \ -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.netflix.listTudumArticles();searchSearches the whole Netflix catalogue the way the site's own search box does.Arguments
Name Type Required querystringYes Returns
NetflixSearchResultinterface NetflixTitleMatch { id: string; title: string; type: "series" | "movie"; url: string; } interface NetflixSearchResult { query: string; results: NetflixTitleMatch[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/netflix/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.netflix.search("stranger things");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.netflix.search("stranger things"))curl -X POST https://api.bowmark.ai/v1/sites/netflix/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"stranger things"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.netflix.search("stranger things");searchTudumSearches Netflix's weekly Top 10 history by title, returning every week and category the title ranked in with its rank and views.Arguments
Name Type Required querystringYes Returns
NetflixTudumSearchResultinterface 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/searchTudumCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.netflix.searchTudum("stranger things");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.netflix.searchTudum("stranger things"))curl -X POST https://api.bowmark.ai/v1/sites/netflix/searchTudum \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"stranger things"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.netflix.searchTudum("stranger things");
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
Name Type Required titleIdstringYes Returns
NetflixMyListChangeinterface NetflixMyListChange { id: string; title?: string; inMyList: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/netflix/addToMyListCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.netflix.addToMyList("<titleId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.netflix.addToMyList("<titleId>"))curl -X POST https://api.bowmark.ai/v1/sites/netflix/addToMyList \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"titleId":"<titleId>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.netflix.addToMyList("<titleId>");rateTitleRates a title on the signed-in caller's own Netflix account by its numeric id.Arguments
Name Type Required titleIdstringYes rating"up" | "down" | "love"Yes Returns
NetflixRatinginterface 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/rateTitleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.netflix.rateTitle("<titleId>", "up");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.netflix.rateTitle("<titleId>", "up"))curl -X POST https://api.bowmark.ai/v1/sites/netflix/rateTitle \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"titleId":"<titleId>","rating":"up"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required titleIdstringYes Returns
NetflixMyListChangeinterface NetflixMyListChange { id: string; title?: string; inMyList: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/netflix/removeFromMyListCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.netflix.removeFromMyList("<titleId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.netflix.removeFromMyList("<titleId>"))curl -X POST https://api.bowmark.ai/v1/sites/netflix/removeFromMyList \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"titleId":"<titleId>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.netflix.removeFromMyList("<titleId>");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/netflix/<function> - OpenAPI
/v1/sites/netflix/openapi.json