← Back to Home

Tool Reference

Complete reference for all 110 MCP tools. Use these with natural language prompts in Claude, Cursor, or any MCP-compatible client.

🎬 Videos

Manage your video library - list, create, update, delete, and download videos. Includes comprehensive filtering by category, monetization status, dates, and more.

Example prompts:

  • "Show me all videos in the Action genre"
  • "Find subscription-required videos updated this week"
  • "Create a new video called 'Product Demo 2025'"
  • "Update the description for video ID abc123"
  • "Get download URL for my latest video"

6 Tools

list_videos

List videos from your Zype library with comprehensive filtering.

More details
**FILTERING STRATEGY - Use precise filters over text search:**
- For category-based queries (e.g., "SNL videos", "premium content", "action movies"):
  → Use `category` filter: {"category": {"YouTube Channel": "Saturday Night Live"}}
  → First call list_categories to see available category names and values
- For monetization queries (e.g., "subscription videos", "free content"):
  → Use monetization filters: subscription_required, pass_required, purchase_required
- For series/episodic content:
  → Use series_id, season, episode filters
- For batch operations on known videos:
  → Use `id` array filter instead of searching
- Use `q` (text search) only for fuzzy title/description matching when exact filters don't apply

**Available Filters:**
- Pagination: page, per_page (max 500)
- Text search: q (searches title, source_id, zobject title - use as last resort)
- Status: active, on_air, featured, mature_content, friendly_title, keyword
- Dates: created_at_gte/lte, published_at_gte/lte, updated_at_gte/lte
- Monetization: subscription_required, pass_required, rental_required, purchase_required
- Categories: category object (e.g., {"Genre": "Action", "Premium": "true"})
- Series: series_id, season
- Source: source_id, dpt_enabled, country
- External IDs: youtube_id, vimeo_id, crunchyroll_id, hulu_id
- Batch: id (array of video IDs)

Parameters

active string optional

Filter by active status

"true" | "false" | "all"
category object optional

Filter by category values (e.g., {"Premium": "true", "Genre": "Action"})

country string optional

Filter by country code

created_at_gte string optional

Created at or after (ISO8601)

created_at_lte string optional

Created at or before (ISO8601)

crunchyroll_id string optional

Filter by Crunchyroll ID

dpt_enabled boolean optional

Filter by Dynamic Player Technology

featured boolean optional

Filter featured videos

friendly_title string optional

Filter by URL slug (exact match)

hulu_id string optional

Filter by Hulu ID

id array<string> optional

Filter by specific video IDs (batch lookup)

keyword string optional

Filter by keyword/tag

mature_content boolean optional

Filter mature content

on_air boolean optional

Filter by on-air/broadcasting status

order string optional

Sort order

"asc" | "desc"
page number optional

Page number (default: 1)

pass_required boolean optional

Filter pass-gated videos

per_page number optional

Results per page (default: 10, max: 500)

published_at_gte string optional

Published at or after (ISO8601)

published_at_lte string optional

Published at or before (ISO8601)

purchase_required boolean optional

Filter purchasable videos

q string optional

Search query (searches title, source_id, id, zobject title)

rental_required boolean optional

Filter rental videos

season number optional

Filter by season number

series_id string optional

Filter by series ID

sort string optional

Field to sort by (created_at, published_at, title, updated_at)

source_id string optional

Filter by video source ID

subscription_required boolean optional

Filter subscription-gated videos

updated_at_gte string optional

Updated at or after (ISO8601) - for sync/delta

updated_at_lte string optional

Updated at or before (ISO8601)

vimeo_id string optional

Filter by Vimeo ID

youtube_id string optional

Filter by YouTube ID

zobject_id string optional

Filter by zobject association

get_video

Get comprehensive metadata for a video including status, scheduling, monetization, series info, categories, and external IDs.

Parameters

video_id string required

The unique ID of the video

create_video

Create a new video record with full metadata support. Supports:

More details
- Basic metadata (title, description, keywords)
- Status flags (active, featured, on_air, mature_content)
- Scheduling (published_at, enable_at, disable_at, on_air_at, off_air_at)
- Series/Episode (series_id, season, episode)
- Localization (country, language)
- Classification (genre, rating, parental_guidelines_rating)
- Monetization (subscription_required, purchase_price, rental_price, plan_ids)
- Categories via array: [{"title": "Premium", "value": ["true"]}]
- AI features (transcriptions_enabled)
- External IDs (youtube_id, vimeo_id, etc.)

This creates the metadata record. Add video sources separately.

Parameters

title string required

Video title (required)

active boolean optional

Active in library

categories array<object> optional

Category assignments. Omit `id` to add a new entry; pass the existing entry id from get_video to update an existing one. Example add: [{"category_id": "6439b285101efc0001a067aa", "value": ["true"]}]

country string optional

Country code (e.g., "US")

description string optional

Full description

disable_at string optional

Auto-disable date (ISO8601)

enable_at string optional

Auto-enable date (ISO8601)

episode number optional

Episode number

featured boolean optional

Featured/highlighted

friendly_title string optional

URL-friendly slug

genre string optional

Genre

keywords array<string> optional

Keywords/tags

language string optional

Language code (e.g., "en")

mature_content boolean optional

Contains mature content

on_air boolean optional

Currently broadcasting

ott_description string optional

OTT-specific description

published_at string optional

Publish date (ISO8601)

purchase_price string optional

Purchase price

purchase_required boolean optional

Require purchase

rating string optional

Content rating

rental_duration number optional

Rental duration (hours)

rental_price string optional

Rental price

rental_required boolean optional

Require rental

season number optional

Season number

series_id string optional

Series ID for episodic content

short_description string optional

Short description for listings

subscription_required boolean optional

Require subscription

transcriptions_enabled boolean optional

Enable AI transcription

update_video

Update a video's metadata. Only provided fields are updated. Supports all fields from create_video plus:

More details
- To add a category: provide categories array with {category_id, value} objects (call list_categories first to get the category_id). Omit `id` when adding.
- To update an existing category entry: include the entry's `id` (from get_video) along with category_id and value. Without `id`, you'll create a duplicate entry.
- To schedule auto-enable/disable: use enable_at, disable_at
- To set monetization: subscription_required, purchase_price, etc.
- To link to series: series_id, season, episode

Example add: {"video_id": "...", "categories": [{"category_id": "6439b285101efc0001a067aa", "value": ["true"]}]}
Example update existing: {"video_id": "...", "categories": [{"id": "<entry id from get_video>", "category_id": "6439b285101efc0001a067aa", "value": ["false"]}]}

Parameters

video_id string required

Video ID to update (required)

active boolean optional

Active status

categories array<object> optional

Category assignments. Omit `id` to add a new entry; pass the existing entry id from get_video to update an existing one. Example add: [{"category_id": "6439b285101efc0001a067aa", "value": ["true"]}]

country string optional

Country code

custom_attributes object optional

Custom key-value attributes

description string optional

Full description

disable_at string optional

Auto-disable date

enable_at string optional

Auto-enable date

episode number optional

Episode number

featured boolean optional

Featured status

friendly_title string optional

URL slug

genre string optional

Genre

keywords array<string> optional

Keywords/tags

language string optional

Language code

mature_content boolean optional

Mature content flag

off_air_at string optional

Scheduled on-air end

on_air boolean optional

On-air status

on_air_at string optional

Scheduled on-air start

ott_description string optional

OTT description

parental_guidelines_rating string optional

Parental rating

pass_required boolean optional

Require pass

plan_ids array<string> optional

Plan IDs granting access

published_at string optional

Publish date (ISO8601)

purchase_price string optional

Purchase price

purchase_required boolean optional

Require purchase

rating string optional

Content rating

rental_duration number optional

Rental duration (hours)

rental_price string optional

Rental price

rental_required boolean optional

Require rental

season number optional

Season number

series_id string optional

Series ID

short_description string optional

Short description

subscription_ads_enabled boolean optional

Show ads for subscribers

subscription_required boolean optional

Require subscription

title string optional

Video title

transcriptions_enabled boolean optional

AI transcription

delete_video

Permanently delete a video from Zype. This action cannot be undone.

Parameters

video_id string required

The unique ID of the video to delete (required)

confirm boolean optional

Set to true to confirm deletion (required in safe mode)

download_video

Get the mezzanine/source file download URL for a video. Returns { url, filesize } when the original source file is available. Returns an error if no mezzanine file exists (e.g., for YouTube-sourced videos).

Parameters

video_id string required

The unique ID of the video (required)

📝 Transcriptions

AI-powered transcription and translation. Transcribe video audio to text and translate to multiple languages. Operations are async - check status after initiating.

Example prompts:

  • "Transcribe video abc123"
  • "Translate video abc123 to Spanish"
  • "List all transcriptions for my product video"
  • "What languages can I translate to?"
  • "Get the full transcript for video abc123"

5 Tools

list_transcriptions

List all transcriptions and translations for a video.

More details
Returns both original transcriptions and any translations, with their status (pending, processing, completed, failed).
Use this to check the status of async transcription/translation operations.

Parameters

video_id string required

The video ID to list transcriptions for (required)

page number optional

Page number (default: 1)

per_page number optional

Results per page (default: 10, max: 500)

get_transcription

Get a single transcription or translation with full details.

More details
Returns complete text content and download URLs for SRT/VTT subtitle files.
Use the transcription_id from list_transcriptions.

Parameters

transcription_id string required

The transcription ID (required)

video_id string required

The video ID (required)

transcribe_video

Initiate AI transcription for a video.

More details
**IMPORTANT:** This is an ASYNC operation. The transcription processes in the background.
- Returns immediately with a pending status
- Use list_transcriptions or get_transcription to check progress
- Video must have a playable source file (mezzanine)
- Once complete, provides full text and SRT/VTT download URLs

Parameters

video_id string required

The video ID to transcribe (required)

translate_video

Initiate AI translation for a video to a target language.

More details
**IMPORTANT:** This is an ASYNC operation. The translation processes in the background.
- Requires an existing transcription (transcribe first if none exists)
- Use list_translation_languages to see available target languages
- Use list_transcriptions or get_transcription to check progress
- Once complete, provides translated text and SRT/VTT download URLs

Parameters

language string required

Target language code, e.g., "es", "fr", "de" (required). Use list_translation_languages to see options.

video_id string required

The video ID to translate (required)

list_translation_languages

List available translation languages for a video. Returns language codes that can be used with translate_video.

Parameters

video_id string required

The video ID (required)

📺 Program Guides

Manage EPG (electronic program guide) schedules - named, time-zoned guides synced from a source URL, each with scheduled entries. List, create, update, delete guides and browse their entries.

Example prompts:

  • "List all program guides"
  • "Create a program guide called 'Channel 1 EPG' synced from this URL in America/New_York"
  • "Show me the entries in program guide abc123 for today"
  • "Update the time zone for program guide abc123"

6 Tools

list_program_guides

List program guides (EPG schedules) in your Zype library, with optional search, sorting, and pagination.

Parameters

order string optional

Sort order

"asc" | "desc"
page number optional

Page number (default: 1)

per_page number optional

Results per page (default: 10, max: 500)

q string optional

Search query

sort string optional

Field to sort by

get_program_guide

Get detailed information about a specific program guide by its ID, including associated videos.

Parameters

program_guide_id string required

The unique ID of the program guide (required)

create_program_guide

Create a new program guide (EPG schedule). Provide a name, a source URL for syncing content, language(s), and a time zone.

Parameters

language undefined required

Language code(s), e.g. 'en' or ['en', 'fr']

name string required

Name of the program guide (required)

time_zone string required

Time zone, e.g. 'America/New_York' (required)

url string required

Source URL for syncing guide content (required)

video_ids array<string> optional

Video IDs to associate with the guide

update_program_guide

Update an existing program guide. Only the fields you provide are changed.

Parameters

program_guide_id string required

The unique ID of the program guide to update (required)

language undefined optional

Language code(s), e.g. 'en' or ['en', 'fr']

name string optional

New name

time_zone string optional

New time zone

url string optional

New source URL

video_ids array<string> optional

New set of associated video IDs

delete_program_guide

Permanently delete a program guide from Zype. This action cannot be undone.

Parameters

program_guide_id string required

The unique ID of the program guide to delete (required)

confirm boolean optional

Set to true to confirm deletion (required in safe mode)

list_program_guide_entries

List the entries (scheduled programs) within a program guide.

More details
Each entry has a title, description, and start/end times. Filter by title, search query, or a start_time/end_time window (ISO8601 or Unix timestamps).

Parameters

program_guide_id string required

The program guide ID to list entries for (required)

disable_pagination boolean optional

Return all entries without pagination

end_time string optional

Filter by end_time (ISO8601 or Unix timestamp)

order string optional

Sort order

"asc" | "desc"
page number optional

Page number (default: 1)

per_page number optional

Results per page (default: 10, max: 500)

q string optional

Search query

sort string optional

Field to sort by

start_time string optional

Filter by start_time (ISO8601 or Unix timestamp)

title string optional

Filter by entry title

📋 Playlists

Organize content into playlists. Create curated collections, manage video ordering, and build dynamic content experiences.

Example prompts:

  • "Create a playlist called 'Best of 2025'"
  • "Add these 5 videos to the Featured playlist"
  • "Show me all videos in the Tutorials playlist"
  • "Remove the intro video from the Getting Started playlist"

8 Tools

list_playlists

List playlists from your Zype library with pagination and filters.

Parameters

active string optional

Filter by active status

"true" | "false" | "all"
friendly_title string optional

Filter by friendly title (slug)

order string optional

Sort order

"asc" | "desc"
page number optional

Page number (default: 1)

per_page number optional

Results per page (default: 10, max: 500)

q string optional

Search by keyword

sort string optional

Field to sort by

title string optional

Filter by title

get_playlist

Get detailed information about a specific playlist by its ID.

Parameters

playlist_id string required

The unique ID of the playlist

create_playlist

Create a new playlist in Zype.

Parameters

title string required

Title of the playlist (required)

active boolean optional

Whether the playlist is active (default: true)

categories array<object> optional

Assign category values. Omit `id` to add a new entry; pass the existing entry id (from get_playlist) to update an existing one.

description string optional

Description of the playlist

friendly_title string optional

URL-friendly title (slug)

match_type string optional

For category playlists: match all or any of the specified category values (default: all)

"all" | "any"
parent_id string optional

Parent playlist ID for nested playlists

playlist_type string optional

Playlist type: manual (hand-picked videos) or category (dynamic playlist based on category values)

"manual" | "category"
priority number optional

Priority for ordering

update_playlist

Update an existing playlist's metadata.

Parameters

playlist_id string required

The unique ID of the playlist to update (required)

active boolean optional

Set active status

categories array<object> optional

Update category values. Omit `id` to add a new entry; pass the existing entry id (from get_playlist) to update an existing one.

description string optional

New description

friendly_title string optional

New URL-friendly title

match_type string optional

For category playlists: match all or any of the specified category values

"all" | "any"
playlist_type string optional

Change playlist type: manual or category

"manual" | "category"
priority number optional

New priority

title string optional

New title

delete_playlist

Permanently delete a playlist from Zype. This action cannot be undone.

Parameters

playlist_id string required

The unique ID of the playlist to delete (required)

confirm boolean optional

Set to true to confirm deletion (required in safe mode)

list_playlist_videos

List all videos in a specific playlist.

Parameters

playlist_id string required

The unique ID of the playlist (required)

page number optional

Page number

per_page number optional

Results per page

add_videos_to_playlist

Add one or more videos to a playlist.

Parameters

playlist_id string required

The unique ID of the playlist (required)

video_ids array<string> required

Array of video IDs to add (required)

remove_videos_from_playlist

Remove one or more videos from a playlist.

Parameters

playlist_id string required

The unique ID of the playlist (required)

video_ids array<string> required

Array of video IDs to remove (required)

🏷️ Categories

Organize videos with custom categories like Genre, Premium status, or any attribute. Categories enable powerful filtering and content organization.

Example prompts:

  • "List all categories and their values"
  • "Create a new category called 'Content Type' with values Tutorial, Demo, Interview"
  • "What categories can I filter videos by?"

5 Tools

list_categories

List all categories in your Zype library. **Call this FIRST when filtering videos by category.**

More details
Categories organize videos by attributes like Genre, Premium status, YouTube Channel, etc.
Each category has a title and list of possible values.

**Workflow for category-based video queries:**
1. Call list_categories to see available category titles and their values
2. Use list_videos with category filter: {"category": {"CategoryTitle": "value"}}

Example: To find "Saturday Night Live" videos:
1. list_categories → shows "YouTube Channel" category with "Saturday Night Live" as a value
2. list_videos with {"category": {"YouTube Channel": "Saturday Night Live"}}

Parameters

friendly_title string optional

Filter by friendly title (slug)

order string optional

Sort order

"asc" | "desc"
page number optional

Page number (default: 1)

per_page number optional

Results per page (default: 10, max: 500)

sort string optional

Field to sort by

title string optional

Filter by title

get_category

Get detailed information about a specific category by its ID.

Parameters

category_id string required

The unique ID of the category

create_category

Create a new category in Zype. Categories help organize videos by attributes like genre, season, etc.

Parameters

title string required

Title of the category (required)

friendly_title string optional

URL-friendly title (slug)

values array<string> optional

Array of possible values for this category

update_category

Update an existing category.

Parameters

category_id string required

The unique ID of the category to update (required)

friendly_title string optional

New URL-friendly title

title string optional

New title

values array<string> optional

New array of possible values

delete_category

Permanently delete a category from Zype. This action cannot be undone.

Parameters

category_id string required

The unique ID of the category to delete (required)

confirm boolean optional

Set to true to confirm deletion (required in safe mode)

💬 Subtitles

Manage subtitles and captions for accessibility. Create, update, and organize subtitle files for your videos.

Example prompts:

  • "List all subtitles for video abc123"
  • "Add Spanish subtitles to my product video"
  • "Create a subtitle playlist for HLS streaming"

7 Tools

list_subtitles

List all subtitles for a specific video.

Parameters

video_id string required

The video ID to list subtitles for (required)

page number optional

Page number (default: 1)

per_page number optional

Results per page (default: 10, max: 500)

get_subtitle

Get detailed information about a specific subtitle.

Parameters

subtitle_id string required

The unique ID of the subtitle (required)

video_id string required

The video ID (required)

create_subtitle

Create/add a new subtitle for a video.

Parameters

language string required

Language code, e.g., "en", "es", "fr" (required)

video_id string required

The video ID to add subtitle to (required)

active boolean optional

Whether the subtitle is active (default: true)

url string optional

URL to the subtitle file (SRT, VTT)

update_subtitle

Update an existing subtitle.

Parameters

subtitle_id string required

The unique ID of the subtitle to update (required)

video_id string required

The video ID (required)

active boolean optional

Set active status

language string optional

New language code

url string optional

New URL to the subtitle file

create_subtitle_playlist

Create a subtitle playlist for HLS streaming. This generates segmented subtitle files.

Parameters

subtitle_id string required

The subtitle ID (required)

video_id string required

The video ID (required)

delete_subtitle_playlist

Delete a subtitle playlist.

Parameters

subtitle_id string required

The subtitle ID (required)

video_id string required

The video ID (required)

confirm boolean optional

Set to true to confirm deletion (required in safe mode)

delete_subtitle

Permanently delete a subtitle from a video. This action cannot be undone.

Parameters

subtitle_id string required

The subtitle ID to delete (required)

video_id string required

The video ID (required)

confirm boolean optional

Set to true to confirm deletion (required in safe mode)

📊 Analytics

Query performance data including plays, viewers, watch time, and revenue. Use analytics to make data-driven content decisions.

Example prompts:

  • "What are my top 10 most-watched videos this month?"
  • "Show viewer trends for the last 30 days"
  • "Which videos have the highest engagement?"
  • "Show subscription revenue by month"

8 Tools

get_plays

Get video play counts - how many times content was played.

More details
USAGE:
- By video: group_by=["video_id"] or group_by=["video_id","video_title"]
- By country: group_by=["country"]
- By platform: group_by=["platform"]
- Daily trend: interval="day"
- For specific video: video_id="..."

SORTING: Use sort_by (e.g., "day_desc", "video_id_asc"). NOTE: Cannot sort by play count - for "top N videos by plays", fetch with group_by=["video_id"] and sort results client-side.

Data limited to last 90 days. Defaults to last 2 weeks if no dates specified.

Parameters

country string optional

Filter by country code (e.g., "US", "GB", "CA")

group_by array<string> optional

Group results by fields. Options: video_id, video_title, playlist_id, playlist_name, platform, consumer_id, country, domain, app_id, app_name, content_type

interval string optional

Time interval for grouping data (default: day)

"hour" | "day" | "month"
limit number optional

Max results to return (default: 200, max: 500)

offset number optional

Offset for pagination

platform string optional

Filter by platform (e.g., "ios", "android", "web", "roku")

playlist_id string optional

Filter by playlist ID

sort_by string optional

Sort by field+direction. Default: day_desc. NOTE: Cannot sort by metric value - for top N by plays/views, fetch all and sort client-side.

"day_desc" | "day_asc" | "hour_desc" | "hour_asc" | "month_desc" | "month_asc" | "video_id_desc" | "video_id_asc" | "video_title_desc" | "video_title_asc" | "platform_desc" | "platform_asc" | "country_desc" | "country_asc" | "playlist_id_desc" | "playlist_id_asc"
start_date_gte string optional

Start date filter (YYYY-MM-DD). Max 90 days ago. Defaults to 2 weeks ago.

start_date_lte string optional

End date filter (YYYY-MM-DD). Defaults to today.

video_id string optional

Filter by specific video ID

get_viewers

Get unique viewer counts over time.

More details
USAGE:
- By video: group_by=["video_id","video_title"]
- By country: group_by=["country"]
- Daily trend: interval="day"

SORTING: Use sort_by (e.g., "day_desc"). Cannot sort by viewer count.

Data limited to last 90 days.

Parameters

country string optional

Filter by country code (e.g., "US", "GB", "CA")

group_by array<string> optional

Group results by fields. Options: video_id, video_title, playlist_id, playlist_name, platform, consumer_id, country, domain, app_id, app_name, content_type

interval string optional

Time interval for grouping data (default: day)

"hour" | "day" | "month"
limit number optional

Max results to return (default: 200, max: 500)

offset number optional

Offset for pagination

platform string optional

Filter by platform (e.g., "ios", "android", "web", "roku")

playlist_id string optional

Filter by playlist ID

sort_by string optional

Sort by field+direction. Default: day_desc. NOTE: Cannot sort by metric value - for top N by plays/views, fetch all and sort client-side.

"day_desc" | "day_asc" | "hour_desc" | "hour_asc" | "month_desc" | "month_asc" | "video_id_desc" | "video_id_asc" | "video_title_desc" | "video_title_asc" | "platform_desc" | "platform_asc" | "country_desc" | "country_asc" | "playlist_id_desc" | "playlist_id_asc"
start_date_gte string optional

Start date filter (YYYY-MM-DD). Max 90 days ago. Defaults to 2 weeks ago.

start_date_lte string optional

End date filter (YYYY-MM-DD). Defaults to today.

video_id string optional

Filter by specific video ID

get_hours_watched

Get total hours of content watched.

More details
USAGE:
- By video: group_by=["video_id","video_title"]
- By platform: group_by=["platform"]
- Daily trend: interval="day"

SORTING: Use sort_by (e.g., "day_desc"). Cannot sort by hours watched.

Data limited to last 90 days.

Parameters

country string optional

Filter by country code (e.g., "US", "GB", "CA")

group_by array<string> optional

Group results by fields. Options: video_id, video_title, playlist_id, playlist_name, platform, consumer_id, country, domain, app_id, app_name, content_type

interval string optional

Time interval for grouping data (default: day)

"hour" | "day" | "month"
limit number optional

Max results to return (default: 200, max: 500)

offset number optional

Offset for pagination

platform string optional

Filter by platform (e.g., "ios", "android", "web", "roku")

playlist_id string optional

Filter by playlist ID

sort_by string optional

Sort by field+direction. Default: day_desc. NOTE: Cannot sort by metric value - for top N by plays/views, fetch all and sort client-side.

"day_desc" | "day_asc" | "hour_desc" | "hour_asc" | "month_desc" | "month_asc" | "video_id_desc" | "video_id_asc" | "video_title_desc" | "video_title_asc" | "platform_desc" | "platform_asc" | "country_desc" | "country_asc" | "playlist_id_desc" | "playlist_id_asc"
start_date_gte string optional

Start date filter (YYYY-MM-DD). Max 90 days ago. Defaults to 2 weeks ago.

start_date_lte string optional

End date filter (YYYY-MM-DD). Defaults to today.

video_id string optional

Filter by specific video ID

get_view_time

Get average view time and completion metrics.

More details
USAGE:
- By video: group_by=["video_id","video_title"]
- By platform: group_by=["platform"]
- Daily trend: interval="day"

SORTING: Use sort_by (e.g., "day_desc"). Cannot sort by view time value.

Data limited to last 90 days.

Parameters

country string optional

Filter by country code (e.g., "US", "GB", "CA")

group_by array<string> optional

Group results by fields. Options: video_id, video_title, playlist_id, playlist_name, platform, consumer_id, country, domain, app_id, app_name, content_type

interval string optional

Time interval for grouping data (default: day)

"hour" | "day" | "month"
limit number optional

Max results to return (default: 200, max: 500)

offset number optional

Offset for pagination

platform string optional

Filter by platform (e.g., "ios", "android", "web", "roku")

playlist_id string optional

Filter by playlist ID

sort_by string optional

Sort by field+direction. Default: day_desc. NOTE: Cannot sort by metric value - for top N by plays/views, fetch all and sort client-side.

"day_desc" | "day_asc" | "hour_desc" | "hour_asc" | "month_desc" | "month_asc" | "video_id_desc" | "video_id_asc" | "video_title_desc" | "video_title_asc" | "platform_desc" | "platform_asc" | "country_desc" | "country_asc" | "playlist_id_desc" | "playlist_id_asc"
start_date_gte string optional

Start date filter (YYYY-MM-DD). Max 90 days ago. Defaults to 2 weeks ago.

start_date_lte string optional

End date filter (YYYY-MM-DD). Defaults to today.

video_id string optional

Filter by specific video ID

list_stream_hours

Get total streaming/delivery hours across the platform.

More details
USAGE:
- By video: group_by=["video_id","video_title"]
- Daily trend: interval="day"

Data limited to last 90 days.

Parameters

country string optional

Filter by country code

group_by array<string> optional

Group by fields: video_id, video_title, country, platform

interval string optional

Time interval for grouping data (default: day)

"hour" | "day" | "month"
limit number optional

Max results to return (default: 200, max: 500)

offset number optional

Offset for pagination

platform string optional

Filter by platform

sort_by string optional

Sort by field+direction. Default: day_desc. NOTE: Cannot sort by metric value - for top N by plays/views, fetch all and sort client-side.

"day_desc" | "day_asc" | "hour_desc" | "hour_asc" | "month_desc" | "month_asc" | "video_id_desc" | "video_id_asc" | "video_title_desc" | "video_title_asc" | "platform_desc" | "platform_asc" | "country_desc" | "country_asc" | "playlist_id_desc" | "playlist_id_asc"
start_date_gte string optional

Start date filter (YYYY-MM-DD). Max 90 days ago. Defaults to 2 weeks ago.

start_date_lte string optional

End date filter (YYYY-MM-DD). Defaults to today.

video_id string optional

Filter by video ID

list_player_requests

Get video player load/request counts.

More details
USAGE:
- By video: group_by=["video_id","video_title"]
- Daily trend: interval="day"
- By platform: group_by=["platform"]

Data limited to last 90 days.

Parameters

country string optional

Filter by country code

group_by array<string> optional

Group by fields: video_id, video_title, country, platform

interval string optional

Time interval for grouping data (default: day)

"hour" | "day" | "month"
limit number optional

Max results to return (default: 200, max: 500)

offset number optional

Offset for pagination

platform string optional

Filter by platform

sort_by string optional

Sort by field+direction. Default: day_desc. NOTE: Cannot sort by metric value - for top N by plays/views, fetch all and sort client-side.

"day_desc" | "day_asc" | "hour_desc" | "hour_asc" | "month_desc" | "month_asc" | "video_id_desc" | "video_id_asc" | "video_title_desc" | "video_title_asc" | "platform_desc" | "platform_asc" | "country_desc" | "country_asc" | "playlist_id_desc" | "playlist_id_asc"
start_date_gte string optional

Start date filter (YYYY-MM-DD). Max 90 days ago. Defaults to 2 weeks ago.

start_date_lte string optional

End date filter (YYYY-MM-DD). Defaults to today.

video_id string optional

Filter by video ID

list_new_subscriptions

Get new subscription sign-up counts.

More details
USAGE:
- By plan: group_by=["plan_id","plan_name"]
- Daily trend: interval="day"
- By country: group_by=["country"]

SORTING: Cannot sort by subscription count.

Data limited to last 90 days.

Parameters

country string optional

Filter by country code (e.g., "US", "GB")

group_by array<string> optional

Group results by fields. Options: plan_id, plan_name, country, platform

interval string optional

Time interval for grouping data (default: day)

"hour" | "day" | "month"
limit number optional

Max results to return (default: 200, max: 500)

offset number optional

Offset for pagination

plan_id string optional

Filter by subscription plan ID

platform string optional

Filter by platform

sort_by string optional

Sort by field+direction. Default: day_desc. NOTE: Cannot sort by metric value - for top N by plays/views, fetch all and sort client-side.

"day_desc" | "day_asc" | "hour_desc" | "hour_asc" | "month_desc" | "month_asc" | "video_id_desc" | "video_id_asc" | "video_title_desc" | "video_title_asc" | "platform_desc" | "platform_asc" | "country_desc" | "country_asc" | "playlist_id_desc" | "playlist_id_asc"
start_date_gte string optional

Start date filter (YYYY-MM-DD). Max 90 days ago. Defaults to 2 weeks ago.

start_date_lte string optional

End date filter (YYYY-MM-DD). Defaults to today.

list_subscription_revenue

Get subscription revenue data.

More details
USAGE:
- By plan: group_by=["plan_id","plan_name"]
- Daily trend: interval="day"
- By country: group_by=["country"]

SORTING: Cannot sort by revenue amount.

Data limited to last 90 days.

Parameters

country string optional

Filter by country code (e.g., "US", "GB")

group_by array<string> optional

Group results by fields. Options: plan_id, plan_name, country, platform

interval string optional

Time interval for grouping data (default: day)

"hour" | "day" | "month"
limit number optional

Max results to return (default: 200, max: 500)

offset number optional

Offset for pagination

plan_id string optional

Filter by subscription plan ID

platform string optional

Filter by platform

sort_by string optional

Sort by field+direction. Default: day_desc. NOTE: Cannot sort by metric value - for top N by plays/views, fetch all and sort client-side.

"day_desc" | "day_asc" | "hour_desc" | "hour_asc" | "month_desc" | "month_asc" | "video_id_desc" | "video_id_asc" | "video_title_desc" | "video_title_asc" | "platform_desc" | "platform_asc" | "country_desc" | "country_asc" | "playlist_id_desc" | "playlist_id_asc"
start_date_gte string optional

Start date filter (YYYY-MM-DD). Max 90 days ago. Defaults to 2 weeks ago.

start_date_lte string optional

End date filter (YYYY-MM-DD). Defaults to today.

💰 Monetization

Manage subscriptions, plans, transactions, redemption codes, ad tags, and revenue models. Complete control over your monetization strategy.

Example prompts:

  • "List all active subscription plans"
  • "Show recent transactions"
  • "How many new subscriptions this month?"
  • "List all ad tags"

22 Tools

list_subscriptions

List subscriptions with optional filtering by plan, consumer, or payment provider.

Parameters

consumer_id string optional

Filter by consumer ID

order string optional

Sort order

"asc" | "desc"
page number optional

Page number (default: 1)

payment_provider string optional

Filter by payment provider

"stripe" | "braintree" | "recurly" | "redemption" | "third_party" | "amazon_fire" | "google_play" | "itunes" | "samsung" | "tizen" | "roku"
per_page number optional

Results per page (default: 10, max: 500)

plan_id string optional

Filter by plan ID

q string optional

Search by keyword

sort string optional

Field to sort by

get_subscription

Get detailed information about a specific subscription.

Parameters

subscription_id string required

The subscription ID

create_subscription

Create a new subscription for a consumer.

Parameters

consumer_id string required

ID of the consumer

plan_id string required

ID of the subscription plan

coupon_code string optional

Coupon code to apply

trial_period_days number optional

Trial period in days

cancel_subscription

Cancel an existing subscription.

Parameters

subscription_id string required

The subscription ID to cancel

list_plans

List subscription plans with optional filtering.

Parameters

active boolean optional

Filter by active status

interval string optional

Filter by billing interval

"month" | "year"
order string optional

Sort order

"asc" | "desc"
page number optional

Page number (default: 1)

per_page number optional

Results per page

q string optional

Search by keyword

sort string optional

Field to sort by

get_plan

Get detailed information about a specific subscription plan.

Parameters

plan_id string required

The plan ID

create_plan

Create a new subscription plan.

Parameters

amount string required

Plan price (e.g., "9.99")

interval string required

Billing interval

"month" | "year"
name string required

Plan name

active boolean optional

Whether the plan is active

currency string optional

Currency code (default: USD)

description string optional

Plan description

interval_count number optional

Number of intervals (default: 1)

trial_period_days number optional

Trial period in days

update_plan

Update an existing subscription plan.

Parameters

plan_id string required

The plan ID to update

active boolean optional

Set active status

amount string optional

New price

description string optional

New description

name string optional

New plan name

delete_plan

Delete a subscription plan.

Parameters

plan_id string required

The plan ID to delete

list_transactions

List transactions with optional filtering by consumer, video, or type.

Parameters

consumer_id string optional

Filter by consumer ID

order string optional

Sort order

"asc" | "desc"
page number optional

Page number (default: 1)

per_page number optional

Results per page

playlist_id string optional

Filter by playlist ID

q string optional

Search by keyword

sort string optional

Field to sort by

transaction_type string optional

Filter by transaction type

"purchase" | "rental" | "pass"
video_id string optional

Filter by video ID

get_transaction

Get detailed information about a specific transaction.

Parameters

transaction_id string required

The transaction ID

create_transaction

Create a new transaction (purchase, rental, or pass).

Parameters

amount string required

Transaction amount (e.g., "4.99")

consumer_id string required

ID of the consumer

transaction_type string required

Type of transaction

"purchase" | "rental" | "pass"
currency string optional

Currency code (default: USD)

expires_at string optional

Expiration date for rentals (ISO8601)

playlist_id string optional

Playlist ID for playlist transactions

video_id string optional

Video ID for video transactions

list_redemption_codes

List redemption codes with optional filtering by plan, video, or redemption status.

Parameters

expired boolean optional

Filter by expired status

page number optional

Page number (default: 1)

per_page number optional

Results per page

plan_id string optional

Filter by plan ID

playlist_id string optional

Filter by playlist ID

redeemed boolean optional

Filter by redeemed status

video_id string optional

Filter by video ID

get_redemption_code

Get detailed information about a specific redemption code.

Parameters

code_id string required

The redemption code ID

create_redemption_codes

Generate new redemption codes for subscriptions, videos, playlists, or passes.

Parameters

content_type string required

Type of content the code unlocks

"subscription" | "video" | "playlist" | "pass"
expiration_date string optional

Expiration date (YYYY-MM-DD)

plan_id string optional

Plan ID for subscription codes

playlist_id string optional

Playlist ID for playlist codes

quantity number optional

Number of codes to generate (default: 1, max: 100)

video_id string optional

Video ID for video codes

list_ad_tags

List ad tags (VAST/VMAP) configured for your account.

Parameters

active boolean optional

Filter by active status

page number optional

Page number (default: 1)

per_page number optional

Results per page

get_ad_tag

Get detailed information about a specific ad tag.

Parameters

ad_tag_id string required

The ad tag ID

create_ad_tag

Create a new VAST/VMAP ad tag.

Parameters

name string required

Ad tag name

tag string required

The VAST/VMAP ad tag URL

active boolean optional

Whether the ad tag is active (default: true)

scope string optional

Ad tag scope

"library" | "video" | "playlist"
vmap boolean optional

Whether this is a VMAP tag

update_ad_tag

Update an existing ad tag.

Parameters

ad_tag_id string required

The ad tag ID to update

active boolean optional

Set active status

name string optional

New name

tag string optional

New ad tag URL

delete_ad_tag

Delete an ad tag.

Parameters

ad_tag_id string required

The ad tag ID to delete

list_revenue_models

List available revenue models (AVOD, SVOD, TVOD, etc.).

Parameters

page number optional

Page number (default: 1)

per_page number optional

Results per page

get_revenue_model

Get detailed information about a specific revenue model.

Parameters

revenue_model_id string required

The revenue model ID

🧩 Zobjects

Custom metadata objects for advanced content modeling. Create custom types like Actors, Directors, Series, or any structured data and associate them with videos.

Example prompts:

  • "List all zobject types"
  • "Create a new Actor zobject for Tom Hanks"
  • "Associate the Director zobject with these videos"
  • "Find all videos linked to the Marvel zobject"

16 Tools

list_zobject_types

List all zobject types in your Zype library. Zobject types define custom metadata schemas (e.g., actors, directors, genres).

Parameters

order string optional

Sort order

"asc" | "desc"
page number optional

Page number (default: 1)

per_page number optional

Results per page (default: 10, max: 500)

q string optional

Filter by keyword

sort string optional

Field to sort by

get_zobject_type

Get detailed information about a specific zobject type, including its custom attributes.

Parameters

zobject_type_id string required

The unique ID of the zobject type

create_zobject_type

Create a new zobject type (custom metadata schema). Define custom attributes for your content metadata like actors, directors, etc.

Parameters

title string required

Title of the zobject type (must be unique, required)

description string optional

Description of the zobject type

playlists_enabled boolean optional

Allow associating playlists with zobjects of this type (default: false)

videos_enabled boolean optional

Allow associating videos with zobjects of this type (default: true)

zobject_attributes_attributes array<object> optional

Custom attributes/fields for this zobject type

update_zobject_type

Update an existing zobject type.

Parameters

zobject_type_id string required

The unique ID of the zobject type to update (required)

description string optional

New description

playlists_enabled boolean optional

Allow associating playlists

title string optional

New title

videos_enabled boolean optional

Allow associating videos

zobject_attributes_attributes array<object> optional

Updated custom attributes (replaces existing)

delete_zobject_type

Permanently delete a zobject type. This action cannot be undone and may affect associated zobjects.

Parameters

zobject_type_id string required

The unique ID of the zobject type to delete (required)

confirm boolean optional

Set to true to confirm deletion (required in safe mode)

list_zobjects

List zobjects (custom metadata instances) with optional filtering by type. Returns full API response including all custom attributes defined on the zobject type (e.g., pictures, keywords, stadium info for teams, biography for actors). Custom attributes are returned as top-level fields. Examples: list all actors, directors, teams.

Parameters

active boolean optional

Filter by active status

order string optional

Sort order

"asc" | "desc"
page number optional

Page number (default: 1)

per_page number optional

Results per page (default: 10, max: 500)

q string optional

Search by keyword

sort string optional

Field to sort by

zobject_type string optional

Filter by zobject type title (e.g., "actor", "director", "teams")

zobject_type_id string optional

Filter by zobject type ID

get_zobject

Get detailed information about a specific zobject, including all custom attributes, associated videos and playlists. Returns full API response with custom attributes as top-level fields (e.g., pictures array, keywords, stadium_name, team_abbreviation, biography, etc. depending on zobject type schema).

Parameters

zobject_id string required

The unique ID of the zobject

zobject_type string required

The zobject type title (e.g., "actor", "director", "teams")

create_zobject

Create a new zobject (custom metadata instance). Must specify which zobject_type it belongs to.

Parameters

title string required

Title of the zobject (required)

zobject_type_id string required

ID of the zobject type this zobject belongs to (required)

active boolean optional

Whether the zobject is active (default: true)

custom object optional

Custom attributes as key-value pairs

description string optional

Description

friendly_title string optional

URL-friendly title (slug)

playlist_ids array<string> optional

Array of playlist IDs to associate

video_ids array<string> optional

Array of video IDs to associate

update_zobject

Update an existing zobject. Only provide the fields you want to change.

Parameters

zobject_id string required

The unique ID of the zobject to update (required)

zobject_type string required

The zobject type, e.g., "actor", "director" (required)

active boolean optional

Set active status

custom object optional

Update custom attributes

description string optional

New description

friendly_title string optional

New URL-friendly title

playlist_ids array<string> optional

Replace playlist associations

title string optional

New title

video_ids array<string> optional

Replace video associations

delete_zobject

Permanently delete a zobject. This action cannot be undone.

Parameters

zobject_id string required

The unique ID of the zobject to delete (required)

zobject_type string required

The zobject type, e.g., "actor", "director" (required)

confirm boolean optional

Set to true to confirm deletion (required in safe mode)

add_videos_to_zobject

Add one or more videos to a zobject (e.g., associate videos with an actor).

Parameters

video_ids array<string> required

Array of video IDs to add (required)

zobject_id string required

The unique ID of the zobject (required)

zobject_type string required

The zobject type, e.g., "actor", "director" (required)

remove_videos_from_zobject

Remove one or more videos from a zobject.

Parameters

video_ids array<string> required

Array of video IDs to remove (required)

zobject_id string required

The unique ID of the zobject (required)

zobject_type string required

The zobject type, e.g., "actor", "director" (required)

get_zobject_videos

List all videos associated with a zobject.

Parameters

zobject_id string required

The unique ID of the zobject (required)

zobject_type string required

The zobject type, e.g., "actor", "director" (required)

page number optional

Page number (default: 1)

per_page number optional

Results per page

add_playlists_to_zobject

Add one or more playlists to a zobject.

Parameters

playlist_ids array<string> required

Array of playlist IDs to add (required)

zobject_id string required

The unique ID of the zobject (required)

zobject_type string required

The zobject type, e.g., "actor", "director" (required)

remove_playlists_from_zobject

Remove one or more playlists from a zobject.

Parameters

playlist_ids array<string> required

Array of playlist IDs to remove (required)

zobject_id string required

The unique ID of the zobject (required)

zobject_type string required

The zobject type, e.g., "actor", "director" (required)

get_zobject_playlists

List all playlists associated with a zobject.

Parameters

zobject_id string required

The unique ID of the zobject (required)

zobject_type string required

The zobject type, e.g., "actor", "director" (required)

page number optional

Page number (default: 1)

per_page number optional

Results per page

📺 Series

Manage episodic shows. A series is the top-level container: "standard" series group episodes into seasons, while "limited" series attach episodes directly. Requires the series_api_enabled edge feature.

Example prompts:

  • "List all series"
  • "Create a standard series called 'The Zype Chronicles'"
  • "Show series abc123 with its seasons"
  • "Update the description for series abc123"

5 Tools

list_series

List series (shows) in your Zype library. A series is the top-level container for episodic content.

More details
Series types:
- **standard**: episodes are organized into seasons (list_seasons -> list_episodes)
- **limited**: episodes live directly on the series (list_episodes with only series_id)

Requires the 'series_api_enabled' edge feature on the site.

Parameters

active boolean optional

Filter by active status

includes array<string> optional

Embed related resources

order string optional

Sort order

"asc" | "desc"
page number optional

Page number (default: 1)

per_page number optional

Results per page (default: 10, max: 500)

q string optional

Full-text search query (title, description, keywords)

series_type string optional

Filter by series type

"standard" | "limited"
sort string optional

Field to sort by (e.g. title, created_at)

get_series

Get detailed information about a specific series by its ID. Use includes=["seasons"] to embed seasons, or includes=["episodes"] for a limited series.

Parameters

series_id string required

The unique ID of the series

includes array<string> optional

Embed related resources

create_series

Create a new series. Set series_type to 'standard' (uses seasons) or 'limited' (episodes attached directly to the series).

Parameters

title string required

Title of the series (required)

active boolean optional

Whether the series is active

description string optional

Full description

disable_at string optional

Schedule availability end (ISO 8601)

enable_at string optional

Schedule availability start (ISO 8601)

genre string optional

Genre

internal_series_id string optional

External/internal identifier used to link Videos to this series

keywords array<string> optional

Keywords/tags

languages array<string> optional

Languages

published_date string optional

Published date (ISO 8601)

region string optional

Region

release_date string optional

Release date (ISO 8601)

series_type string optional

'standard' or 'limited' (default: standard)

"standard" | "limited"
short_description string optional

Short description

url_friendly_title string optional

URL-friendly slug (auto-generated if omitted)

update_series

Update an existing series. Only provided fields are changed.

Parameters

series_id string required

The unique ID of the series to update (required)

active boolean optional

Whether the series is active

description string optional

Full description

disable_at string optional

Schedule availability end (ISO 8601)

enable_at string optional

Schedule availability start (ISO 8601)

genre string optional

Genre

internal_series_id string optional

External/internal identifier

keywords array<string> optional

Keywords/tags

languages array<string> optional

Languages

published_date string optional

Published date (ISO 8601)

region string optional

Region

release_date string optional

Release date (ISO 8601)

series_type string optional

Series type

"standard" | "limited"
short_description string optional

Short description

title string optional

New title

url_friendly_title string optional

New URL-friendly slug

delete_series

Permanently delete a series. Its seasons and episode assignments are removed; the underlying source videos are NOT deleted. This action cannot be undone.

Parameters

series_id string required

The unique ID of the series to delete (required)

confirm boolean optional

Set to true to confirm deletion (required in safe mode)

🗂️ Seasons

Manage the seasons of a standard series. Create seasons, edit their metadata, and control their display order. Season numbers are immutable once set.

Example prompts:

  • "List the seasons of series abc123"
  • "Add Season 2 to series abc123"
  • "Reorder the seasons of series abc123"
  • "Show season def456 with its episodes"

6 Tools

list_seasons

List the seasons of a series, in their configured display order. Only 'standard' series have seasons.

More details
Workflow: list_series -> list_seasons (with series_id) -> list_episodes (with series_id + season_id).

Parameters

series_id string required

The unique ID of the parent series (required)

active boolean optional

Filter by active status

includes array<string> optional

Embed episodes in each season

order string optional

Sort order

"asc" | "desc"
ordering string optional

Ordering rule (e.g. 'manual'); defaults to the series' configured rule

page number optional

Page number (default: 1)

per_page number optional

Results per page (default: 10, max: 500)

q string optional

Full-text search query

sort string optional

Field to sort by (overrides ordering)

get_season

Get detailed information about a specific season. Use includes=["episodes"] to embed its episodes.

Parameters

season_id string required

The unique ID of the season (required)

series_id string required

The unique ID of the parent series (required)

includes array<string> optional

Embed episodes in the season

create_season

Create a new season within a series. season_number is assigned automatically if omitted and is immutable once set.

Parameters

series_id string required

The unique ID of the parent series (required)

active boolean optional

Whether the season is active

description string optional

Season description

disable_at string optional

Schedule availability end (ISO 8601)

enable_at string optional

Schedule availability start (ISO 8601)

keywords array<string> optional

Keywords/tags

published_date string optional

Published date (ISO 8601)

release_date string optional

Release date (ISO 8601)

season_number number optional

Season number (auto-assigned if omitted). Immutable once set.

title string optional

Season title

update_season

Update an existing season. Only provided fields are changed. Note: season_number cannot be changed after creation.

Parameters

season_id string required

The unique ID of the season to update (required)

series_id string required

The unique ID of the parent series (required)

active boolean optional

Whether the season is active

description string optional

Season description

disable_at string optional

Schedule availability end (ISO 8601)

enable_at string optional

Schedule availability start (ISO 8601)

keywords array<string> optional

Keywords/tags

published_date string optional

Published date (ISO 8601)

release_date string optional

Release date (ISO 8601)

title string optional

Season title

delete_season

Permanently delete a season. Its episode assignments are removed; the underlying source videos are NOT deleted. This action cannot be undone.

Parameters

season_id string required

The unique ID of the season to delete (required)

series_id string required

The unique ID of the parent series (required)

confirm boolean optional

Set to true to confirm deletion (required in safe mode)

reorder_seasons

Reorder all seasons of a series. Provide the complete list of season IDs in the desired order — it must include every season of the series exactly once.

Parameters

season_ids array<string> required

All season IDs in the desired order (required)

series_id string required

The unique ID of the parent series (required)

🎞️ Episodes

Assign videos as episodes of a season (standard series) or of a series directly (limited series). List, add, remove, and reorder episodes.

Example prompts:

  • "List the episodes of season def456 in series abc123"
  • "Add video xyz789 as an episode of season def456"
  • "Reorder the episodes of season def456"
  • "Remove episode ep123 from season def456"

4 Tools

list_episodes

List the episodes of a season (standard series) or of a series directly (limited series), in display order.

More details
Provide season_id for a standard series; omit it for a limited series.
Each episode links a Video and includes its title, duration, thumbnail, and episode_number.

Parameters

series_id string required

The unique ID of the parent series (required)

ordering string optional

Ordering rule (e.g. 'manual'); defaults to the parent's configured rule

page number optional

Page number (default: 1)

per_page number optional

Results per page (default: 10, max: 500)

season_id string optional

The season ID (omit for a limited series)

create_episode

Assign a video as an episode of a season (standard series) or of a series directly (limited series). The video must belong to the same site and cannot already be an episode of the same parent. episode_number auto-increments if omitted; position appends to the end if omitted.

Parameters

series_id string required

The unique ID of the parent series (required)

video_id string required

The ID of the video to assign as an episode (required)

episode_number number optional

Episode number (auto-assigned if omitted)

position number optional

Insert position in the ordered list (appended if omitted)

season_id string optional

The season ID (omit for a limited series)

delete_episode

Remove an episode assignment from a season or series. The underlying source video is NOT deleted. This action cannot be undone.

Parameters

episode_id string required

The unique ID of the episode assignment to delete (required)

series_id string required

The unique ID of the parent series (required)

confirm boolean optional

Set to true to confirm deletion (required in safe mode)

season_id string optional

The season ID (omit for a limited series)

reorder_episodes

Reorder all episodes of a season or series. Provide the complete list of episode IDs in the desired order — it must include every episode of the parent exactly once.

Parameters

episode_ids array<string> required

All episode IDs in the desired order (required)

series_id string required

The unique ID of the parent series (required)

season_id string optional

The season ID (omit for a limited series)

🌍 Content Rule Groups

Manage custom content rule groups — reusable geo/IP targeting rule sets (by country, state, city, ZIP, DMA code, or IP address/range) used to gate content access.

Example prompts:

  • "List all content rule groups"
  • "Create a country rule group blocking access outside the US and Canada"
  • "Create an IP rule group for our office network range"
  • "Delete the content rule group abc123"

5 Tools

list_content_rule_groups

List all custom content rule groups (geo/IP targeting rule sets) for your site, ordered by name.

No parameters required

get_content_rule_group

Get a single content rule group by its ID, including its group type and all matching values.

Parameters

content_rule_group_id string required

The unique ID of the content rule group (required)

create_content_rule_group

Create a new content rule group. Provide a name, a group_type, and the matching values for that type (e.g. countries for a country group, ip_addresses/ip_ranges for an ip_address group).

Parameters

name string required

Name of the content rule group (required)

cities array<string> optional

City names; required for city groups

countries array<string> optional

ISO 3166-1 alpha-2 country codes (uppercase); required for country groups

dma_codes array<string> optional

DMA codes; required for dma_code groups

group_type string optional

Rule matching type (default: country)

"country" | "state" | "city" | "zip_code" | "dma_code" | "ip_address"
ip_addresses array<string> optional

Single hosts or CIDR blocks

ip_ranges array<object> optional

Start/end IP address pairs

states array<string> optional

US state codes (uppercase); required for state groups

zip_codes array<string> optional

ZIP/postal codes; required for zip_code groups

update_content_rule_group

Update an existing content rule group. Only the fields you provide are changed.

Parameters

content_rule_group_id string required

The unique ID of the content rule group to update (required)

cities array<string> optional

City names; required for city groups

countries array<string> optional

ISO 3166-1 alpha-2 country codes (uppercase); required for country groups

dma_codes array<string> optional

DMA codes; required for dma_code groups

group_type string optional

Rule matching type (default: country)

"country" | "state" | "city" | "zip_code" | "dma_code" | "ip_address"
ip_addresses array<string> optional

Single hosts or CIDR blocks

ip_ranges array<object> optional

Start/end IP address pairs

name string optional

New name

states array<string> optional

US state codes (uppercase); required for state groups

zip_codes array<string> optional

ZIP/postal codes; required for zip_code groups

delete_content_rule_group

Permanently delete a content rule group from Zype. This action cannot be undone.

Parameters

content_rule_group_id string required

The unique ID of the content rule group to delete (required)

confirm boolean optional

Set to true to confirm deletion (required in safe mode)

🌐 Global Content Rule Groups

Browse the read-only catalog of global content rule groups - geo/IP targeting rule groups (countries, states, cities, zip codes, DMA codes, IP addresses, and IP ranges) shared across sites.

Example prompts:

  • "List all global content rule groups"
  • "Show me global content rule group abc123"
  • "What countries does global content rule group abc123 target?"

2 Tools

list_global_content_rule_groups

List the global content rule groups catalog (geo/IP targeting rule groups shared across sites), ordered by name. Supports optional search, sorting, and pagination.

Parameters

order string optional

Sort order

"asc" | "desc"
page number optional

Page number (default: 1)

per_page number optional

Results per page (default: 10, max: 500)

q string optional

Search query

sort string optional

Field to sort by

get_global_content_rule_group

Get a single global content rule group from the catalog by its ID, including its geo/IP targeting lists (countries, states, cities, zip codes, DMA codes, IP addresses, and IP ranges).

Parameters

global_content_rule_group_id string required

The unique ID of the global content rule group (required)

🗺️ Content Rule Profiles

Manage content rule profiles — named, reusable sets of geo/IP access rules. Each profile bundles rules that allow or deny access by country, state, city, ZIP, DMA, IP address, or IP range, targeting specific content rule groups.

Example prompts:

  • "List all content rule profiles"
  • "Create a content rule profile that blocks access outside the US"
  • "Show content rule profile abc123 with its rules"
  • "Add an allow rule for Canada to profile abc123"

5 Tools

list_content_rule_profiles

List content rule profiles — named sets of geo/IP access rules — in your Zype site.

Parameters

order string optional

Sort order

"asc" | "desc"
page number optional

Page number (default: 1)

per_page number optional

Results per page

q string optional

Search query

sort string optional

Field to sort by

get_content_rule_profile

Get a specific content rule profile by its ID, including all of its nested content rules.

Parameters

content_rule_profile_id string required

The unique ID of the content rule profile (required)

create_content_rule_profile

Create a new content rule profile (a named set of geo/IP access rules).

More details
Provide a title and, optionally, a description, whether it is the site's default profile, and a list of nested content rules. Each rule has a policy (allow/deny), a priority, a match_type, location criteria (countries, states, cities, zip_codes, dma_codes, ip_addresses, ip_ranges), and content_rule_group_ids identifying the content rule groups it targets.

Parameters

title string required

Title of the content rule profile (required)

content_rules array<object> optional

Nested content rules to create with the profile

description string optional

Description of the profile

is_default_profile boolean optional

Whether this is the default profile for the site

update_content_rule_profile

Update an existing content rule profile. Only the fields you provide are changed.

More details
To modify nested rules, pass content_rules: include an existing rule's id to update it, set _destroy: true (with id) to remove it, or omit id to add a new rule.

Parameters

content_rule_profile_id string required

The unique ID of the content rule profile to update (required)

content_rules array<object> optional

Nested content rules to add, update (with id), or remove (with _destroy)

description string optional

New description

is_default_profile boolean optional

Whether this is the default profile for the site

title string optional

New title

delete_content_rule_profile

Permanently delete a content rule profile from Zype. This action cannot be undone.

Parameters

content_rule_profile_id string required

The unique ID of the content rule profile to delete (required)

confirm boolean optional

Set to true to confirm deletion (required in safe mode)