Prime Video MCP server for AI agents

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

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

Connect

Just Prime Video

An MCP server for Prime Video 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/prime_video
Every site

One MCP server for Prime Video 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 22
  • getChannelRead one add-on channel: what it is called, its top ten, its originals and series, and the live events it is carrying.

    Arguments

    NameTypeRequired
    channelstringYes

    Returns PrimeVideoChannelDetail

    interface PrimeVideoTitle {
      titleId: string;
      catalogId: string | null;
      title: string;
      url: string;
      entityType: string | null;
      releaseYear: number | null;
      maturityRating: string | null;
      entitled: boolean;
      watchMessage: string | null;
    }
    
    interface PrimeVideoCategoryRow {
      heading: string;
      titles: PrimeVideoTitle[];
      nextPage?: string;
    }
    
    interface PrimeVideoChannelDetail {
      name: string;
      rows: PrimeVideoCategoryRow[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/prime_video/getChannel

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.prime_video.getChannel("0350778f-c66c-40e5-8015-bec5c0139fe8");
  • getLiveScheduleRead one live station's schedule.

    Arguments

    NameTypeRequired
    section"livetv" | "news"Yes
    stationIdstringYes

    Returns PrimeVideoLiveProgram[]

    interface PrimeVideoLiveProgram {
      title: string;
      seriesTitle: string | null;
      start: number;
      end: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/prime_video/getLiveSchedule

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.prime_video.getLiveSchedule("livetv", "amzn1.dv.gti.281ad0f8-f892-4d4f-906f-52b324ca7c12");
  • getPersonRead a cast member's Prime Video page: their name, what they are credited as, when and where they were born, their biography, and the titles of…

    Arguments

    NameTypeRequired
    personIdstringYes

    Returns PrimeVideoPerson

    interface PrimeVideoPersonCredit {
      titleId: string | null;
      catalogId: string;
      title: string;
      releaseYear: number | null;
      runtime: string | null;
      synopsis: string | null;
      maturityRating: string | null;
    }
    
    interface PrimeVideoPerson {
      personId: string;
      name: string;
      roles: string[];
      birthPlace: string | null;
      dateOfBirth: string | null;
      bio: string | null;
      imdbUrl: string | null;
      filmography: PrimeVideoPersonCredit[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/prime_video/getPerson

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.prime_video.getPerson("amzn1.dv.gti.06330a24-7d99-4c06-8bac-10feccecb5cb");
  • getTitleRead one film, series-season or episode the way a viewer reads its page: title, synopsis, year, release date, runtime (both the display string and…

    Arguments

    NameTypeRequired
    titleIdstringYes

    Returns PrimeVideoTitleDetail

    interface PrimeVideoCredit {
      name: string;
      searchLink: string | null;
    }
    
    interface PrimeVideoRatingBucket {
      stars: 1 | 2 | 3 | 4 | 5;
      percentage: number;
    }
    
    interface PrimeVideoTitleDetail {
      titleId: string;
      catalogId: string | null;
      title: string;
      seriesTitle: string | null;
      seasonNumber: number | null;
      titleType: string | null;
      synopsis: string | null;
      releaseYear: number | null;
      releaseDate: string | null;
      runtime: string | null;
      durationSeconds: number | null;
      genres: string[];
      maturityRating: string | null;
      cast: PrimeVideoCredit[];
      directors: PrimeVideoCredit[];
      studios: string[];
      amazonRating: { value: number; count: number } | null;
      ratingsHistogram: PrimeVideoRatingBucket[];
      imdbScore: number | null;
      audioTracks: string[];
      subtitles: string[];
      isUhd: boolean;
      isHdr: boolean;
      isDolbyVision: boolean;
      isDolbyAtmos: boolean;
      isXRay: boolean;
      isClosedCaption: boolean;
      isPrime: boolean;
      isAd: boolean;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.prime_video.getTitle("0SC64NC24QA7M9AFWBEK87WWS0");
  • getWatchlistRead the caller's own Prime Video watchlist.

    Arguments

    None.

    Returns PrimeVideoTitle[]

    interface PrimeVideoTitle {
      titleId: string;
      catalogId: string | null;
      title: string;
      url: string;
      entityType: string | null;
      releaseYear: number | null;
      maturityRating: string | null;
      entitled: boolean;
      watchMessage: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/prime_video/getWatchlist

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.prime_video.getWatchlist();
  • getWatchOptionsSay how you would actually watch a title: included with your Prime membership, free with ads, on an add-on channel you would have to subscribe to…

    Arguments

    NameTypeRequired
    titleIdstringYes

    Returns PrimeVideoWatchOptions

    interface PrimeVideoWatchOffer {
      kind: "rent" | "buy" | "subscribe";
      label: string;
      price: { currency: string; value: string } | null;
      quality: "SD" | "HD" | "UHD" | null;
      channel: { benefitId: string; link: string } | null;
      preorder: boolean;
      scope: "episode" | "season" | "series" | "bundle" | "movie" | null;
    }
    
    interface PrimeVideoWatchOptions {
      titleId: string;
      entitlementType: "Entitled" | "Unentitled";
      entitled: boolean;
      message: string;
      channel: { name: string; link: string } | null;
      offers: PrimeVideoWatchOffer[];
      highValueMessage: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/prime_video/getWatchOptions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.prime_video.getWatchOptions("0SC64NC24QA7M9AFWBEK87WWS0");
  • listCategoriesList the ways Prime Video lets you browse.

    Arguments

    None.

    Returns PrimeVideoCategory[]

    interface PrimeVideoCategory {
      name: string;
      slug: string;
      kind: "genre" | "collection" | "storefront";
      path: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/prime_video/listCategories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.prime_video.listCategories();
  • listCategoryTitlesBrowse one genre, collection or storefront and get its rows of titles back.

    Arguments

    NameTypeRequired
    pathstringYes

    Returns PrimeVideoCategoryRow[]

    interface PrimeVideoTitle {
      titleId: string;
      catalogId: string | null;
      title: string;
      url: string;
      entityType: string | null;
      releaseYear: number | null;
      maturityRating: string | null;
      entitled: boolean;
      watchMessage: string | null;
    }
    
    interface PrimeVideoCategoryRow {
      heading: string;
      titles: PrimeVideoTitle[];
      nextPage?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/prime_video/listCategoryTitles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.prime_video.listCategoryTitles("/genre/comedy");
  • listChannelsList the add-on subscriptions Prime Video sells inside itself.

    Arguments

    None.

    Returns PrimeVideoChannel[]

    interface PrimeVideoChannel {
      name: string;
      channelId: string | null;
      benefitId: string | null;
      synopsis: string | null;
      offerMessage: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/prime_video/listChannels

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.prime_video.listChannels();
  • listContinueWatchingWhat the caller started and did not finish, and how far in they got.

    Arguments

    None.

    Returns PrimeVideoTitle[]

    interface PrimeVideoTitle {
      titleId: string;
      catalogId: string | null;
      title: string;
      url: string;
      entityType: string | null;
      releaseYear: number | null;
      maturityRating: string | null;
      entitled: boolean;
      watchMessage: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/prime_video/listContinueWatching

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.prime_video.listContinueWatching();
  • listDealsWhat is discounted to rent or buy on Prime Video this week.

    Arguments

    None.

    Returns PrimeVideoCategoryRow[]

    interface PrimeVideoTitle {
      titleId: string;
      catalogId: string | null;
      title: string;
      url: string;
      entityType: string | null;
      releaseYear: number | null;
      maturityRating: string | null;
      entitled: boolean;
      watchMessage: string | null;
    }
    
    interface PrimeVideoCategoryRow {
      heading: string;
      titles: PrimeVideoTitle[];
      nextPage?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/prime_video/listDeals

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.prime_video.listDeals();
  • listEpisodesList a season's episodes with number, title, synopsis, runtime, release date, artwork, and the audio and subtitle languages each one ships.

    Arguments

    NameTypeRequired
    titleIdstringYes

    Returns PrimeVideoEpisode[]

    interface PrimeVideoEpisode {
      titleId: string | null;
      episodeNumber: number;
      title: string;
      synopsis: string | null;
      runtime: string | null;
      durationSeconds: number | null;
      releaseDate: string | null;
      releaseYear: number | null;
      images: { packshot: string | null; covershot: string | null };
      audioTracks: string[];
      subtitles: string[];
      isUhd: boolean;
      isHdr: boolean;
      isDolbyVision: boolean;
      isDolbyAtmos: boolean;
      isXRay: boolean;
      isClosedCaption: boolean;
      isPrime: boolean;
      isAd: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/prime_video/listEpisodes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.prime_video.listEpisodes("0S1FYJ3LY9KTL9C7WFFAGA9F6F");
  • listFreeToWatchWhat you can watch on Prime Video without paying anything at all.

    Arguments

    None.

    Returns PrimeVideoCategoryRow[]

    interface PrimeVideoTitle {
      titleId: string;
      catalogId: string | null;
      title: string;
      url: string;
      entityType: string | null;
      releaseYear: number | null;
      maturityRating: string | null;
      entitled: boolean;
      watchMessage: string | null;
    }
    
    interface PrimeVideoCategoryRow {
      heading: string;
      titles: PrimeVideoTitle[];
      nextPage?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/prime_video/listFreeToWatch

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.prime_video.listFreeToWatch();
  • listLiveChannelsList the free live TV and news stations Prime Video streams.

    Arguments

    NameTypeRequired
    section"livetv" | "news"Yes

    Returns PrimeVideoLiveStation[]

    interface PrimeVideoLiveProgram {
      title: string;
      seriesTitle: string | null;
      start: number;
      end: number;
    }
    
    interface PrimeVideoLiveStation {
      id: string;
      name: string;
      logo: string | null;
      group: string;
      nowPlaying: PrimeVideoLiveProgram | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/prime_video/listLiveChannels

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.prime_video.listLiveChannels("livetv");
  • listLiveSportsWhat sport is on Prime Video now and what is coming.

    Arguments

    None.

    Returns PrimeVideoLiveSportsEvent[]

    interface PrimeVideoLiveSportsEvent {
      titleId: string;
      title: string;
      group: string;
      status: "LIVE" | "UPCOMING" | null;
      timeBadge: string | null;
      venue: string | null;
      entitled: boolean;
      watchMessage: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/prime_video/listLiveSports

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.prime_video.listLiveSports();
  • listNewReleasesWhat has just arrived on Prime Video and what is coming.

    Arguments

    None.

    Returns PrimeVideoCategoryRow[]

    interface PrimeVideoTitle {
      titleId: string;
      catalogId: string | null;
      title: string;
      url: string;
      entityType: string | null;
      releaseYear: number | null;
      maturityRating: string | null;
      entitled: boolean;
      watchMessage: string | null;
    }
    
    interface PrimeVideoCategoryRow {
      heading: string;
      titles: PrimeVideoTitle[];
      nextPage?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/prime_video/listNewReleases

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.prime_video.listNewReleases();
  • listPurchasesThe films and series the caller has already rented or bought.

    Arguments

    None.

    Returns PrimeVideoTitle[]

    interface PrimeVideoTitle {
      titleId: string;
      catalogId: string | null;
      title: string;
      url: string;
      entityType: string | null;
      releaseYear: number | null;
      maturityRating: string | null;
      entitled: boolean;
      watchMessage: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/prime_video/listPurchases

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.prime_video.listPurchases();
  • listRelatedTitlesWhat to watch next after this one.

    Arguments

    NameTypeRequired
    titleIdstringYes

    Returns PrimeVideoCategoryRow[]

    interface PrimeVideoTitle {
      titleId: string;
      catalogId: string | null;
      title: string;
      url: string;
      entityType: string | null;
      releaseYear: number | null;
      maturityRating: string | null;
      entitled: boolean;
      watchMessage: string | null;
    }
    
    interface PrimeVideoCategoryRow {
      heading: string;
      titles: PrimeVideoTitle[];
      nextPage?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/prime_video/listRelatedTitles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.prime_video.listRelatedTitles("0SC64NC24QA7M9AFWBEK87WWS0");
  • listSeasonsList every season of a series with the titleId that opens each one, its number, its display name, and whether it needs paying for beyond what the…

    Arguments

    NameTypeRequired
    titleIdstringYes

    Returns PrimeVideoSeason[]

    interface PrimeVideoSeason {
      seasonId: string;
      seasonLink: string;
      displayName: string;
      sequenceNumber: number;
      seasonSelectorIcon: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/prime_video/listSeasons

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.prime_video.listSeasons("0S1FYJ3LY9KTL9C7WFFAGA9F6F");
  • listTop10Prime Video's own top ten right now.

    Arguments

    NameTypeRequired
    list"tv" | "movies" | "channel"Yes
    channelIdstringNo

    Returns PrimeVideoTop10Entry[]

    interface PrimeVideoTitle {
      titleId: string;
      catalogId: string | null;
      title: string;
      url: string;
      entityType: string | null;
      releaseYear: number | null;
      maturityRating: string | null;
      entitled: boolean;
      watchMessage: string | null;
    }
    
    interface PrimeVideoTop10Entry extends PrimeVideoTitle {
      position: number;
      list: "tv" | "movies" | "channel";
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/prime_video/listTop10

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.prime_video.listTop10("movies");
  • searchTitlesSearch Prime Video's whole catalogue for what a person would type.

    Arguments

    NameTypeRequired
    querystringYes

    Returns PrimeVideoTitle[]

    interface PrimeVideoTitle {
      titleId: string;
      catalogId: string | null;
      title: string;
      url: string;
      entityType: string | null;
      releaseYear: number | null;
      maturityRating: string | null;
      entitled: boolean;
      watchMessage: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/prime_video/searchTitles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.prime_video.searchTitles("the matrix");
  • suggestTitlesAsk Prime Video's own search box what it would autocomplete a prefix to.

    Arguments

    NameTypeRequired
    prefixstringYes

    Returns PrimeVideoTitleSuggestion[]

    interface PrimeVideoTitleSuggestion {
      value: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/prime_video/suggestTitles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.prime_video.suggestTitles("the boy");
Act 1
  • toggleWatchlistAdd a title to the caller's watchlist, or take one off it.

    Arguments

    NameTypeRequired
    titleIdstringYes
    action"add" | "remove"No

    Returns { titleId: string; action: "add" | "remove"; ok: true }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/prime_video/toggleWatchlist

    Call it

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

Use it from code