Wistia

Add a video to a Wistia Channel as a new episode — an individual video entry within a channel's embeddable video gallery or content hub. Use this when someone wants to add, insert, append, or put a video into a channel or video gallery. Requires an api token with "Read, update & delete anything" permission. Use create-channel to make the channel first, get-channels to find its hashed id, and publish-channel-episode to make the episode visible.

create-channel-episode

Create, add, or set up a new folder (previously called a "project") — a container that organizes your videos and audio files (media). Use this when someone wants to make, add, or create a new folder or project to group media. On success the Location HTTP header points to the new folder. Use update-folder to rename it, get-folders to list folders, delete-folder to remove one, copy-folder to duplicate one, or create-subfolder to nest a folder inside it.

create-folder

Create a folder sharing — grant a contact or contact group access/view permission to a folder (previously called a "project"). Use this when someone wants to share a folder, give access, or add a person or group to a folder by specifying the email of the person to share with plus other optional parameters. Use get-folder-sharings to list who a folder is shared with, update-folder-sharing to change a sharing's permission, or delete-folder-sharing to revoke access.

create-folder-sharing

Create a new media by trimming, cutting, or clipping parts off an existing video — produces a separate, shortened copy without modifying the source. By default the trims time ranges specify parts to remove; set keep_trims to true to instead specify the ranges to keep. Processing is asynchronous and returns a background_job_status object. Use this when someone wants to cut, clip, shorten, or trim a video into a new media. Currently only video files are supported.

create-media-from-trims

Create, add, set up, or nest a new subfolder within a folder (previously called a "project"). A subfolder is a nested folder inside a folder, used to further organize videos and audio files (media). Use this when someone wants to make, add, or create a subfolder inside a folder. The subfolder is created at the next available position. To create several subfolders at once, use create-bulk-actions with resource_type "subfolder" instead of calling this repeatedly. Use update-subfolder to rename it, get-subfolders to list subfolders, delete-subfolder to remove one, or get-folders to list the parent folders.

create-subfolder

Create, add, or make a new tag — a label or keyword used to organize and categorize media. Use this when someone wants to define a new tag in the account. To list existing tags use get-tags, delete-tag to remove one, or bulk-tag-media to apply tags to media files.

create-tags

Create a new webinar — a live or scheduled online video event / live stream that people register for and attend. Use this when someone wants to create, add, set up, or schedule a new webinar or live event. Use update-webinar to edit it, get-webinars to list webinars, delete-webinar to cancel one, or create-webinar-registration to register an attendee.

create-webinar

Create a webinar collaborator — invite a contact as a producer to a webinar. Use this when someone wants to share producer access to a webinar, give production access, or add a person to a webinar by specifying their email address. Viewers cannot be webinar collaborators. Use get-webinar-collaborators to list who has access to a webinar or delete-webinar-collaborator to revoke access.

create-webinar-collaborator

Register, sign up, or enroll a person (a registrant/attendee) for a webinar — a live or scheduled online video event — by providing their email, first name, and last name. Use this when someone wants to add an attendee to or register someone for a webinar or live event. Generates a unique visitor key and returns a personalized webinar URL for the registrant. Use get-webinars to find the webinar, or list-webinar-registrations to see existing registrants.

create-webinar-registration

Delete or remove the captions (subtitles / closed captions / CC / SRT subtitle track) from a video for a specified ISO-639-2 language code. Use this when someone wants to delete a subtitle or caption track from a media. Use create-captions to add a track, update-captions to replace one, or get-captions to list existing tracks.

delete-captions

Permanently delete (remove, destroy, tear down) a Wistia Channel — an embeddable video gallery, content hub, or video showcase page that groups videos into episodes. Identify it by its channelHashedId. This cannot be undone. Use this when someone wants to get rid of a channel or video gallery. Use get-channels to find the hashed id, update-channel to edit instead, or delete-channel-episode to remove a single video.

delete-channel

Delete a channel collaborator — revoke a contact's access to a channel. Use this when someone wants to remove a person's access to a channel, unshare a channel, or revoke permissions. Use get-channel-collaborators to list who has access to a channel or create-channel-collaborator to grant access.

delete-channel-collaborator

Permanently delete (remove, destroy, take out) a channel episode — an individual video entry within a Wistia Channel's embeddable video gallery or content hub. Identify it by its channelEpisodeHashedId; this cannot be undone. Requires an api token with "Read, update & delete anything" permission. Use this when someone wants to remove a video from a channel or video gallery. Use get-channel-episodes to find the hashed id, or un-publish-channel-episode to just hide it instead of deleting.

delete-channel-episode

Deletes all explicit customizations for a video, resetting it to default player behavior. Use this to clear all appearance, playback, engagement, and other settings at once.

delete-customizations

Delete or remove a folder (previously called a "project") — a container that organizes videos and audio files (media). Use this when someone wants to delete, remove, or get rid of a folder or project. Use get-folders to list folders first, create-folder to make a new one, update-folder to rename instead, or bulk-delete-subfolders to remove nested subfolders.

delete-folder

Delete a folder sharing — remove or revoke a contact's or contact group's access to a folder (previously called a "project"). Use this when someone wants to unshare a folder, revoke access, or remove a person or group's permission on a folder. Use get-folder-sharings to list current sharings, create-folder-sharing to grant access, or update-folder-sharing to change a sharing instead of removing it.

delete-folder-sharing

Delete or remove a localization (a translated, language-specific / dubbed version of a media) by its hashed ID. Use this when someone wants to remove a localized or translated variant of a video. Use create-localization to add one, gets-localizations to list them, or show-localization to view one.

delete-localization

Delete a media (a video or audio file) by its hashed_id. Use this when someone wants to delete, remove, or trash a video or audio file. Deleted media moves to Recently Deleted and can be brought back with restore-deleted-media until its restore window ends, after which it is purged automatically. To remove media with no purge deadline, use archive-media instead.

delete-media

Delete (remove) an extended audio description (EAD) by its hashed id — the accessibility audio track that narrates on-screen visuals for blind and low-vision viewers. This permanently removes the EAD and cannot be undone. Use this when someone wants to delete or remove audio descriptions from a media. To look one up first use show-media-extended-audio-description, or get-media-extended-audio-descriptions to list them.

delete-media-extended-audio-description

Delete one subfolder from a folder (project) while keeping its media. The media moves to the folder's root level; only the subfolder is soft-deleted. To delete multiple subfolders and their media, use bulk-delete-subfolders.

delete-subfolder

Delete or remove a tag by name — a label or keyword used to organize and categorize media. This permanently removes the tag and cannot be undone. Use this when someone wants to get rid of a tag. To list existing tags use get-tags, or create-tags to make a new one.

delete-tag

Delete an existing webinar — a live or scheduled online video event / live stream — by its hashed ID. Use this when someone wants to delete, remove, cancel, or take down a webinar or live event. This permanently removes the webinar and cannot be undone. Use get-webinars to find a webinar, create-webinar to make one, or update-webinar to edit one instead.

delete-webinar

Delete a webinar collaborator — revoke a contact's producer access to a webinar. Use this when someone wants to remove a person's access to produce a webinar, unshare a webinar, or revoke permissions. Use get-webinar-collaborators to list who has access to a webinar or create-webinar-collaborator to grant access.

delete-webinar-collaborator

Get a Wistia background job's current status by its hashed id. Call it for any tool whose result includes a background job status, to track the async operation it kicked off. In UI-capable hosts one call renders a live widget that messages you when the job ends: call it once, then wait rather than polling. In headless hosts each call is a snapshot, so poll until "finished" or "failed". Jobs carrying typed detail return it under `object.details`, keyed by `object.details.type`. A bulk operation (create-bulk-actions or create-bulk-purchase) returns type "bulk_operation" with `summary`, the total/succeeded/failed counts for the whole batch, and `results`, the per-action outcomes: `position`, `operation`, `resource_type`, `id` (the affected record, and the new one for a successful create), `status`, and `error` on failures. `results` is capped at 100 entries, failures first, with `results_truncated` set and `results_omitted` counting the rest; the full list is on GET /modern/background_job_status/{id}.

get-background-job-status

List the brands in the account — the saved sets of branding options (colors, fonts, logos, border radius) used to style players and pages. The account-level default brand is marked with is_default. Supports pagination and sorting (by name, created, updated, or id). Use this when someone wants to see which brands exist and how each is configured.

get-brands

List, get, or find the caption tracks (subtitles / closed captions / CC / SRT subtitle tracks) belonging to the account, optionally narrowed to a specific media by hashed ID, with each track returned as JSON including its language. Use this when someone wants to see which subtitle or caption languages exist on a media. Use show-captions-file to fetch one track's text, create-captions to add one, or purchase-captions to buy Wistia-generated English captions.

get-captions

List, get, show, or browse the channel collaborators — the contacts and contact groups who have been granted access to a channel. Use this when someone wants to see who has access to a channel, list collaborators, or find who a channel is shared with, with optional sorting and pagination. Results are limited to collaborators the authenticated user is permitted to see: only account owners, managers, and channel admins can see the full list. Use create-channel-collaborator to grant access or delete-channel-collaborator to revoke access.

get-channel-collaborators

List, get, show, browse, or find channel episodes — the individual video entries within a Wistia Channel's embeddable video gallery or content hub. Filter by channel_id, media_id, title, or published state; supports pagination, sorting, and batch fetch by hashed_ids. Use this when someone wants to see which videos are in a channel or video gallery. Use get-channels to find a channel's hashed id, create-channel-episode to add a video, or publish-channel-episode / un-publish-channel-episode to control visibility.

get-channel-episodes

List, get, show, browse, or find all Wistia Channels in an account — each an embeddable video gallery, content hub, video showcase, or playlist page that groups videos into episodes. Supports pagination, sorting, and batch fetch by one or more hashed_ids. Use this when someone wants to see what channels or video galleries exist or look up a channel's hashed id. Use create-channel to make one, update-channel to edit, or get-channel-episodes to list a channel's videos.

get-channels

List, get, show, or browse the folder sharings — the contacts and contact groups who have been granted access to a folder (previously called a "project"). Use this when someone wants to see who a folder is shared with, list access permissions, or find sharings on a folder, with optional hashed-id filtering, sorting, and pagination. Use create-folder-sharing to grant access, update-folder-sharing to change a sharing, or delete-folder-sharing to revoke access.

get-folder-sharings

List, get, show, browse, or find folders (previously called "projects") belonging to the account — containers that organize videos and audio files (media). Use this when someone wants to list, get, show, browse, or find folders or projects, optionally filtering by hashed IDs and sorting/paginating the results. Use create-folder to add a new folder, update-folder to rename one, delete-folder to remove one, copy-folder to duplicate one, or get-subfolders to list folders nested inside a folder.

get-folders

List, get, or find all extended audio descriptions (EADs) in the account — the accessibility audio tracks that narrate on-screen visuals for blind and low-vision viewers. Supports pagination, filtering by hashed_ids, and sorting. Use this when someone wants to see existing audio descriptions. For a single one use show-media-extended-audio-description, or order-media-extended-audio-description to buy a new one.

get-media-extended-audio-descriptions

List, browse, or fetch media records (videos and audio files) in the account. Use this when someone wants a page of media, all media in a known folder, exact-name or exact-ID lookup, or structured filtering by folder, media type, tags, archived status, sorting, or pagination. Do not use this as the first step for keyword, topic, title, description, or transcript search; use the `search` tool for those content-finding requests, then use get-medias only if you need exact media records by hashed_id. For "all" or "how many" requests with structured filters, use `per_page: 100` and continue with `page` or `cursor` pagination while more results may exist. The default page size is 10, so never treat an unpaginated first response as a complete total. Returns a list of media records. In MCP responses, `per_page` is only the requested limit; use `returned_count` or the actual `content` length as the number of records returned in that response.

get-medias

List, get, show, browse, or find subfolders within a specific folder (previously called a "project"). A subfolder is a nested folder inside a folder that organizes videos and audio files (media). Use this when someone wants to list, get, show, or browse the subfolders inside a folder. You can use the hashed_ids filter to fetch a specific subfolder, plus sorting and pagination. Use create-subfolder to add a subfolder, update-subfolder to rename one, delete-subfolder to remove one, or get-folders to list the parent folders.

get-subfolders

List, get, or find the tags in the account — the labels or keywords used to organize and categorize media. Supports pagination and sorting (by name, created, updated, or taggings count). Use this when someone wants to see which tags exist. To make a new tag use create-tags, delete-tag to remove one, or bulk-tag-media to apply tags to media files.

get-tags

App-only: read a previous call's saved status and UI metadata using its _mcp_tool_call_id. - Restoring an uploader after a chat refresh. - Recovering a widget's last recorded state.

get-tool-status

Get short-lived upload credentials for folder_id. In MCP App hosts the embedded uploader calls this itself; do not call it directly there. - Completing a headless upload with the upload_url from upload-media-to- folder. Headless clients send a multipart POST to that upload_url with header "Authorization: <authorization_scheme> <authorization_token>" and form fields file, project_id (folder_id), and optional name. The POST returns the new media's hashed_id.

get-upload-token

List, get, show, or browse the webinar collaborators — the contacts and contact groups who have been granted producer access to a webinar. Use this when someone wants to see who has access to produce a webinar, list producers, or find who a webinar is shared with, with optional sorting and pagination. Results are limited to collaborators the authenticated user is permitted to see: only account owners, managers, and the webinar's producers can see the list. Use create-webinar-collaborator to grant access or delete-webinar-collaborator to revoke access.

get-webinar-collaborators

List, get, show, or find webinars belonging to the account — live or scheduled online video events / live streams that people register for and attend. Supports pagination, sorting, and filtering by hashed IDs or started status, and can batch fetch specific webinars by hashed ID. Use this to look up or browse webinars. Use create-webinar to make one, update-webinar to edit one, delete-webinar to cancel one, or list-webinar-registrations to see who registered.

get-webinars

List, get, or find all localizations (translated, language-specific / dubbed versions) for a media, optionally including each one's transcript. Use this when someone wants to see which translated or localized language variants a video has. Use show-localization for details on one, create-localization to add one, or delete-localization to remove one.

gets-localizations