The Wistia MCP connector routes your AI agent's tool calls to Wistia's own MCP server through Scalekit. Each user signs in to Wistia once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 183 tools.
- Tools
- 183
- What they doRead · write · destructive
- 82 · 64 · 3782 read64 write37 destructive
- Users sign in with
- OAuth
- OAuth app
- Your own Wistia MCP server app
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Wistia MCP connection
In AgentKit > Connections, create a Wistia MCP connection and copy its redirect URI. The name you give it is the
connection_nameyour code passes. See Configure connections.Register an OAuth app
Wistia MCP server connections use your own OAuth app. Register one with Wistia MCP server and add the redirect URI you copied.
Then enter the app's Client ID and Client Secret on the Wistia MCP connection.
Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'wistiamcp'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Wistia MCP:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'wistiamcp_check_credits',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "wistiamcp"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Wistia MCP:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="wistiamcp_check_credits",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user signs in once. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolwistiamcp_check_creditsCheck whether the account has enough Credits for a paid order of captions, dubs (localizations), text translations or extended audio descriptions, for one media or many, and get the per-item rate for each.Read-onlycheck credits
Check whether the account has enough Credits for a paid order of captions, dubs (localizations), text translations or extended audio descriptions, for one media or many, and get the per-item rate for each. Read-only: it reserves no Credits and places nothing, and each order still holds its own Credits when it runs. - Checking a create-bulk-purchase job or its actions before submitting them. - Checking a single dub, human-reviewed caption or translation order before placing it.
Inputs
actionsarray- The items to order: each has resource_type, id (media hashed ID) and payload, as in create-bulk-purchase actions. A single dub is one localization action.
jobobject- A create-bulk-purchase job, instead of actions.
wistiamcp_display_resultsShow the user a card of the media, folders, subfolders, channels, or webinars that a search or list call returned.Read-onlydisplay results
Show the user a card of the media, folders, subfolders, channels, or webinars that a search or list call returned. search and the list tools return data only and show the user nothing. When the user asked to see the records, call this with the `_mcp_tool_call_id` from that call's result: - "Find my guitar video": search, then display its result. - "Show me what's in the Launch folder": get-medias, then display its result. - Results the user picks from or reviews before a write. Skip it for lookups made only to get an ID, for counts, and when another tool shows the content itself, such as play-media. The card is built from the result that call returned, with its count and its link to the full results, so pass no record data. It shows every record that call returned; to show fewer, run the call again with narrower arguments. A search that matched nothing gets a card saying so. When you paged through one list (the same call with the same arguments apart from `page`), call this once, after the last page, with the ID of every page's call, and the pages show as one card. Results of different calls each need a call of their own. Only a result whose tool description names display-results can be displayed, and only by the caller who made the call. Only a host that renders MCP Apps shows the card. When the result has `card_shown: true`, do not repeat its rows in your response. Otherwise the user may see no card, so list the records in your response too.
Inputs
mcp_tool_call_idsarrayrequired- The `_mcp_tool_call_id` in the result of the search or list call whose records to show. For pages of one list, the ID of each page's call.
wistiamcp_find_media_by_embed_locationFind the media embedded at a given URL.Read-onlyfind media by embed location
Find the media embedded at a given URL. Returns the hashed IDs of the account's media that recorded activity at that embed location during the date range, ranked by plays. The resulting hashed IDs can be passed to other endpoints, such as Show Account Top Content's `hashed_ids[]` filter, to fetch analytics for those media. The domain of `embed_url` is always matched exactly. Its path is matched exactly by default, or as a prefix with `path_match=prefix` (e.g. `/pricing` also matching `/pricing/plans`). A path that is empty or `/` is ignored, returning media across all paths on the domain. Embed location data is retained for 6 months. A `start_date` older than that is moved forward to 6 months ago (UTC); a range that ends before then returns a 422 error. When `start_date` and `end_date` are omitted, the full 6-month queryable window is used.
Inputs
embed_urlstringrequired- The URL of the page to look up, e.g. `https://example.com/pricing`. The protocol is optional (https is assumed), so `example.com/pricing` also works.
end_datestring- End date for the analytics period in ISO 8601 format (YYYY-MM-DD). Exclusive — the range ends before the beginning of this date. Must be on or after `start_date` and no more than 730 days after it. Defaults to tomorrow, so today's activity is included.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: media_hashed_ids
path_matchstring- How to match the path of `embed_url` against embed locations. `exact` requires the path to match exactly; `prefix` matches any embed path starting with it.one of
exactprefixdefaultexact per_pageinteger- Number of media hashed IDs to return (max 1000).default
100 start_datestring- Start date for the analytics period in ISO 8601 format (YYYY-MM-DD). Inclusive — the range starts at the beginning of this date. Must be no more than 730 days before `end_date`. A date more than 6 months ago is moved forward to 6 months ago. Defaults to 6 months ago, the start of the queryable window.
wistiamcp_find_transcript_matchesFind exact transcript wording across explicitly identified media without writing.Read-onlyfind transcript matches
Find exact transcript wording across explicitly identified media without writing. Use it to answer where wording occurs, or to prepare a targeted `edit-captions-text` call: it returns each track's current version and the start/end ranges that disambiguate an edit. A `resolved` match means the wording was located, not that a write will succeed — authorization, version conflicts, or non-editable boundaries can still reject it. Exact `matches` and fuzzy `suggestions` are separate; never treat a suggestion as the requested wording. Past 10 exact matches, call again with `occurrence` set to the next unseen one-based occurrence (`next_occurrence` when present). Omit `language_code` unless copying an exact tag from a prior result: a sole track is selected automatically, and several return `language_required` with exact IETF tags. Never infer `en` or `eng` from a language name. When reducing fields, always retain `track.version` so the edit can reuse them. Select through the envelope with `results(media_hashed_id,status,tracks(language),track(language,version),match_count,matches,next_occurrence)`.
Inputs
media_hashed_idsarrayrequired- Explicit hashed IDs of media whose transcripts should be searched.
target_textstringrequired- Exact caption wording to locate.
end_msinteger- Optional end of an edit-compatible time range used to disambiguate the match. Omit to run to the end.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: requested_count,succeeded_count,failed_count,complete,results(media_hashed_id,status,tracks(id,language,english_name,native_name,version,is_draft),track(id,language,english_name,native_name,version,is_draft),match_status,match_count,matches(start_ms,end_ms,text,context),matches_truncated,next_occurrence,suggestions(start_ms,end_ms,text,context),suggestions_truncated,hint,recovery)
language_codestring- An exact IETF tag copied from a prior result, including extended tags such as zh-Hant. Omit on the first call; never infer en or eng from a language name.
occurrenceinteger- Optional one-based exact occurrence to return first, including occurrences after the first 10.
start_msinteger- Optional start of an edit-compatible time range used to disambiguate the match. Omit to start at the beginning.
wistiamcp_get_account_usageRead the account's plan, upload eligibility, and media, storage, seat, and bandwidth usage against limits.Read-onlyget account usage
Read the account's plan, upload eligibility, and media, storage, seat, and bandwidth usage against limits. - Explaining why an upload or additional team member may exceed a limit. - Reporting remaining capacity before a bulk import or new seats. Use get-current-account for the account profile and get-credit-balance for Credits.
Inputs
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: plan(tier,name,is_standard,is_trial,trial_expires_at,trial_plan(tier,name)),can_upload,upload_blocked_reason,limits(primary_resource,media(count,flexible_limit,inflexible_limit),storage(used_bytes,flexible_limit_bytes,inflexible_limit_bytes),users(billable_count,account_billable_count,viewers_count,flexible_limit,inflexible_limit),bandwidth(used_bytes,limit_bytes,period,resets_at)),links(plans_url,usage_url,billing_url),role,verified_domain,can_invite_teammates,desktop_flags
wistiamcp_get_background_job_statusGet a Wistia background job's current status by its hashed id.Read-onlyget background job status
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}.
Inputs
background_job_status_hashed_idstringrequired- The hashed id of the background job status to watch (the hashed_id returned by the operation that enqueued the job).
app_only_propsobject- Reserved for the host application. Agents must always pass this as an empty object ({}) and never put anything in it. The application embedding this MCP server may populate it with its own data.
wistiamcp_get_brand_kit_colorsGet the current account's brand colors: brand kit colors and each brand's solid colors as hex strings, plus any brand gradients.Read-onlyget brand kit colors
Get the current account's brand colors: brand kit colors and each brand's solid colors as hex strings, plus any brand gradients.
Inputs
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: colors(name,value),brand_gradients(name,stops(color,position))
wistiamcp_get_brand_preloadRead the account's Brandfetch color, logo, domain, and brand-kit presence.Read-onlyget brand preload
Read the account's Brandfetch color, logo, domain, and brand-kit presence. - Suggesting initial branding during signup. - Checking whether onboarding can reuse an existing brand kit.
Inputs
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: has_brand_kits,brandfetch_brand(domain,primary_color,logo,font,colors,logos(theme,type,tags,formats(src,format,background,height,width,size)),status)
wistiamcp_get_brandsList saved brand kits: colors, fonts, and logo URLs; is_default marks the account default.Read-onlyget brands
List saved brand kits: colors, fonts, and logo URLs; is_default marks the account default. - Choosing an existing brand before styling a folder or channel. - Finding the default brand to restore inherited styling.
Inputs
cursorobject- Cursor pagination. When cursor pagination is enabled, each record returned has a `cursor`: pass the last one as `cursor[after]` for the next page, or the first one as `cursor[before]` for the previous page. A cursor only works with the `sort_by` it was fetched with.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: id,name,is_default,created,updated,primary_color,page_background_color,body_font_family,headline_font_family,button_font_family,border_radius,contrast_icons,opaque_controls,page_logo(url,dimensions(width,height),size),player_logo(url,dimensions(width,height),size),cursor
pageinteger- The page number to retrieve. This cannot be combined with `cursor`, pagination.
per_pageinteger- The number of medias per page. Use this for both offset pagination and cursor pagination.
sort_bystring- Ordering. When using cursor pagination (see cursor param),
only `id`, `updated` and `created` are supported. All other sort_by options
require offset pagination.
one of
namecreatedupdatedid sort_directioninteger- Ordering Sort Direction (0 = desc, 1 = asc)one of
01
wistiamcp_get_channel_collaboratorsList the people and groups holding an explicit role on a channel, with sorting and pagination.Read-onlyget channel collaborators
List the people and groups holding an explicit role on a channel, with sorting and pagination. Account owners and managers have implicit access and are not listed; callers who cannot manage the channel see only the roles that grant them access. - Audit who was granted access before sharing unreleased episodes. - Find a collaborator to revoke, or check if a teammate already has access.
Inputs
channelHashedIdstringrequired- Channel Hashed ID (e.g., "abc123")
cursorobject- Cursor pagination. When cursor pagination is enabled, each record returned has a `cursor`: pass the last one as `cursor[after]` for the next page, or the first one as `cursor[before]` for the previous page. A cursor only works with the `sort_by` it was fetched with.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: id,role,created_at,share(id,name,type,email),cursor
pageinteger- The page number to retrieve. This cannot be combined with `cursor`, pagination.
per_pageinteger- The number of medias per page. Use this for both offset pagination and cursor pagination.
sort_bystring- Ordering. When using cursor pagination (see cursor param),
only `id` is supported.
one of
createdupdatediddefaultid sort_directioninteger- Ordering Sort Direction (0 = desc, 1 = asc; default is 1)one of
01default1
wistiamcp_get_channel_episodesList channel episodes with channel_id, media_id, title (exact match), published-state, and hashed_ids filters, plus sorting and pagination.Read-onlyget channel episodes
List channel episodes with channel_id, media_id, title (exact match), published-state, and hashed_ids filters, plus sorting and pagination. Omitting channel_id returns every episode in the account. - Audit which videos in a series are published and which are drafts. - Find an episode ID before scheduling, editing, or withdrawing it; use get-channels to identify the parent gallery.
Inputs
channel_idstring- The hashed ID of the channel to grab channel episodes from.
cursorobject- Cursor pagination. When cursor pagination is enabled, each record returned has a `cursor`: pass the last one as `cursor[after]` for the next page, or the first one as `cursor[before]` for the previous page. A cursor only works with the `sort_by` it was fetched with.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: id,channel_hashed_id,created,cursor,description,summary,hashed_id,media_hashed_id,live_stream_event_hashed_id,published,publish_at,title,updated,podcast_settings(episode_type,episode_number,season_number,explicit_content,hide_from_feed)
hashed_idsarray- Filter by hashed id
media_idarray- Filter by media id. Accepts either the numeric id or the hashed id of a media.
pageinteger- The page number to retrieve. This cannot be combined with `cursor`, pagination.
per_pageinteger- The number of medias per page. Use this for both offset pagination and cursor pagination.
publishedboolean- Filter by published status.
sort_bystring- Ordering. Default is ID ASC. When using cursor pagination (see cursor param),
only `id` and `created` are supported. All other sort_by options (`position`, `title`, `updated`, `published_at`)
require offset pagination.
one of
positiontitlecreatedupdatedpublished_atid sort_directioninteger- Ordering Sort Direction (0 = desc, 1 = asc; default is 1)one of
01 titlestring- Filter by channel episode name/title.
wistiamcp_get_channelsList the account's Wistia Channels (video galleries and podcast series), with pagination, sorting, and batch lookup by hashed_ids.Read-onlyget channels
List the account's Wistia Channels (video galleries and podcast series), with pagination, sorting, and batch lookup by hashed_ids. No name filter: match from the listing or use search. - Inventory content hubs before creating a new series. - Find a channel ID before adding episodes or editing podcast settings; get-channel-episodes lists its videos. - Get a channel's shareable viewer link from `public_url`; `locked` means viewers can't open it yet. Nothing here is shown to the user. When they asked to find, list, or see channels, follow up with display-results, passing this result's `_mcp_tool_call_id`, so they get a card. Skip it when the listing is a step toward another tool.
Inputs
cursorobject- Cursor pagination. When cursor pagination is enabled, each record returned has a `cursor`: pass the last one as `cursor[after]` for the next page, or the first one as `cursor[before]` for the previous page. A cursor only works with the `sort_by` it was fetched with.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: id,created,description,hashed_id,media_count,live_stream_event_count,name,public_url,locked,updated,auto_publish_enabled,podcast_enabled,custom_url,embedded_url,podcast_settings(copyright,episode_format,author_name,explicit,owner_name,owner_email,category1,category2,category3,language),cursor
hashed_idsarray- Find all of the channels limited to these hashed_ids.
pageinteger- Page number to retrieve
per_pageinteger- Number of channels per page
sort_bystring- Ordering. Default is ID ASC.
Note: Only 'id' and 'created' are supported when using cursor pagination.
one of
createdidupdatedname sort_directioninteger- Ordering Sort Direction (0 = desc, 1 = asc; default is 1)one of
01
wistiamcp_get_credit_balanceCheck available Credits and the next recurring grant time, if known.Read-onlyget credit balance
Check available Credits and the next recurring grant time, if known. - Checking the balance before an AI job or API write that spends Credits. - Answering how many Credits remain or when more are due. Separate from the legacy monthly AI edit allowance, which create-mochine-edit reports when it refuses an edit with monthly_limit_reached. The balance may lag an in-flight operation; a 402 response is authoritative.
Inputs
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: balance,next_grant_at
wistiamcp_get_current_accountRead the current account's name, url, video_limit, media_count, folder_count, and channel_count.Read-onlyget current account
Read the current account's name, url, video_limit, media_count, folder_count, and channel_count. - Confirming which Wistia account a request will affect. - Counting media, folders, or channels without paging get-medias. For usage against limits use get-account-usage; for credential permissions use get-current-token; for transcript defaults and the keyword glossary use get-transcript-settings.
Inputs
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,name,url,media_count,video_limit,folder_count,channel_count
wistiamcp_get_current_tokenRead the current API credential's owner, scopes, and permissions.Read-onlyget current token
Read the current API credential's owner, scopes, and permissions. - Diagnosing a permission error before retrying a tool call. - Confirming whose permissions an integration acts with. Use get-current-account for account identity and get-account-usage for plan limits.
Inputs
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: type,application(name,scopes),scopes,name,expires_at
wistiamcp_get_display_results_dataApp-only: read the card a display-results call shows, using the mcp_tool_call_ids that call was given.Read-onlyget display results data
App-only: read the card a display-results call shows, using the mcp_tool_call_ids that call was given. - Loading the results card's rows. - Reloading them after a chat refresh.
Inputs
mcp_tool_call_idsarrayrequired- The `_mcp_tool_call_id` in the result of the search or list call whose records to show. For pages of one list, the ID of each page's call.
app_only_propsobject- Reserved for the host application. Agents must always pass this as an empty object ({}) and never put anything in it. The application embedding this MCP server may populate it with its own data.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name.
wistiamcp_get_folder_sharingsList a folder's explicit sharings with people and contact groups and their permissions.Read-onlyget folder sharings
List a folder's explicit sharings with people and contact groups and their permissions. Account-wide and role-based owner/manager access is not listed, so this is not a full access audit. - Audit who can upload, download, or reshare, and take a sharing's numeric id as sharingId for update-folder-sharing or delete-folder-sharing.
Inputs
folderIdstringrequired- Folder Hashed ID (e.g., "4d23503f70")
cursorobject- Cursor pagination. When cursor pagination is enabled, each record returned has a `cursor`: pass the last one as `cursor[after]` for the next page, or the first one as `cursor[before]` for the previous page. A cursor only works with the `sort_by` it was fetched with.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: id,is_admin,can_share,can_download,can_upload,share(id,name,type,email),folder(id,name),cursor
hashed_idsarray- Filter sharings by their hashed IDs
pageinteger- The page number to retrieve. This cannot be combined with `cursor`, pagination.
per_pageinteger- The number of medias per page. Use this for both offset pagination and cursor pagination.
sort_bystring- Ordering. When using cursor pagination (see cursor param),
only `id` is supported.
one of
createdupdatediddefaultid sort_directioninteger- Ordering Sort Direction (0 = desc, 1 = asc; default is 1)one of
01default1
wistiamcp_get_foldersList content-library folders (formerly projects).Read-onlyget folders
List content-library folders (formerly projects). Records carry media_count (sort_by spells it mediaCount); no single-folder tool exists, so pass hashed_ids to fetch specific ones. My Library folders are listed only with personal_library: true, which returns just the user's own My Library folders. - Find empty or stale folders, map how the library is organized, or resolve a folder's hashed_id before get-medias or get-subfolders. - List the user's My Library folders before saving a video "to my library". Nothing here is shown to the user. When they asked to find, list, or see folders, follow up with display-results, passing this result's `_mcp_tool_call_id`, so they get a card. Skip it when the listing is a step toward another tool.
Inputs
cursorobject- Cursor pagination. When cursor pagination is enabled, each record returned has a `cursor`: pass the last one as `cursor[after]` for the next page, or the first one as `cursor[before]` for the previous page. A cursor only works with the `sort_by` it was fetched with.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: id,name,description,media_count,medias(url),created,updated,hashed_id,public,public_id,anonymous_can_upload,anonymous_can_download,kind,personal_library,cursor
hashed_idsarray- A collection of hashed ids belonging to folders to fetch
pageinteger- The page number to retrieve. This cannot be combined with `cursor`, pagination.
per_pageinteger- The number of medias per page. Use this for both offset pagination and cursor pagination.
personal_libraryboolean- When true, list only the token user's own My Library folders, instead of the content library folders. Account tokens act as the account owner, so they list the owner's My Library folders.
sort_bystring- Ordering. When using cursor pagination (see cursor param),
only `id`, `updated` and `created` are supported. All other sort_by options
require offset pagination.
one of
namecreatedupdatedmediaCountid sort_directioninteger- Ordering Sort Direction (0 = desc, 1 = asc; default is 1)one of
01
wistiamcp_get_media_extended_audio_descriptionsList extended audio descriptions (EADs), the tracks that narrate visuals for blind and low-vision viewers.Read-onlyget media extended audio descriptions
List extended audio descriptions (EADs), the tracks that narrate visuals for blind and low-vision viewers. - Audit existing audio descriptions before ordering accessibility work. - Get an EAD ID for show-media-extended-audio-description. Account-wide, with no media filter: to check one video, page the list and match each record's media link.
Inputs
cursorobject- Cursor pagination. When cursor pagination is enabled, each record returned has a `cursor`: pass the last one as `cursor[after]` for the next page, or the first one as `cursor[before]` for the previous page. A cursor only works with the `sort_by` it was fetched with.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: id,ietf_language_tag,created_at,updated_at,media(id,index_url,url),provided_media_file(id,index_url,url),contact(id,index_url,url),cursor
hashed_idsarray- Filter extended audio descriptions to only those matching these hashed ids.
pageinteger- The page number to retrieve. This cannot be combined with `cursor`, pagination.
per_pageinteger- The number of medias per page. Use this for both offset pagination and cursor pagination.
sort_bystring- Field to order by. The default is id.one of
languagecreatedupdatedid sort_directioninteger- Direction to order by. (0 = desc, 1 = asc; default is 1)one of
01
wistiamcp_get_mediasList media records by structured filters (folder_id, hashed_ids, exact name, type, tags, archived).Read-onlyget medias
List media records by structured filters (folder_id, hashed_ids, exact name, type, tags, archived). `tags` matches media with every listed tag. search is the better fit for finding media by keyword, title, transcript, or any of several tags. - Fetch known media by hashed_ids (the only by-ID lookup) for names, metadata, and asset URLs. - List or count a folder's media with per_page: 100 (default 10); for an account-wide total read get-current-account. folder_id takes a top-level folder hashed_id from get-folders or search, not a subfolder or media ID; there is no subfolder filter, though each record names its subfolder. No embed code is served (embedCode is deprecated); share a show-media-share-link URL. `speaker_profile_ids` limits results to media assigned to any of those speaker profiles: resolve the person with get-speakers and pass every match. Paginate for a complete result. Add `include: "speakers"` only when assignment details are needed. A media a Mochine edit produced carries `mochine_edit_id`: pass it to get-mochine-edit for the `source_media_ids` it was cut from. Nothing here is shown to the user. When they asked to find, list, or see media, follow up with display-results, passing this result's `_mcp_tool_call_id`, so they get a card. Skip it when the listing is a step toward another tool, such as play-media or a write.
Inputs
archivedboolean- Filter by archived status. True will return only archived medias, while false will return only active medias.
cursorobject- Cursor pagination. When cursor pagination is enabled, each record returned has a `cursor`: pass the last one as `cursor[after]` for the next page, or the first one as `cursor[before]` for the previous page. A cursor only works with the `sort_by` it was fetched with.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: id,name,type,archived,created,updated,duration,embedCode,hashed_id,description,progress,status,section,thumbnail(url,width,height),protected,folder(id,name,hashed_id),assets(url,width,height,file_size,content_type,type),subfolder(hashed_id,name,description,position,created,updated,cursor),tags(name),speakers(media_speaker_id,speaker_profile_id,name),mochine_edit_id,composite_type,cursor
folder_idstring- A hashed ID specifying the folder from which you would like to get results. (e.g., "4d23503f70")
hashed_idsarray- Find all of the medias by these hashed_ids.
includestring- Set to `speakers` to add each media's `speakers` array, its active transcript speaker assignments used for diarization. Webinar hosts and panelists are not included.one of
speakers namestring- Find a media or medias whose name exactly matches this parameter.
pageinteger- The page number to retrieve. This cannot be combined with `cursor`, pagination.
per_pageinteger- The number of medias per page. Use this for both offset pagination and cursor pagination.
sort_bystring- Ordering. When using cursor pagination (see cursor param),
only `id` and `created` are supported. All other sort_by options (`name`, `updated`, `position`)
require offset pagination.
one of
namecreatedupdatedposition sort_directioninteger- Ordering Sort Direction (0 = desc, 1 = asc; default is 1)one of
01 speaker_profile_idsarray- Filter media assigned to any of these reusable speaker profiles. Blank IDs are ignored; a list with no ID returns 400.
tagsarray- Find all of the medias that match all of these tag names.
typestring- A string specifying which type of media you would like to get.one of
VideoAudioImagePdfDocumentMicrosoftOfficeDocumentSwfUnknownType
wistiamcp_get_mochine_editRead a Mochine edit's status, output media ID, preview links, and download URL.Read-onlyget mochine edit
Read a Mochine edit's status, output media ID, preview links, and download URL. Mochine is Wistia's AI video editor. - Following create-mochine-edit or revise-mochine-edit until the edit is ready. - Getting a preview to review before revising. status is one of waiting_for_media, queued, working, ready, exporting, exported, failed, cancelled. preview appears at ready while the export may still run; exported means the rendered mp4 exists and can be downloaded, exporting that it does not yet; failed carries error {code, message}. While waiting_for_media, waiting_for lists {media_id, reason} for each source still processing, transcribing or aligning; after about 30 minutes the edit fails with code source_media_timeout. preview {url, hls_url, poster_url, expires_at} plays the revision with no login: url is a page to share, hls_url an HLS playlist. download {url, expires_at, width, height} is the mp4, present only when exported. preview links work up to 24 hours (sooner if the preview ends), the download url at least 24 hours; get the edit again to refresh. output_media_id is null until the export creates the media. revision is the latest revision's number; current_revision is the one the next revision builds on, to pass as base_revision when revising. revisions lists the latest 20 revisions you can see, oldest first, with its prompt (cut at 300 characters, prompt_truncated true) and findings_count; pass revision for an older one. now_doing says what a working revision is doing right now. warnings lists music and audio isolation failures; findings_count counts the instructions the revision did not land. Pass revision to read an earlier revision; the whole response then describes it. include=findings returns each unlanded instruction {instruction, evidence, cause}; include=transcript returns the revision's script as text, or text null with a reason (still_generating, no_scenes, unreadable). Pass both comma-separated. path reads inside the revision and returns it under read. Roots: overview (summary, credits, prompt, findings), instructions (the prompt and every user message), steers, plan, progress (the agent's steps), scenes (the timeline, e.g. scenes/3 or scenes/3/elements), motion (motion graphics), findings. A long list pages: pass read.next_read_cursor back as read_cursor with the same path. keys (comma-separated) keeps only those keys of each entry; max_bytes caps the page size (8000 by default, 1000 to 32000). Poll get-mochine-edit every few seconds until the status you need. Sandboxed agents can sleep between calls. For an edit by name or media, use get-mochine-edits.
Inputs
editHashedIdstringrequired- The `id` of the edit.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: cursor,id,object,name,status,revision,current_revision,elements(slides,overlays,captions,narration,music,custom_motion,generative_video),motion_kit_id,source_media_ids,waiting_for(media_id,reason),created_at,updated_at,view_url,edit_url,output_media_id,error(code,message),preview(url,hls_url,poster_url,expires_at),download(url,expires_at,width,height),now_doing,findings_count,warnings(component,message,scene_number,reason),revisions(revision,revision_id,status,prompt,prompt_truncated,created_at,output_media_id,findings_count),findings(instruction,evidence,cause),transcript(text,reason,message),read(path,as_of,revision,changed_since_cursor,value,items,text,total,total_chars,from,next_read_cursor,truncated)
includestring- Extra detail to return for the revision, comma-separated: `findings`, `transcript`, or both.
keysstring- Keys to keep on each entry read at path, comma-separated.
max_bytesinteger- The most bytes of a path read to return in one page.default
8000 pathstring- A path inside the revision to read, under one of the roots overview, instructions, steers, plan, progress, scenes, motion, findings (for example `scenes/3/elements`).
read_cursorstring- The `read.next_read_cursor` of an earlier read of the same path, for its next page.
revisioninteger- The revision number to read. Defaults to the latest revision you can see.
wistiamcp_get_mochine_editsList Mochine edits, newest first, each once as of the latest revision you can see.Read-onlyget mochine edits
List Mochine edits, newest first, each once as of the latest revision you can see. Mochine is Wistia's AI video editor. Every filter is optional: name (whole name, ignoring case), source_media_id (edits using that video), output_media_id (the edit that made that video; an empty list means none you can see did), status. Rows leave revisions, current_revision and preview null; pass an edit's id to get-mochine-edit for those, findings, the transcript or a read, or to revise-mochine-edit to change it.
Inputs
cursorobject- Cursor pagination. When cursor pagination is enabled, each record returned has a `cursor`: pass the last one as `cursor[after]` for the next page, or the first one as `cursor[before]` for the previous page. A cursor only works with the `sort_by` it was fetched with.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: cursor,id,object,name,status,revision,current_revision,elements(slides,overlays,captions,narration,music,custom_motion,generative_video),motion_kit_id,source_media_ids,waiting_for(media_id,reason),created_at,updated_at,view_url,edit_url,output_media_id,error(code,message),preview(url,hls_url,poster_url,expires_at),download(url,expires_at,width,height),now_doing,findings_count,warnings(component,message,scene_number,reason),revisions(revision,revision_id,status,prompt,prompt_truncated,created_at,output_media_id,findings_count),findings(instruction,evidence,cause),transcript(text,reason,message),read(path,as_of,revision,changed_since_cursor,value,items,text,total,total_chars,from,next_read_cursor,truncated)
namestring- The edit's name, matched in full and ignoring case.
output_media_idstring- The hashed ID of a video; finds the edit that made it.
pageinteger- The page number to retrieve. This cannot be combined with `cursor`, pagination.
per_pageinteger- The number of edits per page. Defaults to 10, maximum 100.default
10 source_media_idstring- The hashed ID of a video; finds the edits that use it as a source.
statusstring- The edit's status now.one of
waiting_for_mediaqueuedworkingreadyexportingexportedfailedcancelled
wistiamcp_get_motion_kitGet, show, or check one motion kit, built-in or custom, including every role's authoring status, phase, failure message, and warnings.Read-onlyget Mochine motion kit
Get, show, or check one motion kit, built-in or custom, including every role's authoring status, phase, failure message, and warnings. After create-motion-kit, revise-motion-kit or retry-motion-kit, call it again until status is ready with no pending_roles, failed (retry with retry-motion-kit), or stopped (it never becomes ready).
Inputs
motionKitIdstringrequired- The kit's id (its slug), from get-motion-kits. Built-in and custom kits both resolve.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,object,kind,name,status,roles_done,roles_total,pending_roles,failed_roles,preview_iframe_url_template,created_at,updated_at,ready_at,description,when_to_use,roles(role,status,revising,phase,failure_message,rejected,warnings),logo(status,rejection_reason),revision(routed_as,reauthoring_roles,updated_tokens,message,fallback_reason),fonts(headline(family,weight),body(family,weight)),colors(accent,accent_deep,paper,ink,pop_1,pop_2),cursor
wistiamcp_get_motion_kitsList, browse, or find motion kits — branded sets of animated graphics (lower thirds, titles, captions, and more).Read-onlylist Mochine motion kits
List, browse, or find motion kits — branded sets of animated graphics (lower thirds, titles, captions, and more). Returns the account's custom kits, newest first, then Wistia's built-in kits. Filter by name, kind (builtin or custom), or status (authoring, ready, failed, stopped). Any kit's id works as motion_kit_id when remixing. Rows leave out roles; use get-motion-kit for per-role detail.
Inputs
cursorobject- Cursor pagination. When cursor pagination is enabled, each record returned has a `cursor`: pass the last one as `cursor[after]` for the next page, or the first one as `cursor[before]` for the previous page. A cursor only works with the `sort_by` it was fetched with.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: id,object,kind,name,status,roles_done,roles_total,pending_roles,failed_roles,preview_iframe_url_template,created_at,updated_at,ready_at,description,when_to_use,roles(role,status,revising,phase,failure_message,rejected,warnings),logo(status,rejection_reason),revision(routed_as,reauthoring_roles,updated_tokens,message,fallback_reason),fonts(headline(family,weight),body(family,weight)),colors(accent,accent_deep,paper,ink,pop_1,pop_2),cursor
kindstring- Only return built-in or custom kits.one of
builtincustom namestring- Only return kits whose name or ID contains this text.
pageinteger- The page number to retrieve. This cannot be combined with `cursor`, pagination.
per_pageinteger- The number of motion kits per page. Defaults to 10, maximum 2000 with offset pagination and 100 with cursor pagination.
statusstring- Only return kits with this status.one of
authoringreadyfailedstopped
wistiamcp_get_recording_roomsList the account's Record recording rooms, optionally filtered by slug.Read-onlyget recording rooms
List the account's Record recording rooms, optionally filtered by slug. Each room has a `host_url` the host opens to record and a `guest_url` to share with guests, for example in a calendar invite. The app calls these reusable recording links. Check here before create-recording-room: slugs are unique, so an existing room may already fit.
Inputs
cursorobject- Cursor pagination. When cursor pagination is enabled, each record returned has a `cursor`: pass the last one as `cursor[after]` for the next page, or the first one as `cursor[before]` for the previous page. A cursor only works with the `sort_by` it was fetched with.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: slug,host_url,guest_url,requires_manual_admission,created,cursor
pageinteger- The page number to retrieve. This cannot be combined with `cursor`, pagination.
per_pageinteger- The number of medias per page. Use this for both offset pagination and cursor pagination.
slugstring- Restrict the results to rooms whose slug contains this value.
sort_bystring- Field to order by. The default is id.one of
idslugcreated sort_directioninteger- Direction to order by. (0 = desc, 1 = asc; default is 1)one of
01
wistiamcp_get_review_bundlesFind named groups of media that share one review link.Read-onlyget review bundles
Find named groups of media that share one review link. - Recovering an existing review link instead of creating another bundle. - Finding which review bundles include a video or a folder's media.
Inputs
cursorobject- Cursor pagination. When cursor pagination is enabled, each record returned has a `cursor`: pass the last one as `cursor[after]` for the next page, or the first one as `cursor[before]` for the previous page. A cursor only works with the `sort_by` it was fetched with.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: hashed_id,name,url,allow_downloads,cursor
folder_hashed_idstring- Restrict the results to review bundles that include any media from the folder with this hashed ID.
hashed_idsarray- Restrict the results to the review bundles with these hashed IDs.
media_hashed_idstring- Restrict the results to review bundles that include the media with this hashed ID.
namestring- Restrict the results to review bundles whose name contains this value (case-insensitive).
pageinteger- The page number to retrieve. This cannot be combined with `cursor`, pagination.
per_pageinteger- The number of medias per page. Use this for both offset pagination and cursor pagination.
sort_bystring- Field to order by. The default is id.one of
idnamecreatedupdated sort_directioninteger- Direction to order by. (0 = desc, 1 = asc; default is 1)one of
01
wistiamcp_get_speakersList, find, or search reusable speaker profiles by name.Read-onlyget speakers
List, find, or search reusable speaker profiles by name. Returns identity only: each profile's `speaker_profile_id`, `name`, `title`, and `image_url`. It does not return assignments, transcript timings, or unidentified detected speakers. Call it before assign-speaker, remove-speaker, or a `speaker_profile_ids` filter: a `speaker_profile_id` comes from here or create-speaker, never from the person's name.
Inputs
cursorobject- Cursor pagination. When cursor pagination is enabled, each record returned has a `cursor`: pass the last one as `cursor[after]` for the next page, or the first one as `cursor[before]` for the previous page. A cursor only works with the `sort_by` it was fetched with.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: speaker_profile_id,name,title,image_url,cursor
namestring- Restrict the results to speaker profiles whose name contains this value (case-insensitive).
pageinteger- The page number to retrieve. This cannot be combined with `cursor`, pagination.
per_pageinteger- The number of medias per page. Use this for both offset pagination and cursor pagination.
sort_bystring- Field to order by. The default is id.one of
idnamecreatedupdated sort_directioninteger- Direction to order by. (0 = desc, 1 = asc; default is 1)one of
01
wistiamcp_get_subfoldersList one folder's subfolders (names, descriptions, positions; no media).Read-onlyget subfolders
List one folder's subfolders (names, descriptions, positions; no media). There is no account-wide subfolder list. - Find a section's hashed_id before move-media, or check for an existing one before create-subfolder. folderId comes from get-folders. Nothing here is shown to the user. When they asked to find, list, or see subfolders, follow up with display-results, passing this result's `_mcp_tool_call_id`, so they get a card. Skip it when the listing is a step toward another tool.
Inputs
folderIdstringrequired- The hashed ID of the folder
cursorobject- Cursor pagination. When cursor pagination is enabled, each record returned has a `cursor`: pass the last one as `cursor[after]` for the next page, or the first one as `cursor[before]` for the previous page. A cursor only works with the `sort_by` it was fetched with.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: hashed_id,name,description,position,created,updated,cursor
hashed_idsarray- Filter subfolders by their hashed IDs
pageinteger- The page number to retrieve. This cannot be combined with `cursor`, pagination.
per_pageinteger- The number of medias per page. Use this for both offset pagination and cursor pagination.
sort_bystring- Field to sort by. When using cursor pagination (see cursor param),
only `id` is supported.
one of
namecreatedupdatedpositioniddefaultposition sort_directioninteger- Sort direction (0 = desc, 1 = asc; default is 1)one of
01default1
wistiamcp_get_tool_statusApp-only: read a previous call's saved status and UI metadata using its _mcp_tool_call_id.Read-onlyget tool status
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.
Inputs
tool_call_idintegerrequired- The _mcp_tool_call_id of the tool call whose status to read
app_only_propsobject- Reserved for the host application. Agents must always pass this as an empty object ({}) and never put anything in it. The application embedding this MCP server may populate it with its own data.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: status,metadata
wistiamcp_get_transcript_settingsRetrieves the account's transcript and caption defaults, keyword glossary and limits, plan constraints, and exact per-minute purchase rates for computer-generated, standard professional, and rushed professional transcripts.Read-onlyget transcript settings
Retrieves the account's transcript and caption defaults, keyword glossary and limits, plan constraints, and exact per-minute purchase rates for computer-generated, standard professional, and rushed professional transcripts. Rates are decimal strings with a `usd` or `credits` unit. Professional rates use Credits when enabled for the account, otherwise USD. Computer-generated rates use USD, with a zero rate when included in the plan. Rates exclude tax and subscription overages. This operation does not place a transcript order. Rates apply to ordinary transcript purchases. Complimentary automatic orders are not reflected in these rates.
Inputs
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: active,automated,rush,automatically_enable,captions_on_by_default,auto_generate_chapters,identify_speakers,keywords,keyword_limits(max_terms,max_characters,terms_remaining,characters_remaining),pricing(automated(price_per_minute,unit),standard(price_per_minute,unit),rush(price_per_minute,unit)),plan_constraints(can_disable_active,can_auto_generate_chapters)
wistiamcp_get_webinar_collaboratorsList contacts and groups with producer access to a webinar, with sorting and pagination.Read-onlyget webinar collaborators
List contacts and groups with producer access to a webinar, with sorting and pagination. Only owners, managers, and that webinar's producers can see the permitted collaborators. - Checking who can manage an upcoming broadcast. - Finding a producer's collaborator ID before revoking access. Use list-webinar-registrations for the audience.
Inputs
webinarIdstringrequired- Webinar Hashed ID (e.g., "abc123")
cursorobject- Cursor pagination. When cursor pagination is enabled, each record returned has a `cursor`: pass the last one as `cursor[after]` for the next page, or the first one as `cursor[before]` for the previous page. A cursor only works with the `sort_by` it was fetched with.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: id,role,created_at,share(id,name,type,email),cursor
pageinteger- The page number to retrieve. This cannot be combined with `cursor`, pagination.
per_pageinteger- The number of medias per page. Use this for both offset pagination and cursor pagination.
sort_bystring- Ordering. When using cursor pagination (see cursor param),
only `id` is supported.
one of
createdupdatediddefaultid sort_directioninteger- Ordering Sort Direction (0 = desc, 1 = asc; default is 1)one of
01default1
wistiamcp_get_webinarsList the account's webinars; filter by started status or fetch specific hashed IDs.Read-onlyget webinars
List the account's webinars; filter by started status or fetch specific hashed IDs. - Getting a webinar's hashed ID before registrations or analytics. No title filter: find one by name with search, content_types: ["webinar"]. Webinars require a plan that includes live streaming. Nothing here is shown to the user. When they asked to find, list, or see webinars, follow up with display-results, passing this result's `_mcp_tool_call_id`, so they get a card. Skip it when the listing is a step toward another tool.
Inputs
cursorobject- Cursor pagination. When cursor pagination is enabled, each record returned has a `cursor`: pass the last one as `cursor[after]` for the next page, or the first one as `cursor[before]` for the previous page. A cursor only works with the `sort_by` it was fetched with.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: id,hashed_id,title,description,scheduled_for,event_duration,time_zone,lifecycle_status,registration_status,created_at,updated_at,audience_link,host_link,panelist_link,thumbnail_url,folder(id,index_url,url),series(id,index_url,url),cursor
hashed_idsarray- Filter by specific webinars IDs
pageinteger- The page number to retrieve. This cannot be combined with `cursor`, pagination.
per_pageinteger- The number of medias per page. Use this for both offset pagination and cursor pagination.
sort_bystring- Field to sort by. When using cursor pagination (see cursor param),
only `id` and `scheduled_for` are supported. All other sort_by options
(`title`, `created`, `updated`) require offset pagination.
one of
scheduled_fortitlecreatedupdatedid sort_directioninteger- Sort direction (0 = desc, 1 = asc; default is 1)one of
01 startedstring- Filter by whether the webinar has started. Use "true" for webinars that have started, "false" for webinars that have not started yetone of
truefalse
wistiamcp_gets_localizationsList a media's dubbed language versions, optionally with their transcripts.Read-onlygets localizations
List a media's dubbed language versions, optionally with their transcripts. Use show-localization for one variant's details. - Check which audiences already have a dubbed version before ordering more. - Gather translated transcripts to compare regional messaging; use list-transcripts when checking subtitle tracks instead.
Inputs
mediaHashedIdstringrequired- The hashed ID of the media to list localizations for.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: hashed_id,language_code,iso639_2_language_code,language_name,native_language_name,created_at,updated_at,ordered_at,enabled_at,enabled,source_media(hashed_id,name,duration,created_at,updated_at),transcript(hashed_id,language_name,native_language_name,text,created_at,updated_at)
include_transcriptboolean- Whether to include the transcript in the response.default
false
wistiamcp_list_deleted_mediaList media still recoverable in Recently Deleted.Read-onlylist deleted media
List media still recoverable in Recently Deleted. Each restore_expires_at is its deadline, typically 30 days (14 on free plans); afterward media is permanently purged. Requires account owner or manager access. - Find an accidentally deleted video before its recovery window closes. - Identify which deleted assets can be recovered with restore-deleted-media.
Inputs
cursorobject- Cursor pagination. When cursor pagination is enabled, each record returned has a `cursor`: pass the last one as `cursor[after]` for the next page, or the first one as `cursor[before]` for the previous page. A cursor only works with the `sort_by` it was fetched with.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: hashed_id,name,type,duration,deleted_at,restore_expires_at,folder(hashed_id,name),cursor
hashed_idsarray- Restrict the results to the deleted media with these hashed IDs.
pageinteger- The page number to retrieve. This cannot be combined with `cursor`, pagination.
per_pageinteger- The number of medias per page. Use this for both offset pagination and cursor pagination.
sort_bystring- Field to order by. When omitted, results are ordered most-recently-deleted first.one of
iddeletednametypecreated sort_directioninteger- Direction to order by. (0 = desc, 1 = asc; default is 1)one of
01
wistiamcp_list_eventsList individual viewing events from the last 2 years: viewer identity, location, percent viewed, conversions.Read-onlylist events
List individual viewing events from the last 2 years: viewer identity, location, percent viewed, conversions. - See who watched a specific video (`media_id`), not just how many.
Inputs
end_datestring- End date in the format 'YYYY-MM-DD'.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: received_at,event_key,visitor_key,embed_url,percent_viewed,ip,org,country,region,city,lat,lon,email,media_id,media_name,media_url,iframe_heatmap_url,thumbnail(url,width,height,fileSize,contentType,type),conversion_type,conversion_data(email,first_name,is_new_lead,last_name),user_agent_details(browser,browser_version,platform,mobile),attributes
media_idstring- An optional identifier for a specific video.
pageinteger- The page of events to get data from.
per_pageinteger- Maximum number of events to retrieve (capped at 100).
start_datestring- Start date in the format 'YYYY-MM-DD'.
visitor_keystring- An optional identifier for a specific visitor.
wistiamcp_list_transcriptsList transcript tracks for explicitly identified media.Read-onlylist transcripts
List transcript tracks for explicitly identified media. Omit `include` for metadata-only language and version discovery; this is the default and returns no transcript text. Set `include` to exactly one of `full_text` (SRT), `segments`, or `diarized_segments` when content is needed, bounding the timed forms with `start_ms` and `end_ms`. For `diarized_segments`, `diarization_status: processing` means speaker turns are being generated, so read again shortly; `diarization_derivable: false` means none can be generated. `disabled` means speaker identification is off for the whole account, not just this media: people can still be credited, but voices can't be named. Tell the user an account owner or manager can turn it on in Account Settings. With `language` omitted, content is selected automatically only for a media with one track; several tracks return `language_required` with their exact IETF tags. Never guess a language code. Prefer `find-transcript-matches` over loading content to locate wording or prepare an edit. Media IDs are required by design: `search` finds media by what is said, and `get-medias` pages through every media. With `fields`, select through the response envelope: `results(media_hashed_id,status,tracks(id,language,english_name,native_name,version,is_draft))` for metadata, `results(media_hashed_id,status,track(id,language,version,is_draft),text)` for full text, or `results(media_hashed_id,status,segments(start_ms,end_ms))` or `results(media_hashed_id,status,diarized_segments(start_ms,end_ms,speaker(name)))` for timings without text. Size limits apply to the selected fields, so a timing-only selector can avoid text-driven size refusals. Large timing-only results still need narrower `start_ms`/`end_ms` windows.
Inputs
media_hashed_idsarrayrequired- Explicit media hashed IDs. Metadata supports up to 50; content includes support up to 10.
end_msinteger- End of an optional time window for segments or diarized_segments. Omit to run to the end.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: include,requested_count,succeeded_count,failed_count,complete,results(media_hashed_id,status,tracks(id,language,english_name,native_name,version,is_draft),track(id,language,english_name,native_name,version,is_draft),text,segments(start_ms,end_ms,text),diarized_segments(start_ms,end_ms,text,speaker(media_speaker_id,speaker_profile_id,detected_speaker_id,display_label,name)),diarization_status,diarization_derivable,speaker_data_version,content_bytes,suggested_window_ms,recovery)
includestring- Optional single content representation. Omit for metadata only.one of
full_textsegmentsdiarized_segments language_codestring- An exact IETF tag copied from a prior result, including extended tags such as zh-Hant. Omit on the first call; never infer en or eng from a language name.
start_msinteger- Start of an optional time window for segments or diarized_segments. Omit to start at the beginning.
wistiamcp_list_visitorsFind viewers by name, email, or identification status; newest-active first.Read-onlylist visitors
Find viewers by name, email, or identification status; newest-active first. Cannot filter by media; use list-events for one video's viewers. - Locate a lead's visitor key for list-events.
Inputs
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: visitor_key,created_at,last_active_at,last_event_key,identifying_event_key,load_count,play_count,visitor_identity(name,email,org(name,title)),user_agent_details(browser,browser_version,platform,mobile)
filterstring- Filtering parameter to narrow down the list of visitors.one of
has_namehas_emailidentified_by_email_gate pageinteger- The page of results based on the per_page parameter.
per_pageinteger- The maximum number of results to return, capped at 100.
searchstring- Search for visitors based on name or email address.
wistiamcp_list_webinar_registrationsRead webinar registrants with contact, attendance, engagement, and attribution data.Read-onlylist webinar registrations
Read webinar registrants with contact, attendance, engagement, and attribution data. - Building follow-up lists for attendees, no-shows, or a sales handoff. Set per_page: the effective default is 10, not 100. Page while has_next_page is true; fields must keep the wrapper: "registrations(email),page_info". Use show-webinar-analytics for aggregate totals.
Inputs
webinarIdstringrequired- Hashed ID of the webinar. (e.g., "abc123xyz")
attendancestring- Filter registrations by attendance status.one of
allattendeesnon_attendeesdefaultall cursorstring- Cursor for pagination. Use the value from the previous response's `page_info.end_cursor` or `page_info.start_cursor`.
emailsarray- Filter registrations by email addresses.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: registrations(visitor_key,email,first_name,last_name,phone_number,company,job_title,country,registered_at,attended_at,restriction_status,origin_method,form_field_data(value,label),utm_campaign,utm_source,utm_medium,utm_content,utm_term,referrer_domain,ip_region,ip_country,ip_city,engagement_rate,focused_rate,played_time,focused_played_time,chat_count,chats(rounded_player_position,chats),qa_questions(rounded_player_position,qa_questions(question_text)),qa_answers,poll_responses(poll_question_text,poll_option_text),poll_responses_count,annotation_click_count,attendee_histogram,focused_attendee_histogram),page_info(has_next_page,has_previous_page,end_cursor,start_cursor)
per_pageinteger- Number of results to return per page (max 100).default
100 restrictionstring- Filter registrations by restriction status.one of
allrestrictedalloweddefaultall sort_directioninteger- Sort direction (0 = desc/previous page, 1 = asc/next page; default is 1)one of
01default1
wistiamcp_play_mediaOpen a Wistia video or audio in an embedded player.Read-onlyplay media
Open a Wistia video or audio in an embedded player. - Watching or listening to media the user selected. - Reviewing a relevant moment with start_time.
Inputs
hashed_idstringrequired- The hashed ID of the Wistia media to play
start_timenumber- Optional playback start time in seconds. Omit to start at the beginning.
wistiamcp_propose_planCheck a plan for work the user should confirm before it runs, and get it back to show them.Read-onlypropose plan
Check a plan for work the user should confirm before it runs, and get it back to show them. Nothing runs and nothing is saved. - Confirming an order's scope and per-item rate before placing it. - Confirming a change to many items, or one that's hard to undo.
Inputs
stepsarrayrequired- The work in execution order with real counts and names, up to 8 steps of 80 characters each. A single action is one step, e.g. 'Tag 82 videos'.
titlestringrequired- The goal in at most 4 words, e.g. 'Archive 47 videos' or 'Rename folder'. Details and object names go in steps.
descriptionstring- Optional single sentence of context the title does not carry, such as the per-item rate.
wistiamcp_resolve_resource_urlsResolve a hashed ID and type to the resource's Wistia app page URL, a deep link only an authorized viewer can open.Read-onlyresolve resource urls
Resolve a hashed ID and type to the resource's Wistia app page URL, a deep link only an authorized viewer can open. - Linking a teammate to a media, folder, channel, episode, webinar, or remix just created or found. For a link someone outside the account can watch, use show-media-share-link.
Inputs
hashed_idstringrequired- The hashed ID of the resource.
typestringrequired- The kind of resource the hashed ID refers to.one of
mediafolderchannelchannel_episodewebinarremix fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: type,hashed_id,urls(show)
wistiamcp_searchSearch the library with filters, exact counts, sorting, and paging across media, folders, subfolders, channels, channel episodes, and webinars.Read-onlysearch
Search the library with filters, exact counts, sorting, and paging across media, folders, subfolders, channels, channel episodes, and webinars. - Find content by name, topic, description, or spoken words, alone or with filters ("videos over 30 minutes tagged product"). - Count matches: `per_page: 0` returns `total_count` and `counts_by_type` only. - Audit one folder, subfolder, or channel: pass its hashed ID as `in_container`. - Custom metadata audits: one search with `custom_metadata` (plus `in_container` for one folder) gives the exact `total_count` and pages through the matching media, so don't read values media by media. - Media assigned to a speaker: resolve the person with get-speakers, then pass every matching profile as `speaker_profile_ids`. A name in a title, description, or transcript is a mention, not an assignment, so don't pass it as `query`. - Who speaks in a media: add `speakers` to `fields` (`name,hashed_id,speakers`) instead of reading each media's speakers separately. Other selections: `name,hashed_id`, or `name,transcript_matches(start_time_formatted)`. - Language coverage: one search with `include_language_counts`, not one per language. Media missing a language: `not_transcript_languages` or `not_dubbed_languages`, not a diff of two lists. Codes match exactly after ISO alias normalization: `es` matches `spa`, not `es-MX`. So before a negated filter, read the scope's codes with `include_language_counts` (or reuse codes already read for it or a broader scope) and pass every variant of the language. - Spoken words: `transcript_only` finds media by what is said. Once the media are known, find-transcript-matches locates each moment and list-transcripts reads the full text. - Where an edit came from: a media's `mochine_edit_id` names the Mochine edit that produced it; get-mochine-edit reads its `source_media_ids`. Results rank by relevance unless you pass `sort`, so a small `per_page` returns the best matches, not the newest; pass `sort` for recency or name order. `total_count` is exact even when only a page comes back; page with `page` and `per_page`. Use get-medias for a plain list with no query or filters. Nothing here is shown to the user. When they asked to find or see content, follow up with display-results, passing this result's `_mcp_tool_call_id`, so they get a card; answer in prose only when they asked for data such as an ID or a count. Skip display-results when the search is a step toward another tool, such as play-media or a write.
Inputs
archivedboolean- Only archived (true) or only non-archived (false) content.
assigneesarray- Assignees, as `contact_<hashed ID>` for a contact or `group_<hashed ID>` for a contact group.
containersarray- Folder or channel names to search within. Doesn't match subfolder names; use `in_container` for those.
content_typesarray- Record types to include. `folder` matches folders and subfolders together. For a generic request for media, files, or assets, use `media` to leave out folders and channels without assuming a media subtype.
created_afterstring- Only content created at or after this time: ISO 8601 at any precision ("2026", "2026-08", "2026-08-01", or "2026-08-01T09:30:00Z") or epoch seconds. A truncated value starts at the beginning of its year, month, or day, in UTC. For a date a person names, pass ISO 8601 at the precision they gave rather than converting it to epoch seconds.
created_beforestring- Only content created at or before this time, in the same forms as `created_after`. A truncated value runs to the end of its year, month, or day, so `created_after=2026-08` with `created_before=2026-08` covers all of August 2026. Both bounds are inclusive, so "before 2026" is `created_before=2025`, and "before March 2026" is `created_before=2026-02`.
custom_metadataobject- Filter media by custom metadata field value, keyed by field key. Select and text fields take a value (`custom_metadata[region]=emea`) or an array of values matched as OR. Boolean fields take `true` or `false`. Number and time fields take an exact number or a range (`custom_metadata[budget][min]=100&custom_metadata[budget][max]=500`), and date fields a `YYYY-MM-DD` date or a range with `after` and `before`. Any field accepts `custom_metadata[region][exists]=false` to find media missing the field, or `true` for media with any value. Only media can match, so other content types are excluded. Only available on accounts with access to custom metadata.
dubbed_languagesarray- Language codes the media is dubbed into.
duration_grouparray- Duration buckets, in seconds. Pass every bucket a range covers (for example, under 5 minutes is `0-59`, `60-179`, and `180-299`).
embeddedboolean- `true` for media with at least one tracked view outside the Wistia app, `false` for media with none. A view on the media's public Wistia share page counts, so this is not strictly "embedded on a website".
exact_matchboolean- Match `query` as an exact phrase only, with no prefix or fuzzy expansion, so "power" doesn't match "powerful" (default false). Use it when the request quotes the words or asks for an exact phrase; otherwise leave it off so related word forms and close matches surface.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: type,media_type,hashed_id,name,description,url,created_at,updated_at,archived,duration,play_count,last_played_at,origin,tags,speakers,thumbnail_urls,uploaded_by,container_name,container_hashed_id,folder_hashed_id,media_count,personal_library,lifecycle_status,scheduled_for,event_duration,media_hashed_id,episode_content_hashed_id,is_published,custom_metadata_field_values(key,field_type,value(type,id),updated_at,last_write(at,source,actor(type,id,name))),mochine_edit_id,transcript_matches(text,text_highlighted,start_time_seconds,start_time_formatted)
has_transcriptboolean- Only media with at least one published transcript (true) or none (false), which restricts results to media; use false for "which videos are missing captions?". Pair it with `media_types` matching the request (videos: `Video`, audio: `Audio`, media: both), and leave out `Other`: images, documents, and logos never have captions. This checks whether a transcript exists, not whether captions are on in the player.
in_containerstring- Hashed ID of a folder, subfolder, or channel to search inside; you don't need to know which of the three it is. Cannot be combined with `containers`. A folder scope also matches that folder's subfolder records, so pair it with `media_types` or `content_types` of `media` when counting or listing media. A channel scope matches that channel's episodes, not media.
includestring- Pass `custom_metadata` to add each media result's `custom_metadata_field_values`, in the same shape as the Get Custom Metadata Field Values endpoint. Only available on accounts with access to custom metadata; other accounts receive a 403.one of
custom_metadata include_highlightsboolean- Attach transcript matches to each record: timestamped snippets of where the query matched spoken words (default false; implied by `transcript_only`).
include_language_countsboolean- Attach `transcript_language_counts` and `dubbed_language_counts`: the 100 most common languages in the matched set, each with a label and media count (default false).
last_played_afterstring- Only media last played at or after this time, in the same forms as `created_after`. Excludes media that have never been played. Play data is current as of the last day or so.
last_played_beforestring- Only media last played at or before this time, in the same forms and end-of-period rules as `created_before`, so "not played since June 2026" is `last_played_before=2026-05`. Also matches media that have never been played; for those alone, use `play_count_group[]=0`.
media_typesarray- Media subtypes to include. Set this only when the request is limited to video, audio, or another media type; "recording", "media", "file", "asset", and what the user wants done with the results (such as editing them into a video) don't imply `Video`.
not_dubbed_languagesarray- Leave out media already dubbed into any of these language codes.
not_transcript_languagesarray- Leave out media with a transcript in any of these language codes. Includes media with no published transcripts; leave `has_transcript` unset unless the request is limited to media with or without captions.
originarray- How the media was created.
pageinteger- The page of results to return (default 1). Pages reach only the first 10,000 matches, so `page` × `per_page` can't pass 10,000. To reach later records, change the filters or sort and start again at page 1.
per_pageinteger- Records per page (default 10, maximum 100). Pass 0 to return only `total_count` and `counts_by_type`.
play_count_grouparray- Play-count buckets. Pass every bucket a range covers (for example, more than 100 plays is `101-1000`, `1001-10000`, `10001-50000`, `50001-500000`, and `500001+`).
querystring- Free-text search over names, descriptions, and transcripts. Omit to match everything.
share_link_visibilityarray- Share-link visibility.
sortstring- Ordering. Omit for relevance ranking, which is what you want alongside a `query`; set it for content by recency or name ("the latest video" is `sort=newest` with `per_page=1`, not `per_page=1` alone).one of
newestoldestrecently_updatedname speaker_profile_idsarray- Speaker profile IDs, from List Speakers. Pass every matching profile; this filters assigned speakers, not people mentioned by name. A list with no ID returns 400.
tagsarray- Tag names; content with any of them matches.
transcript_languagesarray- Language codes present in the transcript.
transcript_onlyboolean- Search only spoken words in transcripts. Results are media ranked by transcript relevance, each with timestamped transcript matches (default false).
unresolved_commentsboolean- Only content with unresolved comments.
uploaded_byarray- Hashed IDs of the contacts who uploaded the media.
workflow_statusarray- Workflow status values.
wistiamcp_show_access_customizationsRead a video's saved password-protection settings.Read-onlyshow access customizations
Read a video's saved password-protection settings. - Check whether password gating was configured. - Review access settings before changing the gate.
Inputs
mediaIdstringrequired- The hashed ID of the video.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: private(password_protect_on),encrypted(password_protect_password),plugin(passwordProtectedVideo(on,challenge,src,async))
wistiamcp_show_accessibility_customizationsRead a video's explicitly-set caption display/style, transcript, and audio description.Read-onlyshow accessibility customizations
Read a video's explicitly-set caption display/style, transcript, and audio description. - Whether a caption track exists is list-transcripts, not this tool.
Inputs
mediaIdstringrequired- The hashed ID of the video.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: captionsBackgroundColor,captionsBorderRadius,captionsTextColor,captionsTextSize,captionsFontFamily,transcriptEnabled,showTranscriptSpeakers,audioDescriptionControl,plugin(captions(on,onByDefault),captions-v1(on,onByDefault),extendedAudioDescription(on))
wistiamcp_show_account_analyticsSummarize account-wide analytics for a date range.Read-onlyshow account analytics
Summarize account-wide analytics for a date range. Max 2 years (730 days). - Report reach, engagement, and form conversions. If `loads` is 0 or null, nothing was recorded in the period: report no data, not zero plays.
Inputs
end_datestringrequired- End date for the analytics period in ISO 8601 format (YYYY-MM-DD). Exclusive — the range ends before the beginning of this date. Must be on or after `start_date` and no more than 730 days after it.
start_datestringrequired- Start date for the analytics period in ISO 8601 format (YYYY-MM-DD). Inclusive — the range starts at the beginning of this date. Must be no more than 730 days before `end_date`.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: loads,unique_loads,unique_plays,plays,play_rate,played_time,unique_visitors,engagement_rate,form_conversions
wistiamcp_show_account_analytics_timeseriesGet account-wide analytics by granularity: daily, weekly, or monthly.Read-onlyshow account analytics timeseries
Get account-wide analytics by granularity: daily, weekly, or monthly. Max 2 years (730 days). - Chart growth; locate when plays or engagement shifted.
Inputs
end_datestringrequired- End date for the analytics period in ISO 8601 format (YYYY-MM-DD). Exclusive — the range ends before the beginning of this date. Must be on or after `start_date` and no more than 730 days after it.
granularitystringrequired- The time granularity for the timeseries data.one of
dailyweeklymonthly start_datestringrequired- Start date for the analytics period in ISO 8601 format (YYYY-MM-DD). Inclusive — the range starts at the beginning of this date. Must be no more than 730 days before `end_date`.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: timestamp,loads,unique_loads,unique_plays,plays,play_rate,played_time,unique_visitors,engagement_rate,form_conversions
wistiamcp_show_account_embed_locationsRank embed domains by account-wide video performance.Read-onlyshow account embed locations
Rank embed domains by account-wide video performance. Data covers the last 6 months; an older `start_date` is moved up to 6 months ago. End exclusive. - Find which sites drive the most viewing. - Compare domain engagement before prioritizing distribution.
Inputs
end_datestringrequired- End date for the analytics period in ISO 8601 format (YYYY-MM-DD). Exclusive — the range ends before the beginning of this date. Must be on or after `start_date` and no more than 730 days after it.
start_datestringrequired- Start date for the analytics period in ISO 8601 format (YYYY-MM-DD). Inclusive — the range starts at the beginning of this date. Must be no more than 730 days before `end_date`.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: embed_domain,media_count,loads,plays,play_rate,played_time,engagement_rate,unique_visitors
per_pageinteger- Number of results to return (max 100).default
10 sort_bystring- The metric to sort embed locations by.one of
playsloadsengagement_rateplay_rateplayed_timeunique_visitorsdefaultplays sort_directionstring- The sort direction.one of
ascdescdefaultdesc
wistiamcp_show_account_stats_by_dateGet legacy daily account stats; superseded by show-account-analytics- timeseries.Read-onlyshow account stats by date
Get legacy daily account stats; superseded by show-account-analytics- timeseries. Pass both dates: inclusive; omitting them errors. - Chart daily plays and watch hours.
Inputs
end_datestring- The end date for the stats, formatted YYYY-MM-DD
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: date,load_count,play_count,hours_watched
start_datestring- The start date for the stats, formatted YYYY-MM-DD
wistiamcp_show_account_top_contentRank media, channels, or folders (`group_by=project`) by performance.Read-onlyshow account top content
Rank media, channels, or folders (`group_by=project`) by performance. Max 2 years (730 days). Raise `per_page` (max 1000). One unknown `hashed_ids` value fails the call. - Find the most-played or least-engaging content for a period. - Compare a known set of videos side by side, passing their hashed_ids.
Inputs
end_datestringrequired- End date for the analytics period in ISO 8601 format (YYYY-MM-DD). Exclusive — the range ends before the beginning of this date. Must be on or after `start_date` and no more than 730 days after it.
start_datestringrequired- Start date for the analytics period in ISO 8601 format (YYYY-MM-DD). Inclusive — the range starts at the beginning of this date. Must be no more than 730 days before `end_date`.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: plays,play_rate,engagement_rate,unique_visitors,played_time,media_name,media_hashed_id,media_type,media_thumbnail_url,media_duration,media_uploaded_at,media_deleted_at,unique_loads,unique_plays,form_conversions,cta_impressions,cta_conversions,cta_conversion_rate,channel_title,channel_hashed_id,channel_episode_count,channel_created_at,channel_url,project_name,project_hashed_id,project_created_at,project_url,project_video_count
group_bystring- The type of content to rank.one of
mediachannelprojectdefaultmedia hashed_idsarray- Scope the ranking to these specific media's hashed IDs, rather than the whole account. Only valid with group_by=media.
per_pageinteger- Number of results to return. Defaults to the number of hashed_ids requested, or 10 when hashed_ids is not given.
sort_bystring- The metric to rank content by.one of
playsloadsplay_rateengagement_rateplayed_timeunique_visitorsdefaultplays sort_directionstring- The sort direction.one of
ascdescdefaultdesc
wistiamcp_show_appearance_customizationsRead a video's explicitly-set player color, gradient, corners, contrast, and logo/branding.Read-onlyshow appearance customizations
Read a video's explicitly-set player color, gradient, corners, contrast, and logo/branding. Absent means inherited, and brand-matched values are not stored. - Audit styling overrides.
Inputs
mediaIdstringrequired- The hashed ID of the video.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: playerColor,playerColorGradient(on,colors),roundedPlayer,opaqueControls,contrastIcons,branding,showCustomerLogo,customerLogoImageUrl,customerLogoTargetUrl,customerLogoPlacement,customerLogoSizePercent
wistiamcp_show_chapters_customizationsRead a media's explicitly-set chapters and visibility, video or audio.Read-onlyshow chapters customizations
Read a media's explicitly-set chapters and visibility, video or audio. - Check whether a recording has navigation.
Inputs
mediaIdstringrequired- The hashed ID of the media.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: plugin(chapters(on,visibleOnLoad,chapterList(id,title,time,deleted)),audioChapters(on,visibleOnLoad,chapterList(id,title,time,deleted)))
wistiamcp_show_current_account_statsGet legacy all-time account totals for loads, plays, and watch hours.Read-onlyshow current account stats
Get legacy all-time account totals for loads, plays, and watch hours. - Answer all-time totals; show-account-analytics caps at 2 years (730 days).
Inputs
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: load_count,play_count,hours_watched
wistiamcp_show_engagement_customizationsRead a video's saved CTAs and timed annotation links.Read-onlyshow engagement customizations
Read a video's saved CTAs and timed annotation links. - Check where a video's CTA sends viewers. - Review link timing before updating an offer.
Inputs
mediaIdstringrequired- The hashed ID of the video.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: plugin(postRoll-v1(rewatch,text,link,time,autoSize,style(backgroundColor),ctaType,on,conversionOpportunityKey),midrollLink-v1(on,links(text,url,time,duration,conversionOpportunityKey)))
wistiamcp_show_eventRead one viewing event from the last 2 years.Read-onlyshow event
Read one viewing event from the last 2 years. - Check how much a particular viewer watched and where. - Inspect a session's conversion details.
Inputs
eventKeystringrequired- The unique key of the event.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: received_at,event_key,visitor_key,embed_url,percent_viewed,ip,org,country,region,city,lat,lon,email,media_id,media_name,media_url,iframe_heatmap_url,thumbnail(url,width,height,fileSize,contentType,type),conversion_type,conversion_data(email,first_name,is_new_lead,last_name),user_agent_details(browser,browser_version,platform,mobile),attributes
wistiamcp_show_lead_capture_customizationsRead a video's saved email/form capture settings.Read-onlyshow lead capture customizations
Read a video's saved email/form capture settings. - Check which form a video uses. - Inspect form timing or skipping before changing the gate.
Inputs
mediaIdstringrequired- The hashed ID of the video.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: plugin(requireEmail-v1(on),form(on),hubspotForm(on),marketoForm(on),pardotForm(on))
wistiamcp_show_localizationRead one dubbed localization by its hashed ID, optionally including its transcript.Read-onlyshow localization
Read one dubbed localization by its hashed ID, optionally including its transcript. Find the ID with gets-localizations. - Check whether a regional version is enabled for viewers. - Review its translated wording before sharing the localized video with a regional team.
Inputs
localizationHashedIdstringrequired- The hashed ID of the localization.
mediaHashedIdstringrequired- The hashed ID of the localization's media.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: hashed_id,language_code,iso639_2_language_code,language_name,native_language_name,created_at,updated_at,ordered_at,enabled_at,enabled,source_media(hashed_id,name,duration,created_at,updated_at),transcript(hashed_id,language_name,native_language_name,text,created_at,updated_at)
include_transcriptboolean- Whether to include the transcript in the response.default
false
wistiamcp_show_media_aggregated_statsRead all-time viewing totals for one video: plays, visitors, page loads, play rate, and average percent watched.Read-onlyshow media aggregated stats
Read all-time viewing totals for one video: plays, visitors, page loads, play rate, and average percent watched. Videos only; no date filter, per-visitor, or time-series data. - Check whether a video's page gets loads but few plays. For a date range use show-media-analytics, for trends show-media-analytics-timeseries; to compare many videos use show-account-top-content.
Inputs
mediaHashedIdstringrequired- The hashed ID of the video. (e.g., "4d23503f70")
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,hashed_id,name,stats(pageLoads,visitors,percentOfVisitorsClickingPlay,plays,averagePercentWatched)
wistiamcp_show_media_analyticsSummarize a video's analytics for a date range.Read-onlyshow media analytics
Summarize a video's analytics for a date range. Max 2 years (730 days). - Report a video's reach, engagement, and conversions for a month or quarter. If `loads` is 0 or null, nothing was recorded in the period: report no data, not zero plays.
Inputs
end_datestringrequired- End date for the analytics period in ISO 8601 format (YYYY-MM-DD). Exclusive — the range ends before the beginning of this date. Must be on or after `start_date` and no more than 730 days after it.
mediaIdstringrequired- The hashed ID of the video. (e.g., "4d23503f70")
start_datestringrequired- Start date for the analytics period in ISO 8601 format (YYYY-MM-DD). Inclusive — the range starts at the beginning of this date. Must be no more than 730 days before `end_date`.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: loads,unique_loads,unique_plays,plays,play_rate,played_time,unique_visitors,engagement_rate,cta_impressions,cta_conversions,cta_conversion_rate,form_conversions
wistiamcp_show_media_analytics_timeseriesGet a video's analytics in daily, weekly, or monthly buckets.Read-onlyshow media analytics timeseries
Get a video's analytics in daily, weekly, or monthly buckets. Max 2 years (730 days); end exclusive. - Chart viewing trends and pinpoint when plays or engagement changed.
Inputs
end_datestringrequired- End date for the analytics period in ISO 8601 format (YYYY-MM-DD). Exclusive — the range ends before the beginning of this date. Must be on or after `start_date` and no more than 730 days after it.
granularitystringrequired- The time granularity for the timeseries data.one of
dailyweeklymonthly mediaIdstringrequired- The hashed ID of the video. (e.g., "4d23503f70")
start_datestringrequired- Start date for the analytics period in ISO 8601 format (YYYY-MM-DD). Inclusive — the range starts at the beginning of this date. Must be no more than 730 days before `end_date`.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: timestamp,loads,unique_loads,unique_plays,plays,play_rate,played_time,unique_visitors,engagement_rate,cta_impressions,cta_conversions,cta_conversion_rate,form_conversions
wistiamcp_show_media_embed_locationsList the pages where a video is embedded, ranked by a chosen metric; only pages with traffic in the range appear.Read-onlyshow media embed locations
List the pages where a video is embedded, ranked by a chosen metric; only pages with traffic in the range appear. Data covers the last 6 months; an older `start_date` is moved up to 6 months ago. - Compare landing pages by play rate or engagement; CTA rates reported.
Inputs
end_datestringrequired- End date for the analytics period in ISO 8601 format (YYYY-MM-DD). Exclusive — the range ends before the beginning of this date. Must be on or after `start_date` and no more than 730 days after it.
mediaIdstringrequired- The hashed ID of the video. (e.g., "4d23503f70")
start_datestringrequired- Start date for the analytics period in ISO 8601 format (YYYY-MM-DD). Inclusive — the range starts at the beginning of this date. Must be no more than 730 days before `end_date`.
embed_urlstring- Filter results to a single embed URL. When provided, only analytics for the page matching this URL are returned. The protocol is optional (https is assumed).
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: embed_domain,embed_path,embed_url,page_title,loads,unique_loads,plays,unique_plays,play_rate,played_time,engagement_rate,unique_visitors,cta_conversion_rate
per_pageinteger- Number of results to return (max 100).default
10 sort_bystring- The metric to sort embed locations by.one of
playsloadsengagement_rateplay_rateplayed_timeunique_visitorsdefaultplays sort_directionstring- The sort direction.one of
ascdescdefaultdesc
wistiamcp_show_media_embed_locations_timeseriesTrack a video's analytics by embed page over time, with an "All other" remainder.Read-onlyshow media embed locations timeseries
Track a video's analytics by embed page over time, with an "All other" remainder. Data covers the last 6 months; an older `start_date` is moved up to 6 months ago. End exclusive; `embed_url` filters to one page. - Locate which pages contributed to a traffic spike. - Compare a landing page's performance before and after a change.
Inputs
end_datestringrequired- End date for the analytics period in ISO 8601 format (YYYY-MM-DD). Exclusive — the range ends before the beginning of this date. Must be on or after `start_date` and no more than 730 days after it.
granularitystringrequired- The time granularity for the timeseries data.one of
dailyweeklymonthly mediaIdstringrequired- The hashed ID of the video. (e.g., "4d23503f70")
start_datestringrequired- Start date for the analytics period in ISO 8601 format (YYYY-MM-DD). Inclusive — the range starts at the beginning of this date. Must be no more than 730 days before `end_date`.
embed_urlstring- Filter results to a single embed URL. When provided, only analytics for the page matching this URL are returned. The protocol is optional (https is assumed).
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: timestamp,entries(embed_domain,embed_path,embed_url,page_title,loads,unique_loads,plays,unique_plays,play_rate,played_time,engagement_rate,unique_visitors,cta_conversion_rate)
per_pageinteger- Number of top embed locations per time bucket (max 100). Remaining locations are aggregated into an "All other" entry.default
5 sort_bystring- The metric used to rank and select the top embed locations.one of
playsloadsengagement_rateplay_rateplayed_timeunique_visitorsdefaultplays
wistiamcp_show_media_engagementGet engagement and rewatch curves for a video or audio file; no date filter.Read-onlyshow media engagement
Get engagement and rewatch curves for a video or audio file; no date filter. - Find sections where viewers drop off. - Spot replayed segments worth reviewing.
Inputs
mediaIdstringrequired- The hashed ID or ID of the video for which you want to retrieve engagement data. (e.g., "4d23503f70" or "22570")
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: engagement,engagement_data,rewatch_data
wistiamcp_show_media_extended_audio_descriptionGet one extended audio description (EAD).Read-onlyshow media extended audio description
Get one extended audio description (EAD). Only this tool returns assets: the MP3 download URL plus the narration itself as WebVTT cue text. - Read or check what the narration actually says. - Fetch the track to hand off for review or distribution. id is from get-media-extended-audio-descriptions.
Inputs
idstringrequired- The hashed id of the Media Extended Audio Description
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,ietf_language_tag,created_at,updated_at,media(id,index_url,url),provided_media_file(id,index_url,url),contact(id,index_url,url),cursor,assets(mp3_url,webvtt,webvtt_extended)
wistiamcp_show_media_extended_audio_description_order_statusCheck an extended audio description order.Read-onlyshow media extended audio description order status
Check an extended audio description order. Poll until order_status is completed, cancelled, or failed. - When completed, pass the returned media_extended_audio_description ID to show-media-extended-audio-description for the files. id is from order-media-extended-audio-description.
Inputs
idstringrequired- The hashed ID of the order returned from the order endpoint.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: order(id,order_status,created_at,updated_at,ietf_language_tag,media(id,index_url,url),media_extended_audio_description(id,index_url,url))
wistiamcp_show_media_form_conversionsList a video's form submissions with names, emails, and timestamps; paginated.Read-onlyshow media form conversions
List a video's form submissions with names, emails, and timestamps; paginated. Max 2 years (730 days); end exclusive. - Identify the leads a video captured. - Check whether submissions arrived during a promotion.
Inputs
end_datestringrequired- End date for the analytics period in ISO 8601 format (YYYY-MM-DD). Exclusive — the range ends before the beginning of this date. Must be on or after `start_date` and no more than 730 days after it.
mediaIdstringrequired- The hashed ID of the video. (e.g., "4d23503f70")
start_datestringrequired- Start date for the analytics period in ISO 8601 format (YYYY-MM-DD). Inclusive — the range starts at the beginning of this date. Must be no more than 730 days before `end_date`.
cursorstring- Cursor for pagination. Use the value from the previous response's page_info.end_cursor.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: data(first_name,last_name,email,converted_at,custom_fields(label,value)),page_info(has_next_page,has_previous_page,end_cursor,start_cursor)
per_pageinteger- Number of results to return (max 100).default
25
wistiamcp_show_media_languagesRank a video's plays by browser language, with caption availability.Read-onlyshow media languages
Rank a video's plays by browser language, with caption availability. Max 2 years (730 days); end exclusive. - Prioritize caption translations for the audience. - Find popular viewer languages missing captions.
Inputs
end_datestringrequired- End date for the analytics period in ISO 8601 format (YYYY-MM-DD). Exclusive — the range ends before the beginning of this date. Must be on or after `start_date` and no more than 730 days after it.
mediaIdstringrequired- The hashed ID of the video. (e.g., "4d23503f70")
start_datestringrequired- Start date for the analytics period in ISO 8601 format (YYYY-MM-DD). Inclusive — the range starts at the beginning of this date. Must be no more than 730 days before `end_date`.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: language,plays,percent_of_total_plays,captions_support
per_pageinteger- Number of results to return (max 100).default
100
wistiamcp_show_media_statsGet legacy all-time totals, engagement, and action stats for a video or audio file.Read-onlyshow media stats
Get legacy all-time totals, engagement, and action stats for a video or audio file. For a current summary use show-media-aggregated-stats. - Populate an existing Stats API report.
Inputs
mediaIdstringrequired- The hashed ID or ID of the video for which you want to retrieve stats. (e.g., "4d23503f70" or "22570")
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: load_count,play_count,play_rate,hours_watched,engagement,visitors,actions(type,action_count,impression_count,rate,url,text)
wistiamcp_show_media_stats_by_dateGet legacy daily loads, plays, and hours watched for a video or audio file.Read-onlyshow media stats by date
Get legacy daily loads, plays, and hours watched for a video or audio file. Dates are inclusive; defaults to yesterday and today. - Find days with unusual plays or watch hours.
Inputs
mediaIdstringrequired- The ID of the media
end_datestring- The end date for the stats, formatted YYYY-MM-DD
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: date,load_count,play_count,hours_watched
start_datestring- The start date for the stats, formatted YYYY-MM-DD
wistiamcp_show_media_traffic_breakdownGroup a video's analytics by UTM value, referrer, or screen size.Read-onlyshow media traffic breakdown
Group a video's analytics by UTM value, referrer, or screen size. Data covers the last 6 months; an older `start_date` is moved up to 6 months ago. End exclusive. - Compare traffic sources or UTM campaigns by plays and engagement. - Compare performance across screen sizes, for example phone versus desktop.
Inputs
end_datestringrequired- End date for the analytics period in ISO 8601 format (YYYY-MM-DD). Exclusive — the range ends before the beginning of this date. Must be on or after `start_date` and no more than 730 days after it.
group_bystringrequired- The dimension to group traffic data by.one of
utm_campaignutm_sourceutm_mediumreferrer_domainviewer_screen_size mediaIdstringrequired- The hashed ID of the video. (e.g., "4d23503f70")
start_datestringrequired- Start date for the analytics period in ISO 8601 format (YYYY-MM-DD). Inclusive — the range starts at the beginning of this date. Must be no more than 730 days before `end_date`.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: utm_campaign,utm_source,utm_medium,referrer_domain,viewer_screen_size,loads,plays,engagement_rate
per_pageinteger- Number of results to return (max 100).default
100 sort_bystring- The metric to sort results by.one of
playsloadsengagement_ratedefaultplays sort_directionstring- The sort direction.one of
ascdescdefaultdesc
wistiamcp_show_playback_customizationsRead a video's explicitly-set playback, controls, tracking (doNotTrack), and embed flags (videoFoam).Read-onlyshow playback customizations
Read a video's explicitly-set playback, controls, tracking (doNotTrack), and embed flags (videoFoam). - Explain unexpected autoplay or hidden controls.
Inputs
mediaIdstringrequired- The hashed ID of the video.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: autoPlay,silentAutoPlay,muted,volume,controlsVisibleOnLoad,playButton,smallPlayButton,playbar,volumeControl,fullscreenButton,settingsControl,playbackRateControl,qualityControl,qualityMin,qualityMax,videoQuality,hls,endVideoBehavior,playsinline,playlistLoop,playlistLinks,playPauseNotifier,playSuspendedOffScreen,resumable,preload,time,keyMoments,fullscreenOnRotateToLandscape,fakeFullScreen,videoFoam(minWidth,maxWidth,minHeight,maxHeight),wmode,bpbTime,spherical,clickForSound(showText),seo,doNotTrack,copyLinkAndThumbnailEnabled,email,googleAnalytics
wistiamcp_show_project_statsGet legacy all-time totals for one folder: loads, plays, watch hours.Read-onlyshow project stats
Get legacy all-time totals for one folder: loads, plays, watch hours. For a date range there is no folder report; use show-account-top-content with group_by=project (plays, not hours). - Compare cumulative activity across folders.
Inputs
projectIdstringrequired- The Hashed ID or ID of the project for which you want to retrieve stats. (e.g., "4d23503f70" or "22570")
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: load_count,play_count,hours_watched,number_of_videos
wistiamcp_show_sharing_customizationsRead a video's saved share-bar and download options.Read-onlyshow sharing customizations
Read a video's saved share-bar and download options. - Check whether viewers can download the video. - Inspect which share buttons (embed, email, social) are enabled. An empty result is a complete answer: nothing is saved on this video, so the player's default applies.
Inputs
mediaIdstringrequired- The hashed ID of the video.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: plugin(share(on,channels,tweetText,downloadType,overrideUrl,pageUrl,pageTitle,conversionOpportunityKey))
wistiamcp_show_thumbnail_customizationsRead a video's explicitly-set poster, alt text, fit, looping preview, and text overlay.Read-onlyshow thumbnail customizations
Read a video's explicitly-set poster, alt text, fit, looping preview, and text overlay. Empty means no override; the media's thumbnail is in get-medias. stillUrl includes any text overlay; unalteredStillImageAsset is the same image without it. Nested settings are objects; update them in the same shape. - Explain an unexpected pre-play image. - Find the image to reuse on other videos.
Inputs
mediaIdstringrequired- The hashed ID of the video.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: stillUrl,thumbnailAltText,fitStrategy,unalteredStillImageAsset(url,width,height),plugin(videoThumbnail(clickToPlayButton,clickForSound(on,showText),hashedId,trimStart,trimEnd,priorityMode),thumbnailTextOverlay-v2(on,text))
wistiamcp_show_visitorRead a visitor's identity, load/play totals, and last-active time.Read-onlyshow visitor
Read a visitor's identity, load/play totals, and last-active time. No per- video history: use list-events with `visitor_key`. - Follow `last_event_key` into show-event.
Inputs
visitorKeystringrequired- The unique key of the visitor.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: visitor_key,created_at,last_active_at,last_event_key,identifying_event_key,load_count,play_count,visitor_identity(name,email,org(name,title)),user_agent_details(browser,browser_version,platform,mobile)
wistiamcp_show_webinar_analyticsSummarize webinar registrations, attendance, engagement, and polls; only after the event ends.Read-onlyshow webinar analytics
Summarize webinar registrations, attendance, engagement, and polls; only after the event ends. Before then use list-webinar-registrations for who signed up, or show-webinar-registration-timeseries for the trend. - Report how an event performed: who attended, how long they stayed, and how they answered polls.
Inputs
webinarIdstringrequired- The hashed ID of the webinar. (e.g., "abc123xyz")
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: registrations,imported_registrations,on_demand_registrations,imported_on_demand_registrations,total_watch_time,average_watch_time,attendance,chatted_attendees,engagement_rate,chats,currently_watching,engaged_attendees,impressions,on_demand_impressions,on_demand_plays,on_demand_engagement_rate,event_time,qa_questions,poll_questions(id,poll_id,text,response_count,options(id,text,count,percent))
include_post_eventboolean- Whether to include on-demand viewing data after the live event ended.default
false post_event_end_datestring- End date for the post-event analytics period in ISO 8601 format (YYYY-MM-DD). Exclusive — the range ends before the beginning of this date. Defaults to tomorrow, so the range runs through today. Only used when include_post_event is true.
post_event_start_datestring- Start date for the post-event analytics period in ISO 8601 format (YYYY-MM-DD). Inclusive — the range starts at the beginning of this date. Defaults to the date the event ended. Only used when include_post_event is true.
wistiamcp_show_webinar_audienceList webinar registrants with attendance, attribution, and per-attendee engagement histograms.Read-onlyshow webinar audience
List webinar registrants with attendance, attribution, and per-attendee engagement histograms. - Review each registrant's engagement curve after an event. No filters here: use list-webinar-registrations (Read all data) to filter by attendance or email.
Inputs
webinarIdstringrequired- The hashed ID of the webinar. (e.g., "abc123xyz")
cursorstring- Cursor for pagination. Use the value from the previous response's page_info.end_cursor.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: data(first_name,last_name,email,phone_number,company,job_title,country,registered_at,attended_at,attendance_status,restriction_status,origin_method,utm_campaign,utm_source,utm_medium,referrer_domain,ip_country,ip_city,engagement_rate,focused_rate,played_time,focused_played_time,chat_count,annotation_click_count,poll_responses_count,attendee_histogram,focused_attendee_histogram,chats(rounded_player_position,chats)),page_info(has_next_page,has_previous_page,end_cursor,start_cursor)
per_pageinteger- Number of results to return (max 100).default
25
wistiamcp_show_webinar_histogramsGet webinar attendance, chat, and tab-focus counts in 10-second buckets.Read-onlyshow webinar histograms
Get webinar attendance, chat, and tab-focus counts in 10-second buckets. Available only after the event ends. - Find moments when the audience dropped off. - Locate lively discussion or attention peaks for event review.
Inputs
webinarIdstringrequired- The hashed ID of the webinar. (e.g., "abc123xyz")
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: attendees_histogram,chat_histogram,visual_focus_played_histogram
wistiamcp_show_webinar_registration_timeseriesGet webinar registration and completion trends by daily, weekly, or monthly bucket.Read-onlyshow webinar registration timeseries
Get webinar registration and completion trends by daily, weekly, or monthly bucket. - Monitor sign-ups while promoting an upcoming event.
Inputs
granularitystringrequired- The time granularity for the timeseries data.one of
dailyweeklymonthly webinarIdstringrequired- The hashed ID of the webinar. (e.g., "abc123xyz")
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: timestamp,registrations,impressions,on_demand_registrations,on_demand_impressions,completion_rate,on_demand_completion_rate
include_post_eventboolean- Whether to include on-demand viewing data after the live event ended.default
false post_event_end_datestring- End date for the post-event analytics period in ISO 8601 format (YYYY-MM-DD). Exclusive — the range ends before the beginning of this date. Defaults to tomorrow, so the range runs through today. Only used when include_post_event is true.
post_event_start_datestring- Start date for the post-event analytics period in ISO 8601 format (YYYY-MM-DD). Inclusive — the range starts at the beginning of this date. Defaults to the date the event ended. Only used when include_post_event is true.
wistiamcp_show_webinar_traffic_breakdownCompare webinar traffic by UTM value or referrer.Read-onlyshow webinar traffic breakdown
Compare webinar traffic by UTM value or referrer. - Find which UTM campaigns or referrers drove registrations. - Check whether a source's registrants attended.
Inputs
group_bystringrequired- The dimension to group traffic data by.one of
utm_campaignutm_sourceutm_mediumreferrer_domain webinarIdstringrequired- The hashed ID of the webinar. (e.g., "abc123xyz")
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Applies to each record; pagination metadata is always kept. Unknown fields are rejected. Fields: utm_campaign,utm_source,utm_medium,referrer_domain,registrations,attendees,impressions
sort_bystring- The metric to sort results by.one of
registrationsattendeesimpressionsdefaultregistrations sort_directionstring- The sort direction.one of
ascdescdefaultdesc
wistiamcp_assign_speakerAssign a speaker profile, found with get-speakers, to a media.Writeassign speaker
Assign a speaker profile, found with get-speakers, to a media. Always look the person up there first, even when the user names them; they are usually already in the library. To only credit the person on the media (e.g. "add Annie as a speaker"), leave out `detected_speaker_id`. Pass it only when the user says which voice is theirs (e.g. "Speaker 1 is Annie"); never guess, because every turn by that voice is renamed. For a voice assignment, read list-transcripts with `include: "diarized_segments"` and keep both `speaker.display_label` and `speaker.detected_speaker_id` in the result. Copy the ID paired with the user's display label; never derive it from that label's number, because labels follow appearance order, not ID suffixes. To merge detected speakers who are the same person, call this once per detected speaker with the same profile, passing each response's `speaker_data_version` as the next call's `expected_version`. Confirm with the user before assigning. On 409, re-read `speaker_data_version` and retry. For several videos, use create-bulk-actions with resource_type media_speaker instead of one call per video. Never write speaker names into a media's description or title in place of assigning them.
- Idempotent
Inputs
mediaHashedIdstringrequired- The hashed ID of the media to assign the speaker to.
speaker_profile_idstringrequired- The reusable speaker profile to assign, as returned by List Speakers. Look the person up there first; create a profile only when they aren't listed.
detected_speaker_idstring- Only when the user identifies which voice is this person (e.g. "Speaker 1 is Annie"): that speaker's `detected_speaker_id`, such as `default_speaker_0`, from the media's diarized transcript segments. Every turn by that voice is attributed to the profile, and assigning a second detected speaker to the same profile merges them. Omit it to credit the person on the media without naming any turns; don't guess which voice is theirs.
expected_versioninteger- The media's current `speaker_data_version` from its diarized transcript segments. Required with `detected_speaker_id`; a stale value returns 409.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: status,speaker(media_speaker_id,speaker_profile_id,name),speaker_data_version,changed_runs
wistiamcp_bulk_copy_mediaCopy, duplicate, or clone multiple medias (videos, audio, images, PDFs, or any other file type) at once into a destination folder by their hashed_ids.Writebulk copy media
Copy, duplicate, or clone multiple medias (videos, audio, images, PDFs, or any other file type) at once into a destination folder by their hashed_ids. Use this when someone wants to batch-copy or bulk-duplicate several media to another folder. Each media is duplicated and the copy placed in the specified destination folder; originals are unaffected. Processes asynchronously, returning a background_job_status to poll rather than a Media object. For copying a single media use copy-media; to relocate without duplicating use move-media.
Inputs
folder_idstringrequired- The hashed ID of the destination folder where the copies will be placed.
hashed_idsarrayrequired- An array of the media hashed IDs to be copied.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: destination(type,name,hashedId),message,background_job_status(id,hashed_id,status)
wistiamcp_bulk_tag_mediaAdd, apply, tag, label, or categorize one or more media — apply a list of tag names to video or audio files in a single batch.Writebulk tag media
Add, apply, tag, label, or categorize one or more media — apply a list of tag names to video or audio files in a single batch. Processing is asynchronous, so this returns a background_job_status object rather than the media themselves. The supplied tags are added to each media's existing tags, not replaced. Every media in the call gets the same tags. Use this when someone wants to add the same tags to one or more media while preserving existing tags, including when tagging a single media. To tag everything in a folder, subfolder, channel, or the account, use create-bulk-actions with an add_tags job scoped to it instead of listing every media ID here. When different media need different tags, use create-bulk-actions with one add_tags action per media in a single call rather than calling this tool once per media. To manage the tag definitions use create-tags, get-tags, or delete-tag. A name that matches an existing tag but is spelled differently (accents, symbols) is rejected; reuse the exact spelling from get-tags. Fails if any media would exceed 100 tags.
- Idempotent
Inputs
hashed_idsarrayrequired- An array of the media hashed IDs to be tagged.
tag_namesarrayrequired- An array of tag names to add to each media. Names are lowercased and their whitespace collapsed. Each name must be non-blank and at most 50 characters, and a request can include at most 100 names.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: message,background_job_status(id,hashed_id,status)
wistiamcp_cancel_mochine_editStop a Mochine edit's revision that is still in progress.Writecancel mochine edit
Stop a Mochine edit's revision that is still in progress. Mochine is Wistia's AI video editor. - Stopping a revision the user no longer wants, or one heading the wrong way. Billed as the app's Stop: the stopped revision's hold is usually released, but a desktop-editor turn can still be charged. current_revision stays the last finished one. get-mochine-edit shows status cancelled once it stops; 409 not_in_progress when nothing is running. To change course instead of stopping, use steer-mochine-edit while it drafts.
Inputs
editHashedIdstringrequired- The `id` of the edit.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: cursor,id,object,name,status,revision,current_revision,elements(slides,overlays,captions,narration,music,custom_motion,generative_video),motion_kit_id,source_media_ids,waiting_for(media_id,reason),created_at,updated_at,view_url,edit_url,output_media_id,error(code,message),preview(url,hls_url,poster_url,expires_at),download(url,expires_at,width,height),now_doing,findings_count,warnings(component,message,scene_number,reason),revisions(revision,revision_id,status,prompt,prompt_truncated,created_at,output_media_id,findings_count),findings(instruction,evidence,cause),transcript(text,reason,message),read(path,as_of,revision,changed_since_cursor,value,items,text,total,total_chars,from,next_read_cursor,truncated)
revisioninteger- The revision you mean to cancel. When the edit's latest revision is another, the request is rejected with 409 `revision_mismatch` and `details.current_revision`.
wistiamcp_copy_folderDuplicate a folder (formerly project), including its media and subfolders.Writecopy folder
Duplicate a folder (formerly project), including its media and subfolders. Returns a queued background job to poll. Sharing permissions are not copied; use create-folder-sharing to grant access. An optional new owner must be an account owner or manager. - Reuse a folder's structure and assets as the starting point for the next one. - Give another team a separate working copy while preserving the original; use create-folder for an empty container.
Inputs
idstringrequired- Folder Hashed ID (e.g., "4d23503f70")
adminEmailstring- The email address of the account Manager that will be the owner of the new folder. Defaults to the Account Owner if invalid or omitted.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name.
wistiamcp_copy_mediaDuplicate one media and its assets by mediaHashedId, optionally into another folder or under another owner.Writecopy media
Duplicate one media and its assets by mediaHashedId, optionally into another folder or under another owner. folder_id here is the folder's NUMERIC id from get-folders, not its hashed_id. - Create an independent version without changing the original. - Give a teammate a working copy in their folder. Use bulk-copy-media for several media (hashed folder_id) or move-media to relocate instead.
Inputs
mediaHashedIdstringrequired- The hashed ID of the media. (e.g., "4d23503f70")
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,name,type,archived,created,updated,duration,embedCode,hashed_id,description,progress,status,section,thumbnail(url,width,height),protected,folder(id,name,hashed_id)
folder_idinteger- The ID of the folder where you want the new copy placed. Defaults to the source media’s current folder if omitted or invalid.
ownerstring- An email address specifying the owner of the new media. Defaults to the source media’s current owner if omitted or invalid.
wistiamcp_copy_motion_kitCopy, duplicate, or clone a ready motion kit, built-in or custom, into a new, independent custom kit on the same account, optionally with a new name (default "<original> copy").Writecopy Mochine motion kit
Copy, duplicate, or clone a ready motion kit, built-in or custom, into a new, independent custom kit on the same account, optionally with a new name (default "<original> copy"). A kit that isn't ready returns 409 not_ready. The copy has every role's design, tokens, and fonts, and is ready at once; changing either kit never touches the other. Free: copying uses no credits, and the copy keeps the refinements the original already used.
Inputs
motionKitIdstringrequired- The id (its slug) of the kit to copy, from get-motion-kits. Built-in and custom kits both copy.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,object,kind,name,status,roles_done,roles_total,pending_roles,failed_roles,preview_iframe_url_template,created_at,updated_at,ready_at,description,when_to_use,roles(role,status,revising,phase,failure_message,rejected,warnings),logo(status,rejection_reason),revision(routed_as,reauthoring_roles,updated_tokens,message,fallback_reason),fonts(headline(family,weight),body(family,weight)),colors(accent,accent_deep,paper,ink,pop_1,pop_2),cursor
namestring- The copy's display name. Omitted or blank, it is "<original> copy".
wistiamcp_create_brandCreate a reusable brand kit for player and page colors, fonts, logos, and rounded corners.Writecreate brand
Create a reusable brand kit for player and page colors, fonts, logos, and rounded corners. It takes effect only after apply-brand. - Turning a supplied style guide into a reusable brand. - Preparing a distinct brand for a new video series or channel. name is required. Plans without multiple brands allow only one kit; edit that one with update-brand instead. Logo URLs come from get-brands, or from uploading an image with asset_type=brand_image through get-upload-credentials, where it's listed.
Inputs
body_font_familystring- The brand font family for body text.
border_radiusinteger- The border radius in pixels for rounded corners.
button_font_familystring- The brand font family for buttons.
contrast_iconsstring- Controls whether the player icon color is always white or uses an accessible contrast color when necessary.one of
enableddisabledunset fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,name,is_default,created,updated,primary_color,page_background_color,body_font_family,headline_font_family,button_font_family,border_radius,contrast_icons,opaque_controls,page_logo(url,dimensions(width,height),size),player_logo(url,dimensions(width,height),size),cursor
headline_font_familystring- The brand font family for headlines.
namestring- The brand's display name. Renaming the account-level default brand is ignored; its name is managed by Wistia.
opaque_controlsstring- Controls the opacity of the video player control bar and big play button.one of
enableddisabledunset page_background_colorstring- The brand color used for page backgrounds. Either a hex color string or a gradient represented as an array of [hexColor, percentage] tuples.
page_logoobject- The brand logo used for pages. On accounts without custom branding the player logo is ignored, but the page logo is always applied.
player_logoobject- The brand logo used for the player. Ignored on accounts whose plan doesn't include custom branding.
primary_colorstring- The primary brand color, used for primary buttons and the player playbar. Either a hex color string or a gradient represented as an array of [hexColor, percentage] tuples.
wistiamcp_create_captionsAdd an SRT caption track to a video or audio media; an existing track in that language is replaced.Writecreate captions
Add an SRT caption track to a video or audio media; an existing track in that language is replaced. - Add subtitles from a captioning vendor or a transcript the user supplies. - Add an approved translated SRT; use translate-media to have Wistia translate, or purchase-captions when the video has no transcript yet.
Inputs
caption_filestringrequired- Either an attached SRT file or a string parameter with the contents of an SRT file.
mediaHashedIdstringrequired- The hashed ID of the media for which captions are to be added.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name.
languagestring- An optional parameter that denotes which language this file represents. Should conform to ISO-639–2. If left unspecified, the language code will be detected automatically.
wistiamcp_create_channelCreate a Wistia Channel: an embeddable video gallery or podcast series.Writecreate channel
Create a Wistia Channel: an embeddable video gallery or podcast series. Add its videos with create-channel-episode. - Build a content hub of related webinars or demos. - Launch a recurring series with podcast settings so its episodes also reach a podcast feed.
Inputs
auto_publish_enabledboolean- Whether the episodes are automatically published when added to the channel. Cannot be enabled if podcasting is on.
custom_urlstring- The page on your own website where you embedded this channel.
descriptionstring- The channel's description.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,created,description,hashed_id,media_count,live_stream_event_count,name,public_url,locked,updated,auto_publish_enabled,podcast_enabled,custom_url,embedded_url,podcast_settings(copyright,episode_format,author_name,explicit,owner_name,owner_email,category1,category2,category3,language),cursor
namestring- The display name for the channel
podcast_enabledboolean- Whether podcasting is enabled for this channel.
podcast_settingsobject- Podcast specific settings for a channel. These settings only take effect if podcasting is enabled for the channel. These values appear in the channel's publicly accessible podcast RSS feed.
wistiamcp_create_channel_collaboratorInvite a person by email to a channel as an admin or viewer; sends a notification.Writecreate channel collaborator
Invite a person by email to a channel as an admin or viewer; sends a notification. - Let a teammate manage a series by granting admin access. - Give a reviewer access to a channel without management rights; check get-channel-collaborators first to avoid an existing invitation.
Inputs
channelHashedIdstringrequired- Hashed ID of the channel (e.g., "abc123")
emailstringrequired- Email address of the contact to invite. Creates a new contact if one doesn't exist.
rolestringrequired- The role to grant the collaborator.one of
adminviewer fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,role,created_at,share(id,name,type,email),cursor
wistiamcp_create_channel_episodeAdd one video or audio media as an episode in a Wistia Channel's gallery.Writecreate channel episode
Add one video or audio media as an episode in a Wistia Channel's gallery. Other media types, and media already in the channel, are rejected. Use create-bulk-actions to add many at once. media_id is required. - Add a webinar recording to a series alongside related episodes. - Prepare a podcast episode with title and notes; set publish_status explicitly, or the channel's auto-publish setting decides it.
Inputs
channelHashedIdstringrequired- The hashed ID of the channel to add the episode to.
descriptionstring- The episode's description or episode notes.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,channel_hashed_id,created,cursor,description,summary,hashed_id,media_hashed_id,live_stream_event_hashed_id,published,publish_at,title,updated,podcast_settings(episode_type,episode_number,season_number,explicit_content,hide_from_feed)
media_idstring- The alphanumeric hashed ID of the media to be added as a channel episode.
podcast_settingsobject- Podcast specific settings for a channel episode. These settings only take effect if podcasting is enabled for the channel.
publish_atstring- The date and time when the episode should be published in UTC timezone. Required when publish_status is 'scheduled'. Must be a valid ISO8601 timestamp in UTC (ending with 'Z'). Can only be provided when publish_status is 'scheduled.'
publish_statusstring- The status of whether or not the episode has been published to your channel.one of
draftpublishedscheduled summarystring- A short summary of the episode that is displayed when space is limited.
titlestring- The episode's title. If not provided, the channel episode uses the title of the media used to create it.
wistiamcp_create_folderCreate a folder to organize media.Writecreate folder
Create a folder to organize media. Use create-subfolder to nest inside an existing one, or copy-folder to duplicate with contents. - Give a campaign, client, or training set its own destination before uploading or moving media in. A personalLibrary folder is not returned by get-folders; keep the hashed_id it returns.
Inputs
adminEmailstring- The email address of the person you want to set as the owner of this folder. Defaults to the Wistia Account Owner.
anonymousCanDownloadboolean- Whether anonymous users can download media from the folder.
anonymousCanUploadboolean- Whether anonymous users can upload media to the folder.
descriptionstring- The folder’s description.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,name,description,media_count,medias(url),created,updated,hashed_id,public,public_id,anonymous_can_upload,anonymous_can_download,kind,personal_library,cursor
namestring- The name of the folder you want to create.
personalLibraryboolean- When true, creates the folder inside the requesting user's personal "My Library" (owned by them) instead of a shared account folder.
publicboolean- A flag indicating whether or not the folder is enabled for public access.
wistiamcp_create_folder_sharingShare a folder with one person by email, with optional upload, download, or reshare permission.Writecreate folder sharing
Share a folder with one person by email, with optional upload, download, or reshare permission. An email invitation is always sent; an address that already has a sharing is rejected. - Give a client review and download access; check get-folder-sharings first. - For one video use show-media-share-link; for public link access to a whole folder use update-folder (public).
Inputs
folderIdstringrequired- Hashed ID of the folder to be shared (e.g., "4d23503f70")
sharingobjectrequired- No description.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: project,sharing(id,is_admin,can_share,can_download,can_upload,share(id,name,type,email),folder(id,name),cursor)
wistiamcp_create_media_from_trimsCreate a new, shorter video by cutting exact time ranges; the source is unchanged (async).Writecreate media from trims
Create a new, shorter video by cutting exact time ranges; the source is unchanged (async). Video only. The new media inherits the source's name and folder, so rename it with update-media. - Cut dead air from the start or end of a recording before sharing it. - Extract a demo or quote at known timestamps into a standalone clip. For instruction-driven AI edits use create-mochine-edit.
Inputs
mediaHashedIdstringrequired- The hashed ID of the media.
trimsarrayrequired- An array of strings matching the format of HH:MM:SS.mmm-HH:MM:SS.mmm where HH is hours, MM is minutes, SS is seconds and mmm is milliseconds. When keep_trims is false (default), the ranges specify parts of the media to remove. When keep_trims is true, the ranges specify parts of the media to keep.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: background_job_status(id,hashed_id,status)
keep_trimsboolean- When set to true, the trims parameter is treated as ranges to keep rather than ranges to remove. Defaults to false.default
false
wistiamcp_create_mochine_editStart an AI video edit with Mochine, Wistia's AI video editor, from source_media_ids and a natural-language instruction (e.g.Writecreate mochine edit
Start an AI video edit with Mochine, Wistia's AI video editor, from source_media_ids and a natural-language instruction (e.g. "create a 60-second highlight reel", "cut the intro"), or from the instruction alone when source_media_ids is omitted (set elements.generative_video "on" for AI-generated footage). Runs asynchronously and auto-exports unless auto_export is false; follow it with get-mochine-edit every few seconds (sandboxed agents can sleep between calls), and repeat the same idempotency_key rather than resending. Spends the account's base Credit price for an edit; elements.custom_motion set to "on" costs 2 times the base price, and elements.overlays set to "off" disables Custom motion. Each AI-generated clip the edit places (elements.generative_video) spends additional Credits on top of that. Confirm the spend with the user first. A short balance is refused with 402 credits_exhausted, carrying credit_balance and credits_required in details and a message to relay.
Inputs
instructionstringrequired- What Mochine should make (e.g., "create a 60-second highlight reel").
auto_exportboolean- Export the edit to a new media when it finishes.default
true elementsobject- What the edit may add, the composer's Includes menu as one flat object. slides, overlays, captions, narration and music take "on", "auto" or "off"; "auto" leaves the element to Mochine and the instruction. The billed elements, custom_motion and generative_video, take "on" or "off". On create an omitted element is "auto" ("off" for the billed elements); on revise an omitted element keeps its previous value. overlays "off" forces custom_motion "off", matching the composer and its Credit quote. Responses list every element with the value the revision ran with.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: cursor,id,object,name,status,revision,current_revision,elements(slides,overlays,captions,narration,music,custom_motion,generative_video),motion_kit_id,source_media_ids,waiting_for(media_id,reason),created_at,updated_at,view_url,edit_url,output_media_id,error(code,message),preview(url,hls_url,poster_url,expires_at),download(url,expires_at,width,height),now_doing,findings_count,warnings(component,message,scene_number,reason),revisions(revision,revision_id,status,prompt,prompt_truncated,created_at,output_media_id,findings_count),findings(instruction,evidence,cause),transcript(text,reason,message),read(path,as_of,revision,changed_since_cursor,value,items,text,total,total_chars,from,next_read_cursor,truncated)
folder_idstring- Hashed ID of the folder the export lands in. Defaults to the folder the source media share, else a Remixes folder.
idempotency_keystring- A key unique to this request. A repeat with the same key returns the edit the first request created instead of starting another.
motion_kit_idstring- The `id` of a ready motion kit (List Motion Kits), or null for none.
namestring- A name for the edit. Defaults to one Mochine picks.
source_media_idsarray- Hashed IDs of the media to edit, in order. Each must be media you can edit; media still processing are waited for. Omit to make a video from the instruction alone.
wistiamcp_create_motion_kitCreate, make, or generate a new motion kit — a branded set of animated graphics authored by AI from a name and a creative brief, optionally styled after a brand.Writecreate Mochine motion kit
Create, make, or generate a new motion kit — a branded set of animated graphics authored by AI from a name and a creative brief, optionally styled after a brand. The brand's website is read to ground the design unless research is false. logo is {url}, {media_id} or {auto: mark | wordmark}; null means no logo and omitted means {auto: mark}. Up to four reference_images, each {url} or {media_id}, can guide the look. The kit's id is the slug of name, and a name is never reused: a taken name returns 409 name_taken with details.id (the kit holding it) and details.deleted. If deleted is false, get-motion-kit with that id shows whether it is ready to use; otherwise choose another name. The kit comes back as authoring; call get-motion-kit until status is ready. Charged like the editor's kit creation; a 402 credits_exhausted means the account needs more Credits. Pass idempotency_key to make a retry safe.
Inputs
briefstringrequired- The creative brief the kit is authored from.
namestringrequired- The kit's display name. Its slug becomes the kit's `id`.
brandstring- The brand name or domain to style the kit after.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,object,kind,name,status,roles_done,roles_total,pending_roles,failed_roles,preview_iframe_url_template,created_at,updated_at,ready_at,description,when_to_use,roles(role,status,revising,phase,failure_message,rejected,warnings),logo(status,rejection_reason),revision(routed_as,reauthoring_roles,updated_tokens,message,fallback_reason),fonts(headline(family,weight),body(family,weight)),colors(accent,accent_deep,paper,ink,pop_1,pop_2),cursor
idempotency_keystring- A key that makes the request safe to retry. A replay with the same key returns the original kit, never a second charge.
logostring- The kit's logo. Null means no logo; omitted means `{"auto": "mark"}`.
reference_imagesarray- Up to four images to guide the kit's look. An image that can't be fetched or used is skipped.
researchboolean- Set to false to skip reading the brand's website.default
true websitestring- The brand's website to read for its look. A bare domain is read over https.
wistiamcp_create_recording_roomCreate a Record recording room: a place where a host records with any guest who joins, as often as they like.Writecreate recording room
Create a Record recording room: a place where a host records with any guest who joins, as often as they like. Returns the room's `host_url` for the host and its `guest_url` to share, for example in a calendar invite. The app calls these reusable recording links. The slug becomes the end of both URLs, so pick a short, readable one (lowercase letters, numbers, hyphens, underscores). It must be unique in the account; call get-recording-rooms first if a matching room may already exist.
Inputs
slugstringrequired- The room's name, used as the last part of its URLs. Lowercase letters, numbers, hyphens and underscores only, with at least one letter or number, and unique within the account.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: slug,host_url,guest_url,requires_manual_admission,created,cursor
requires_manual_admissionboolean- Whether the host has to let each guest in. Defaults to false, so guests join as soon as they open the guest link.default
false
wistiamcp_create_review_bundleCreate one public review link covering up to 25 media from any folders.Writecreate review bundle
Create one public review link covering up to 25 media from any folders. - Sharing several draft videos together for feedback or approval. Choose this for any request to share multiple media for review, even if the user does not say "review bundle". Requires the bulk share for review feature; on 403, fall back to per-media show-media-share-link.
Inputs
media_hashed_idsarrayrequired- The hashed ids of the media to include in the bundle. Limited to 25 media.
namestringrequired- The bundle display name.
allow_downloadsboolean- Whether the videos in the bundle can be downloaded.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: hashed_id,name,url,allow_downloads,cursor
wistiamcp_create_speakerAdd a new person to the account's speaker library.Writecreate speaker
Add a new person to the account's speaker library. Only use this after get-speakers shows the person isn't already there, and confirm with the user first: names are not unique, so this always creates another profile, even when one with the same name exists. Creating a profile doesn't assign it to any media. Requires an account owner or manager.
Inputs
namestringrequired- The speaker's display name. Leading and trailing whitespace is removed.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: speaker_profile_id,name,title,image_url,cursor
titlestring- The speaker's title. Leading and trailing whitespace is removed. Omit it, or send null or an empty string, to leave it unset.
wistiamcp_create_subfolderCreate a subfolder inside a folder (formerly project), at the next available position.Writecreate subfolder
Create a subfolder inside a folder (formerly project), at the next available position. For several, use create-bulk-actions with resource_type "subfolder". - Separate drafts from approved media within one folder. - Organize a training library into topics while keeping a common parent folder; use create-folder for a separate top-level container.
Inputs
folderIdstringrequired- The hashed ID of the folder
namestringrequired- The display name of the subfolder.
descriptionstring- A description for the subfolder.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: hashed_id,name,description,position,created,updated,cursor
wistiamcp_create_webinarCreate a scheduled live event.Writecreate webinar
Create a scheduled live event. - Scheduling a live product demo or the next event in a series. scheduled_for must be a future time. Use create-webinar-registration to enroll an attendee after creation.
Inputs
event_durationintegerrequired- Duration of the event in minutes (minimum 15)
scheduled_forstringrequired- The scheduled start time as a UTC formatted ISO 8601 string (offset `Z` or `+00:00`).
time_zonestringrequired- The IANA time zone identifier the webinar is scheduled in.
titlestringrequired- The title of the webinar
descriptionstring- The description of the webinar
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,hashed_id,title,description,scheduled_for,event_duration,time_zone,lifecycle_status,registration_status,created_at,updated_at,audience_link,host_link,panelist_link,thumbnail_url,folder(id,index_url,url),series(id,index_url,url),cursor
folder_idstring- Hashed ID of the folder to place this webinar in. Defaults to the account's default webinar folder if not provided.
wistiamcp_create_webinar_collaboratorGrant a contact producer access to a webinar by email; Wistia emails them an invitation.Writecreate webinar collaborator
Grant a contact producer access to a webinar by email; Wistia emails them an invitation. - Adding a teammate or backup producer to a live event. Owners and managers already have access and cannot be added. Use create-webinar-registration to enroll an audience member.
Inputs
emailstringrequired- Email address of the contact to invite. Creates a new contact if one doesn't exist. Note that viewers cannot be webinar collaborators.
webinarIdstringrequired- Hashed ID of the webinar (e.g., "abc123")
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,role,created_at,share(id,name,type,email),cursor
wistiamcp_create_webinar_registrationRegister a person for a webinar.Writecreate webinar registration
Register a person for a webinar. Returns visitor_key and personalized_event_url. - Enrolling a requested attendee in an upcoming event. Processed asynchronously: a new registrant may not appear in list-webinar-registrations right away.
Inputs
emailstringrequired- Email address of the registrant
first_namestringrequired- First name of the registrant
last_namestringrequired- Last name of the registrant
webinarIdstringrequired- Hashed ID of the webinar (e.g., "abc123xyz")
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: visitor_key,personalized_event_url
wistiamcp_export_mochine_editExport a Mochine edit to a media, or file an exported one in a folder or under a name.Writeexport mochine edit
Export a Mochine edit to a media, or file an exported one in a folder or under a name. Mochine is Wistia's AI video editor. Edits auto-export by default, so this usually only moves or renames that media. If the edit was changed in the app since, it renders again in place and folder_id is ignored. - Exporting an edit started with auto_export false. - Filing a finished edit in a specific folder or giving it a final title. Exports the edit's current_revision. Requires a get-mochine-edit status of ready or later; 409 not_ready while a revision runs (retry after details.retry_after seconds). Pass revision to export only if current_revision is still the one you reviewed (409 revision_mismatch otherwise).
- Idempotent
Inputs
editHashedIdstringrequired- The `id` of the edit.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: cursor,id,object,name,status,revision,current_revision,elements(slides,overlays,captions,narration,music,custom_motion,generative_video),motion_kit_id,source_media_ids,waiting_for(media_id,reason),created_at,updated_at,view_url,edit_url,output_media_id,error(code,message),preview(url,hls_url,poster_url,expires_at),download(url,expires_at,width,height),now_doing,findings_count,warnings(component,message,scene_number,reason),revisions(revision,revision_id,status,prompt,prompt_truncated,created_at,output_media_id,findings_count),findings(instruction,evidence,cause),transcript(text,reason,message),read(path,as_of,revision,changed_since_cursor,value,items,text,total,total_chars,from,next_read_cursor,truncated)
folder_idstring- Hashed ID of the destination folder. Defaults to the output media's current folder, else the source media's folder.
media_namestring- Name for the exported media.
revisioninteger- The revision you mean to export. When the edit's current revision is another, the request is rejected with 409 `revision_mismatch` and `details.current_revision`.
wistiamcp_get_upload_credentialsGet an upload_url and short-lived credentials to POST a file from your own environment to Wistia, with a command such as curl.Writeget upload credentials
Get an upload_url and short-lived credentials to POST a file from your own environment to Wistia, with a command such as curl. For a file on the user's device, use upload-media-to-folder, which opens Wistia's uploader where the host can show one. - Uploading a local video, audio file, image or PDF into a folder. - Uploading a logo to pass to create-brand or update-brand. Send a multipart POST to upload_url with header "Authorization: <authorization_scheme> <authorization_token>", every form field before the file part: curl -X POST <upload_url> -H "Authorization: <scheme> <token>" -F project_id=<folder_id> -F file=@video.mp4 With folder_id, send project_id and an optional name; the response has the new media's hashed_id. With asset_type brand_image, send asset_type=brand_image in place of project_id; pass the response's asset.url as page_logo.url or player_logo.url.
- Idempotent
Inputs
asset_typestring- Mint credentials for an asset upload instead of a media upload. brand_image: an image for the account's brand library, usable as a brand's page or player logo; no folder_id is needed.one of
brand_image fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: authorization_token,authorization_scheme,upload_url
folder_idstring- The hashed ID of the Wistia folder (project) a media upload targets. Required unless asset_type is given.
wistiamcp_get_upload_tokenGet short-lived upload credentials and the upload_url to send them to.Writeget upload token
Get short-lived upload credentials and the upload_url to send them to. Pass folder_id for a media upload, or asset_type "brand_image" for an image that joins the account's brand library. In MCP App hosts the embedded uploader calls this itself; do not call it directly there. - Completing a headless upload with the upload_url this returns. - Adding a logo to pass to create-brand or update-brand. Headless clients send a multipart POST to upload_url with header "Authorization: <authorization_scheme> <authorization_token>" and the form fields before the file part. A media upload sends file, project_id (folder_id) and optional name, and returns the new media's hashed_id. A brand image sends asset_type=brand_image in place of project_id, and its asset.url is the delivery URL for page_logo.url or player_logo.url.
- Idempotent
Inputs
app_only_propsobject- Reserved for the host application. Agents must always pass this as an empty object ({}) and never put anything in it. The application embedding this MCP server may populate it with its own data.
asset_typestring- Mint credentials for an asset upload instead of a media upload. brand_image: an image for the account's brand library, usable as a brand's page or player logo; no folder_id is needed.one of
brand_image fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: authorization_token,authorization_scheme,upload_url
folder_idstring- The hashed ID of the Wistia folder (project) a media upload targets. Required unless asset_type is given.
wistiamcp_import_media_from_urlImport a media file from a public direct-download URL, or one YouTube video (youtube.com/watch?v= or youtu.be), into a folder (async).Writeimport media from url
Import a media file from a public direct-download URL, or one YouTube video (youtube.com/watch?v= or youtu.be), into a folder (async). vimeo.com, wistia.com, and non-public hosts are rejected. Omitting folder_id creates an "Untitled Folder". - Bring an externally hosted recording or YouTube video into Wistia. - Feed an ingestion pipeline from CDN or cloud-storage links. For local files use upload-media-to-folder.
Inputs
urlstringrequired- The publicly accessible URL of the media file to import.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: message,background_job_status(id,hashed_id,status)
folder_idstring- The hashed ID of the folder (project) to import the media into. If not provided, a new folder will be created.
wistiamcp_move_mediaRelocate up to 100 media to one folder and optional subfolder by hashed IDs.Writemove media
Relocate up to 100 media to one folder and optional subfolder by hashed IDs. Returns a background_job_status to poll; limited to 10 requests per 5 minutes. - Consolidate related videos scattered across folders. - File uploads into an existing team workspace; use create-bulk-actions for larger moves, multiple destinations, or mixed actions, and copy-media to duplicate.
- Idempotent
Inputs
folder_idstringrequired- The hashed ID of the folder where you want the media moved.
hashed_idsarrayrequired- An array of the media hashed IDs to be moved.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: message,background_job_status(id,hashed_id,status)
subfolder_idstring- Optional. The hashed ID of the subfolder where you want the media moved. If not provided, media will be moved to the folder's default subfolder. The subfolder must belong to the specified folder.
wistiamcp_publish_channel_episodeMake a channel episode visible to viewers by channelEpisodeHashedId, or set publish_at (UTC) to schedule it instead.Writepublish channel episode
Make a channel episode visible to viewers by channelEpisodeHashedId, or set publish_at (UTC) to schedule it instead. Publishing can email the channel's subscribers when its message is set to send on publish. - Schedule an installment for a launch; find it with get-channel-episodes and hide it later with un-publish-channel-episode.
- Idempotent
Inputs
channelEpisodeHashedIdstringrequired- The hashed id of the Channel Episode
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,channel_hashed_id,created,cursor,description,summary,hashed_id,media_hashed_id,live_stream_event_hashed_id,published,publish_at,title,updated,podcast_settings(episode_type,episode_number,season_number,explicit_content,hide_from_feed)
publish_atstring- The date and time when the episode is scheduled to be published in UTC timezone.
wistiamcp_restore_deleted_mediaRecover up to 1000 recently deleted media, while inside their restore window (async).Writerestore deleted media
Recover up to 1000 recently deleted media, while inside their restore window (async). Requires account owner or manager access. - Undo an accidental deletion before the media is permanently purged. - Pull recoverable assets into a new working folder. Use restore-media for archived items instead.
- Idempotent
Inputs
media_hashed_idsarrayrequired- The hashed ids of the soft-deleted media to restore. Up to 1000 at a time.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name.
folder_idstring- Optional hashed id of the folder to restore the media into. If omitted, each media returns to the folder it was deleted from.
wistiamcp_restore_mediaRestore up to 100 archived media into a folder (async).Writerestore media
Restore up to 100 archived media into a folder (async). Requires the Archiving feature and owner/manager access. - Bring seasonal videos back into active use when they are needed again. Use restore-deleted-media for items in Recently Deleted instead.
- Idempotent
Inputs
folder_idstringrequired- The hashed ID of the folder to restore the medias to.
hashed_idsarrayrequired- An array of the media hashed IDs to be restored.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: container(type,name,hashedId),message,background_job_status(id,hashed_id,status)
wistiamcp_retry_motion_kitRetry a motion kit's failed roles as they were briefed.Writeretry Mochine motion kit
Retry a motion kit's failed roles as they were briefed. Without roles it retries every role in failed_roles. The roles move back to pending_roles; call get-motion-kit until pending_roles is empty. Free: a retry uses no Credits. 409 nothing_to_retry when no role failed or the kit was stopped. A 409 anchor_failed means the anchor role lower-third failed before anything else authored, so retrying can't help: create a new kit under a different name (this name stays taken) and delete this one if unwanted. To change a role, use revise-motion-kit.
Inputs
motionKitIdstringrequired- The kit's id (its slug), from get-motion-kits.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,object,kind,name,status,roles_done,roles_total,pending_roles,failed_roles,preview_iframe_url_template,created_at,updated_at,ready_at,description,when_to_use,roles(role,status,revising,phase,failure_message,rejected,warnings),logo(status,rejection_reason),revision(routed_as,reauthoring_roles,updated_tokens,message,fallback_reason),fonts(headline(family,weight),body(family,weight)),colors(accent,accent_deep,paper,ink,pop_1,pop_2),cursor
rolesarray- Failed roles to retry. Defaults to every failed role.
wistiamcp_revert_mochine_editMake an earlier finished revision of a Mochine edit the current one, as the app's Restore does; the next revise-mochine-edit builds on it.Writerevert mochine edit
Make an earlier finished revision of a Mochine edit the current one, as the app's Restore does; the next revise-mochine-edit builds on it. Free. Mochine is Wistia's AI video editor. - Going back after a revision the user doesn't like. The export keeps its render until export-mochine-edit runs again. 409 revision_in_progress while a revision runs.
- Idempotent
Inputs
editHashedIdstringrequired- The `id` of the edit.
revisionintegerrequired- The finished revision to make current.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: cursor,id,object,name,status,revision,current_revision,elements(slides,overlays,captions,narration,music,custom_motion,generative_video),motion_kit_id,source_media_ids,waiting_for(media_id,reason),created_at,updated_at,view_url,edit_url,output_media_id,error(code,message),preview(url,hls_url,poster_url,expires_at),download(url,expires_at,width,height),now_doing,findings_count,warnings(component,message,scene_number,reason),revisions(revision,revision_id,status,prompt,prompt_truncated,created_at,output_media_id,findings_count),findings(instruction,evidence,cause),transcript(text,reason,message),read(path,as_of,revision,changed_since_cursor,value,items,text,total,total_chars,from,next_read_cursor,truncated)
wistiamcp_revise_mochine_editStart a new revision of a finished Mochine edit from an instruction.Writerevise mochine edit
Start a new revision of a finished Mochine edit from an instruction. Spends the account's base Credit price again (2 times with elements.custom_motion "on"; omitted elements keep the previous revision's). Confirm the spend with the user first. A short balance is refused with 402 credits_exhausted, carrying credit_balance and credits_required in details. 409 revision_in_progress while a revision runs: steer-mochine-edit redirects a drafting one for free, and cancel-mochine-edit stops it, billed as the app's Stop (usually released, though a desktop-editor turn can still be charged). revert-mochine-edit makes an earlier revision current for free. Check get-mochine-edit instead of resending a call.
Inputs
editHashedIdstringrequired- The `id` of the edit.
instructionstringrequired- What Mochine should change (e.g., "make it shorter").
add_source_media_idsarray- Hashed IDs of media to add to the edit's sources. Each must be media you can edit.
auto_exportboolean- Export the revision to a new media when it finishes. Defaults to the previous revision's setting.
base_revisioninteger- The `current_revision` you last read. Rejected with 409 `not_current_revision` when it is no longer current.
elementsobject- What the edit may add, the composer's Includes menu as one flat object. slides, overlays, captions, narration and music take "on", "auto" or "off"; "auto" leaves the element to Mochine and the instruction. The billed elements, custom_motion and generative_video, take "on" or "off". On create an omitted element is "auto" ("off" for the billed elements); on revise an omitted element keeps its previous value. overlays "off" forces custom_motion "off", matching the composer and its Credit quote. Responses list every element with the value the revision ran with.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: cursor,id,object,name,status,revision,current_revision,elements(slides,overlays,captions,narration,music,custom_motion,generative_video),motion_kit_id,source_media_ids,waiting_for(media_id,reason),created_at,updated_at,view_url,edit_url,output_media_id,error(code,message),preview(url,hls_url,poster_url,expires_at),download(url,expires_at,width,height),now_doing,findings_count,warnings(component,message,scene_number,reason),revisions(revision,revision_id,status,prompt,prompt_truncated,created_at,output_media_id,findings_count),findings(instruction,evidence,cause),transcript(text,reason,message),read(path,as_of,revision,changed_since_cursor,value,items,text,total,total_chars,from,next_read_cursor,truncated)
motion_kit_idstring- The `id` of a ready motion kit (List Motion Kits), or null for none. Omit to keep the previous revision's.
wistiamcp_revise_motion_kitRevise, change, edit, or refine a motion kit.Writerevise Mochine motion kit
Revise, change, edit, or refine a motion kit. Describe the change in instruction ("make the accent navy", "use a serif for titles", "make the lower third less busy"): a color or font change is applied to the palette at once, and a change to specific treatments re-authors only those in the background. Pass roles to say which treatments to re-author; a palette-wide color change ("warmer accents") with no reference_images still edits the palette. Up to four reference_images, each {url} or {media_id}, can guide the change. The result's revision says what ran and pending_roles shows what is re-authoring; call get-motion-kit until pending_roles is empty. A 422 needs_decision changed nothing: ask the user to choose from details.options, then call again with a concrete instruction. The logo can't be swapped or removed, only recolored (422 logo_change_refused). Built-in kits can't be revised (403 builtin_kit); copy one first. To retry roles that failed, use retry-motion-kit. A 409 anchor_failed means the anchor role lower-third failed before anything else authored, so the kit can't be revised or retried: create a new kit under a different name (this name stays taken) and delete this one if unwanted. Charged like an editor refinement; a 402 credits_exhausted means the account needs more Credits.
Inputs
instructionstringrequired- The change to make, in plain language.
motionKitIdstringrequired- The kit's id (its slug), from get-motion-kits.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,object,kind,name,status,roles_done,roles_total,pending_roles,failed_roles,preview_iframe_url_template,created_at,updated_at,ready_at,description,when_to_use,roles(role,status,revising,phase,failure_message,rejected,warnings),logo(status,rejection_reason),revision(routed_as,reauthoring_roles,updated_tokens,message,fallback_reason),fonts(headline(family,weight),body(family,weight)),colors(accent,accent_deep,paper,ink,pop_1,pop_2),cursor
reference_imagesarray- Up to four images to guide the change.
rolesarray- Roles to re-author: lower-third, title, transition, quote, word-stack, stat-callout, bullet-list, or captions. Re-authors these roles instead of routing, unless the instruction is a palette-wide color change with no reference images, which edits the palette.
wistiamcp_set_tool_statusApp-only: save a call's lifecycle status and optional UI metadata using its _mcp_tool_call_id.Writeset tool status
App-only: save a call's lifecycle status and optional UI metadata using its _mcp_tool_call_id. - Recording upload progress so the widget survives a refresh. - Saving completed widget state for a reopened conversation.
- Idempotent
Inputs
statusstringrequired- The lifecycle status to recordone of
startedin_progresscompletedfailed tool_call_idintegerrequired- The _mcp_tool_call_id of the tool call this status belongs to
app_only_propsobject- Reserved for the host application. Agents must always pass this as an empty object ({}) and never put anything in it. The application embedding this MCP server may populate it with its own data.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: ok
metadataobject- Optional UI-restore data to store with the status (left unchanged when omitted)
wistiamcp_steer_mochine_editRedirect a Mochine edit's revision while it is still drafting, free of charge.Writesteer mochine edit
Redirect a Mochine edit's revision while it is still drafting, free of charge. Mochine is Wistia's AI video editor. - Correcting course mid-run: "actually keep the intro". Only instruction and the unbilled elements (slides, overlays, captions, narration, music). 409 not_steerable once it is rendering or done; then use revise-mochine-edit.
Inputs
editHashedIdstringrequired- The `id` of the edit.
instructionstringrequired- What the running revision should do differently.
elementsobject- Elements a steer may change: the unbilled ones, each "on", "auto" or "off". custom_motion and generative_video are set only by revising.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: cursor,id,object,name,status,revision,current_revision,elements(slides,overlays,captions,narration,music,custom_motion,generative_video),motion_kit_id,source_media_ids,waiting_for(media_id,reason),created_at,updated_at,view_url,edit_url,output_media_id,error(code,message),preview(url,hls_url,poster_url,expires_at),download(url,expires_at,width,height),now_doing,findings_count,warnings(component,message,scene_number,reason),revisions(revision,revision_id,status,prompt,prompt_truncated,created_at,output_media_id,findings_count),findings(instruction,evidence,cause),transcript(text,reason,message),read(path,as_of,revision,changed_since_cursor,value,items,text,total,total_chars,from,next_read_cursor,truncated)
revisioninteger- The revision you last read. When the edit's latest revision is another, the request is rejected with 409 `revision_mismatch` and `details.current_revision`.
wistiamcp_submit_mcp_feedbackSend Wistia feedback tied to a previous response's _mcp_tool_call_id.Writesubmit mcp feedback
Send Wistia feedback tied to a previous response's _mcp_tool_call_id. Rate 5 for positive/helpful or 1 for negative/unhelpful. - Reporting an incorrect or confusing tool result with an explanation. - Highlighting an especially useful result to improve future tools.
- Idempotent
Inputs
mcp_tool_call_idintegerrequired- The _mcp_tool_call_id from the tool call response you are giving feedback on
ratingintegerrequired- Rating: 5 = positive/helpful, 1 = negative/unhelpful
commentsstring- Explain what was good or bad about the tool call result
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name.
wistiamcp_translate_mediaTranslate the transcript or captions of a media (a video or audio file) into another language by hashed_id.Writetranslate media
Translate the transcript or captions of a media (a video or audio file) into another language by hashed_id. Use this when someone wants to translate, localize, or generate foreign-language captions/subtitles for a video's transcript. Specify a target_language (and optional source_language) using the bibliographic ISO 639-2 form or a supported regional or script IETF tag. Runs asynchronously, returning a background_job_status to poll; adds a new translated transcript without modifying existing ones. For eligible Credits accounts, confirm the supplied Text translation Credit rate before ordering and relay the Credits held, charged, or released in the result message. Held Credits are charged on completion and released on failure.
Inputs
mediaHashedIdstringrequired- The hashed ID of the media.
target_languagestringrequired- The language to translate the transcript to. Use the bibliographic ISO 639-2 form or a supported regional or script IETF tag.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: message,background_job_status(id,hashed_id,status)
source_languagestring- The language of the source transcript. Use the bibliographic ISO 639-2 form or a supported regional or script IETF tag. If not provided, the media's default transcript language will be used.
wistiamcp_un_publish_channel_episodeHide a channel episode without deleting it, by channelEpisodeHashedId, and cancel any subscriber message not yet sent.Writeun publish channel episode
Hide a channel episode without deleting it, by channelEpisodeHashedId, and cancel any subscriber message not yet sent. publish-channel-episode makes it visible again. - Withdraw an episode while its content is corrected, or pull a time-sensitive promotion once it is over.
- Idempotent
Inputs
channelEpisodeHashedIdstringrequired- The hashed id of the Channel Episode
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,channel_hashed_id,created,cursor,description,summary,hashed_id,media_hashed_id,live_stream_event_hashed_id,published,publish_at,title,updated,podcast_settings(episode_type,episode_number,season_number,explicit_content,hide_from_feed)
wistiamcp_update_access_customizationsUpdate a video's password protection.Writeupdate access customizations
Update a video's password protection. Gating playback requires `plugin.passwordProtectedVideo.on`, the flag the player enforces, plus `private.password_protect_on` and the password. Plans without password protection get a 200 that saves nothing. - Gate a private preview, or change or disable its password.
- Idempotent
Inputs
mediaIdstringrequired- The hashed ID of the video to be customized.
encryptedobject- No description.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: private(password_protect_on),encrypted(password_protect_password),plugin(passwordProtectedVideo(on,challenge,src,async))
pluginobject- No description.
privateobject- No description.
wistiamcp_update_accessibility_customizationsPartially update caption display/style, transcript display, or audio description; it adds no caption tracks (use create-captions).Writeupdate accessibility customizations
Partially update caption display/style, transcript display, or audio description; it adds no caption tracks (use create-captions). Set both `plugin.captions` and `plugin.captions-v1`: no sync here, and the embed reads the legacy key. - Show captions on by default.
- Idempotent
Inputs
mediaIdstringrequired- The hashed ID of the video to be customized.
audioDescriptionControlboolean- If true, the audio description control is available to viewers.
captionsBackgroundColorstring- Background color of the captions as a hexadecimal RGB string (no leading '#').
captionsBorderRadiusinteger- Corner radius of the captions background in pixels.
captionsFontFamilystring- Font family used for the captions text.
captionsTextColorstring- Color of the captions text as a hexadecimal RGB string (no leading '#').
captionsTextSizeinteger- Size of the captions text in pixels.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: captionsBackgroundColor,captionsBorderRadius,captionsTextColor,captionsTextSize,captionsFontFamily,transcriptEnabled,showTranscriptSpeakers,audioDescriptionControl,plugin(captions(on,onByDefault),captions-v1(on,onByDefault),extendedAudioDescription(on))
pluginobject- No description.
showTranscriptSpeakersboolean- If true, speaker labels are displayed in the transcript.
transcriptEnabledboolean- If true, the interactive transcript is shown alongside the video.
wistiamcp_update_appearance_customizationsPartially update player color, gradient, corners, contrast, and logo/branding.Writeupdate appearance customizations
Partially update player color, gradient, corners, contrast, and logo/branding. Customer-logo fields drop silently without the custom-branding plan. Playback is update-playback-customizations; apply-brand styles a folder; on this media it clears these. - Recolor a player or swap a logo.
- Idempotent
Inputs
mediaIdstringrequired- The hashed ID of the video to be customized.
brandingboolean- If false, Wistia branding is hidden on the player.
contrastIconsboolean- If true, control icons use a higher-contrast treatment.
customerLogoImageUrlstring- URL of the customer logo image to display on the player.
customerLogoPlacementstring- Placement of the customer logo on the player (e.g. top-right).
customerLogoSizePercentinteger- Size of the customer logo as a percentage of the player.
customerLogoTargetUrlstring- URL the customer logo links to when clicked.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: playerColor,playerColorGradient(on,colors),roundedPlayer,opaqueControls,contrastIcons,branding,showCustomerLogo,customerLogoImageUrl,customerLogoTargetUrl,customerLogoPlacement,customerLogoSizePercent
opaqueControlsboolean- If true, player controls render on an opaque background.
playerColorstring- Base color of the player as a hexadecimal RGB string (no leading '#').
playerColorGradientobject- Optional gradient applied to the player color.
roundedPlayerinteger- Corner radius of the player in pixels. 0 disables rounding.
showCustomerLogoboolean- If true, your customer logo is shown on the player.
wistiamcp_update_channelUpdate a channel's name, description, custom URL, auto-publishing, or podcast settings by channelHashedId.Writeupdate channel
Update a channel's name, description, custom URL, auto-publishing, or podcast settings by channelHashedId. Supplied values replace existing values. - Rename a repositioned series, or correct podcast ownership and category metadata for distribution.
- Idempotent
Inputs
channelHashedIdstringrequired- The hashed id of the Channel
auto_publish_enabledboolean- Whether the episodes are automatically published when added to the channel. Cannot be enabled if podcasting is on.
custom_urlstring- The page on your own website where you embedded this channel.
descriptionstring- The channel's description.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,created,description,hashed_id,media_count,live_stream_event_count,name,public_url,locked,updated,auto_publish_enabled,podcast_enabled,custom_url,embedded_url,podcast_settings(copyright,episode_format,author_name,explicit,owner_name,owner_email,category1,category2,category3,language),cursor
namestring- The display name for the channel
podcast_enabledboolean- Whether podcasting is enabled for this channel.
podcast_settingsobject- Podcast specific settings for a channel. These settings only take effect if podcasting is enabled for the channel. These values appear in the channel's publicly accessible podcast RSS feed.
wistiamcp_update_channel_episodeUpdate a channel episode by channelEpisodeHashedId (from get-channel-episodes): title, podcast_settings, episode_notes (the response's description) and description (its summary).Writeupdate channel episode
Update a channel episode by channelEpisodeHashedId (from get-channel-episodes): title, podcast_settings, episode_notes (the response's description) and description (its summary). - Correct episode notes or retitle a video. - Set podcast season/episode numbers or hide an episode from the podcast feed; use publish-channel-episode / un-publish-channel-episode for gallery visibility.
- Idempotent
Inputs
channelEpisodeHashedIdstringrequired- The hashed id of the Channel Episode
descriptionstring- A short summary of the episode that is displayed when space is limited. Returned as the episode's summary.
episode_notesstring- Additional notes for the episode. Returned as the episode's description.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,channel_hashed_id,created,cursor,description,summary,hashed_id,media_hashed_id,live_stream_event_hashed_id,published,publish_at,title,updated,podcast_settings(episode_type,episode_number,season_number,explicit_content,hide_from_feed)
podcast_settingsobject- Podcast specific settings for a channel episode. These settings only take effect if podcasting is enabled for the channel.
titlestring- The episode's title. If not provided, the channel episode uses the title of the media used to create it.
wistiamcp_update_chapters_customizationsPartially update chapter titles, start times, and visibility.Writeupdate chapters customizations
Partially update chapter titles, start times, and visibility. chapterList merges by index: send the whole list, or stale trailing chapters remain. Use `chapters` for video, `audioChapters` for audio. - Let viewers jump to topics.
- Idempotent
Inputs
mediaIdstringrequired- The hashed ID of the media to be customized.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: plugin(chapters(on,visibleOnLoad,chapterList(id,title,time,deleted)),audioChapters(on,visibleOnLoad,chapterList(id,title,time,deleted)))
pluginobject- No description.
wistiamcp_update_engagement_customizationsUpdate CTAs (`postRoll-v1`) and timed links (`midrollLink-v1`).Writeupdate engagement customizations
Update CTAs (`postRoll-v1`) and timed links (`midrollLink-v1`). Partial update; `links` merges by index, so a shorter list leaves old trailing links. Video recommendations use update-related-media-customizations. - Send viewers to a demo at the end, or link a resource mid-video.
- Idempotent
Inputs
mediaIdstringrequired- The hashed ID of the video to be customized.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: plugin(postRoll-v1(rewatch,text,link,time,autoSize,style(backgroundColor),ctaType,on,conversionOpportunityKey),midrollLink-v1(on,links(text,url,time,duration,conversionOpportunityKey)))
pluginobject- Container for engagement plugin configurations.
wistiamcp_update_folderEdit a folder's name, description, or public/anonymous access.Writeupdate folder
Edit a folder's name, description, or public/anonymous access. Making a folder public requires plan access. - Rename a folder, or open one up for public distribution. - Use update-folder-sharing for one collaborator's permissions.
- Idempotent
Inputs
idstringrequired- Folder Hashed ID (e.g., "4d23503f70")
anonymousCanDownloadboolean- Whether anonymous users can download media from the folder.
anonymousCanUploadboolean- Whether anonymous users can upload media to the folder.
descriptionstring- The folder’s new description.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,name,description,media_count,medias(url),created,updated,hashed_id,public,public_id,anonymous_can_upload,anonymous_can_download,kind,personal_library,cursor
namestring- The folder’s new name.
publicboolean- A flag indicating whether or not the folder is enabled for public access.
wistiamcp_update_folder_sharingChange an existing sharing's upload, download, reshare, or admin permission for a person or contact group.Writeupdate folder sharing
Change an existing sharing's upload, download, reshare, or admin permission for a person or contact group. - Use delete-folder-sharing to revoke access entirely, or create-folder-sharing for someone with no sharing yet. sharingId is the numeric id from get-folder-sharings.
- Idempotent
Inputs
folderIdstringrequired- ID of the folder
sharingIdstringrequired- ID of the sharing to be updated
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,is_admin,can_share,can_download,can_upload,share(id,name,type,email),folder(id,name),cursor
sharingobject- No description.
wistiamcp_update_lead_capture_customizationsConfigure a video's email capture: pick one provider; only that provider changes.Writeupdate lead capture customizations
Configure a video's email capture: pick one provider; only that provider changes. HubSpot/Marketo/Pardot forms also need plan access and a connected integration. Legacy turnstile gates appear in the read but cannot be turned off here. - Gate a video with a form at the start, end, or a set time.
- Idempotent
Inputs
mediaIdstringrequired- The hashed ID of the video to be customized.
providerstringrequired- Which lead-capture mechanism to configure.one of
wistia_formhubspotmarketopardot enabledboolean- Whether the selected provider is turned on. Defaults to true.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: plugin(requireEmail-v1(on),form(on),hubspotForm(on),marketoForm(on),pardotForm(on))
settingsobject- Provider-specific settings. Only the fields relevant to the chosen provider are used.
wistiamcp_update_mediaUpdate one media's name, description, still image, tags, or custom_metadata by mediaHashedId.Writeupdate media
Update one media's name, description, still image, tags, or custom_metadata by mediaHashedId. tags replaces the whole list, which is also the only way to drop a tag; bulk-tag-media adds without replacing. - Improve a video's title, description, or still image before sharing it. - Fix catalog metadata on one media; for many use create-bulk-actions. Metadata only: swap-media replaces the file, move-media changes folder, update-thumbnail-customizations takes a thumbnail image URL.
- Idempotent
Inputs
mediaHashedIdstringrequired- The hashed ID of the media. (e.g., "4d23503f70")
custom_metadataobject- Custom metadata field values to set, keyed by field key. Values take the same shapes as the Set Custom Metadata Field Value endpoint; a null value clears that field and omitted fields are untouched. Requires the custom metadata feature on the account.
descriptionstring- A new description for this media. Accepts plain text or markdown.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,name,type,archived,created,updated,duration,embedCode,hashed_id,description,progress,status,section,thumbnail(url,width,height),protected,tags(name)
namestring- The media’s new name.
new_still_media_idstring- The Wistia hashed ID of an image that will replace the still that’s displayed before the player starts playing.
tagsarray- An array of tag names to apply to the media. This replaces any existing tags. To add tags without replacing existing tags, use bulk-tag-media.
wistiamcp_update_mochine_editRename a Mochine edit; every revision and its exported video take the name.Writeupdate mochine edit
Rename a Mochine edit; every revision and its exported video take the name. Mochine is Wistia's AI video editor. - Giving an edit a clearer name.
- Idempotent
Inputs
editHashedIdstringrequired- The `id` of the edit.
namestringrequired- The edit's new name.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: cursor,id,object,name,status,revision,current_revision,elements(slides,overlays,captions,narration,music,custom_motion,generative_video),motion_kit_id,source_media_ids,waiting_for(media_id,reason),created_at,updated_at,view_url,edit_url,output_media_id,error(code,message),preview(url,hls_url,poster_url,expires_at),download(url,expires_at,width,height),now_doing,findings_count,warnings(component,message,scene_number,reason),revisions(revision,revision_id,status,prompt,prompt_truncated,created_at,output_media_id,findings_count),findings(instruction,evidence,cause),transcript(text,reason,message),read(path,as_of,revision,changed_since_cursor,value,items,text,total,total_chars,from,next_read_cursor,truncated)
wistiamcp_update_motion_kitEdit a motion kit in place: rename it; set its when_to_use guidance or description; change its colors (accent, accent_deep, paper, ink, pop_1, pop_2 as hex); or change, set, or swap its fonts: the headline font, the body font (captions follow it), and their weights.Writeupdate Mochine motion kit
Edit a motion kit in place: rename it; set its when_to_use guidance or description; change its colors (accent, accent_deep, paper, ink, pop_1, pop_2 as hex); or change, set, or swap its fonts: the headline font, the body font (captions follow it), and their weights. Partial: send only what should change; colors and fonts take the same shape get-motion-kit returns. A font family is one of Wistia's bundled fonts or the account's custom fonts; an unknown family fails with a 422 naming it. Built-in kits can't be edited (403 builtin_kit); copy one first. This edits attributes only; to change how a treatment looks or moves, revise the kit. Uploading a new font file is done in the app. Free: uses no credits.
- Idempotent
Inputs
motionKitIdstringrequired- The kit's id (its slug), from get-motion-kits.
colorsobject- The colors to set. Send only the slots that should change.
descriptionstring- The kit's description. `null` or a blank string clears it.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,object,kind,name,status,roles_done,roles_total,pending_roles,failed_roles,preview_iframe_url_template,created_at,updated_at,ready_at,description,when_to_use,roles(role,status,revising,phase,failure_message,rejected,warnings),logo(status,rejection_reason),revision(routed_as,reauthoring_roles,updated_tokens,message,fallback_reason),fonts(headline(family,weight),body(family,weight)),colors(accent,accent_deep,paper,ink,pop_1,pop_2),cursor
fontsobject- The headline and body fonts to set. Send only the slots, and the fields within them, that should change.
namestring- The kit's display name.
when_to_usestring- Guidance on when to use the kit. `null` or a blank string clears it.
wistiamcp_update_playback_customizationsPartially update autoplay, sound, looping/end behavior, quality, controls, and tracking/embed flags (doNotTrack, videoFoam).Writeupdate playback customizations
Partially update autoplay, sound, looping/end behavior, quality, controls, and tracking/embed flags (doNotTrack, videoFoam). Reads return strings; writes need real booleans/numbers. Branding is update-appearance-customizations. - Autoplay a background video silently.
- Idempotent
Inputs
mediaIdstringrequired- The hashed ID of the video to be customized.
autoPlayboolean- If set to true, the video will play as soon as it’s ready. Note that autoplay might not work on some devices and browsers.
bpbTimestring- Controls when the big play button appears, expressed as a string.
clickForSoundboolean- If set to true, viewers can click to enable sound on a muted video.
controlsVisibleOnLoadboolean- If set to true, controls like the big play button, playbar, volume, etc. will be visible as soon as the video is embedded.
copyLinkAndThumbnailEnabledboolean- If set to false, the option to “Copy Link and Thumbnail” will be removed when right-clicking on the video.
doNotTrackboolean- If set to true, data for each viewing session will not be tracked.
emailstring- Associate a specific email address with this video’s viewing sessions.
endVideoBehaviorstring- Determines what happens when the video ends. Options are "default" (stays on the last frame), "reset" (shows thumbnail and controls), and "loop" (plays again from the start).
fakeFullScreenboolean- If set to true, the video will try to play in a pseudo-fullscreen mode on certain mobile devices.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: autoPlay,silentAutoPlay,muted,volume,controlsVisibleOnLoad,playButton,smallPlayButton,playbar,volumeControl,fullscreenButton,settingsControl,playbackRateControl,qualityControl,qualityMin,qualityMax,videoQuality,hls,endVideoBehavior,playsinline,playlistLoop,playlistLinks,playPauseNotifier,playSuspendedOffScreen,resumable,preload,time,keyMoments,fullscreenOnRotateToLandscape,fakeFullScreen,videoFoam(minWidth,maxWidth,minHeight,maxHeight),wmode,bpbTime,spherical,clickForSound(showText),seo,doNotTrack,copyLinkAndThumbnailEnabled,email,googleAnalytics
fullscreenButtonboolean- If set to true, the fullscreen button will be available as a video control.
fullscreenOnRotateToLandscapeboolean- If set to false, the video will not automatically go to fullscreen mode on mobile when rotated to landscape.
googleAnalyticsstring- Google Analytics tracking configuration to associate with this video’s viewing sessions.
hlsboolean- If set to true, HLS adaptive bitrate streaming is enabled.
keyMomentsboolean- If set to false, the key moments feature will be disabled.
mutedboolean- If set to true, the video will start in a muted state.
playbackRateControlboolean- If set to false, the playback speed controls in the settings menu will be hidden.
playbarboolean- If set to true, the playbar will be available. If set to false, it will be hidden.
playButtonboolean- Indicates if the play button is visible.
playlistLinksboolean- Enables the use of specially crafted links on the page to associate with a video, turning them into a playlist.
playlistLoopboolean- If set to true and this video has a playlist, it will loop back to the first video after the last one has finished.
playPauseNotifierboolean- If set to false, animations for the Pause and Play symbols will be removed.
playsinlineboolean- If set to false, videos will play within the native mobile player.
playSuspendedOffScreenboolean- If set to false for a muted autoplay video, the video won’t pause when out of view.
preloadstring- Sets the video’s preload property. Possible values are metadata, auto, none, true, and false.
qualityControlboolean- If set to false, the video quality selector in the settings menu will be hidden.
qualityMaxinteger- Specifies the maximum quality the video will play at.
qualityMininteger- Specifies the minimum quality the video will play at.
resumablestring- Determines if the video should resume from where the viewer left off. Options are "true", "false", and "auto".
seoboolean- If set to true, the video’s metadata will be injected into the page’s markup for SEO.
settingsControlboolean- If set to true, the settings control will be available.
silentAutoPlaystring- Determines how videos handle autoplay in contexts where normal autoplay might be blocked. Options are "true", "allow", and "false".
smallPlayButtonboolean- If set to true, the small play button control is shown.
sphericalboolean- If set to true, the video is rendered as a spherical (360-degree) video.
timestring- Sets the starting time of the video.
videoFoamstring- When set to true, the video will adjust its size according to its parent element. It can also be an object specifying min/max width or height.
videoQualitystring- Sets the default video quality the video will play at.
volumenumber- Sets the volume of the video.
volumeControlboolean- When set to true, a volume control is available over the video.
wmodestring- If set to transparent, the background behind the player will be transparent instead of black.
wistiamcp_update_sharing_customizationsUpdate the player's share bar and viewer downloads.Writeupdate sharing customizations
Update the player's share bar and viewer downloads. Partial update, but `channels` fully replaces the list: send every channel you want active, not just the new one. - Set the shared page URL/title and default tweet text for a video.
- Idempotent
Inputs
mediaIdstringrequired- The hashed ID of the video to be customized.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: plugin(share(on,channels,tweetText,downloadType,overrideUrl,pageUrl,pageTitle,conversionOpportunityKey))
pluginobject- No description.
wistiamcp_update_subfolderRename a subfolder or edit its description; it cannot be moved to another folder.Writeupdate subfolder
Rename a subfolder or edit its description; it cannot be moved to another folder. - Use move-media to move media between sections, or update-folder to edit the parent folder itself. subfolderId comes from get-subfolders; folderId is its parent's hashed_id.
- Idempotent
Inputs
folderIdstringrequired- The hashed ID of the folder
subfolderIdstringrequired- The hashed ID of the subfolder
descriptionstring- The new description for the subfolder
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: hashed_id,name,description,position,created,updated,cursor
namestring- The new name for the subfolder
wistiamcp_update_thumbnail_customizationsPartially update the pre-play image, alt text, fit, looping thumbnail, or text overlay.Writeupdate thumbnail customizations
Partially update the pre-play image, alt text, fit, looping thumbnail, or text overlay. Send stillUrl or unalteredStillImageAsset as null to reset it. For an image already in Wistia, use update-media's new_still_media_id. stillUrl has any text overlay drawn in. To reuse an image without it, copy the source's unalteredStillImageAsset url, width and height, and set stillUrl to that url. Changing overlay text doesn't redraw the image; that needs the Customize page. - Replace an outdated poster. - Undo an image change: resend the earlier stillUrl and unalteredStillImageAsset from show-thumbnail-customizations, or null.
- Idempotent
Inputs
mediaIdstringrequired- The hashed ID of the video to be customized.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: stillUrl,thumbnailAltText,fitStrategy,unalteredStillImageAsset(url,width,height),plugin(videoThumbnail(clickToPlayButton,clickForSound(on,showText),hashedId,trimStart,trimEnd,priorityMode),thumbnailTextOverlay-v2(on,text))
fitStrategystring- Resizes the thumbnail when there's a discrepancy between its aspect ratio and that of its parent container. Options are contain, cover, fill, and none.
pluginobject- Container for thumbnail-related player plugin configurations.
stillUrlstring- Overrides the thumbnail image that appears before the video plays. When a text overlay is included, the text is drawn into this image. Send null to go back to the video's own thumbnail.
thumbnailAltTextstring- Alt text for the thumbnail image, used for accessibility.
unalteredStillImageAssetstring- The thumbnail image before any text overlay is drawn on it. Send null to clear it.
wistiamcp_update_webinarEdit a webinar's title, description, schedule, duration, or time zone.Writeupdate webinar
Edit a webinar's title, description, schedule, duration, or time zone. Its folder can change only before it starts. - Rescheduling an upcoming live demo. - Correcting event details before sharing the registration page. Find its hashed ID with get-webinars.
- Idempotent
Inputs
idstringrequired- The hashed ID of the webinar
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,hashed_id,title,description,scheduled_for,event_duration,time_zone,lifecycle_status,registration_status,created_at,updated_at,audience_link,host_link,panelist_link,thumbnail_url,folder(id,index_url,url),series(id,index_url,url),cursor
webinarobject- No description.
wistiamcp_upload_media_to_folderOpen an uploader for a Wistia folder identified by folder_id.Writeupload media to folder
Open an uploader for a Wistia folder identified by folder_id. - Letting the user upload a file from their device into a folder. Completed uploads add their media hashed IDs to the conversation. For a file already at a public URL, use import-media-from-url instead.
Inputs
folder_idstringrequired- The hashed ID of the Wistia folder (project) to upload into
wistiamcp_apply_brandApply a saved brand to a media, folder, or channel.Destructiveapply brand
Apply a saved brand to a media, folder, or channel. Folder branding reaches media without their own brand; webinars are unsupported. - Making a new brand kit take effect across a folder or channel. - Restoring inherited styling by applying the is_default brand. Which fields land depends on resource type and account, so a successful call can change nothing visible. The response is the brand now in effect, not always the one applied. get-brands supplies brandId.
- Idempotent
Inputs
brandIdstringrequired- The id of the brand to apply
resource_idstringrequired- The id of the resource being branded.
resource_typestringrequired- The kind of resource being branded. Webinars can't be branded through this endpoint yet.one of
mediafolderchannel clear_overridesboolean- When true (the default), appearance settings the resource had set directly are cleared for the fields the brand controls, so the brand is what shows. Set to false to leave them in place, in which case they continue to win over the brand.default
true fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,name,is_default,created,updated,primary_color,page_background_color,body_font_family,headline_font_family,button_font_family,border_radius,contrast_icons,opaque_controls,page_logo(url,dimensions(width,height),size),player_logo(url,dimensions(width,height),size),cursor
wistiamcp_archive_mediaArchive up to 100 media by hashed_ids, removing each from its folder and destroying its channel episodes for good while keeping the file; reverse with restore-media into a folder (async).Destructivearchive media
Archive up to 100 media by hashed_ids, removing each from its folder and destroying its channel episodes for good while keeping the file; reverse with restore-media into a folder (async). Requires the Archiving feature and owner/manager access. Webinar, Wistia Record, pre-2023 Soapbox, and My Library media are skipped silently. - Clear finished footage out of a folder, keeping it for reuse. Use delete-media to trash instead (recoverable only until the Recently Deleted window closes).
- Idempotent
Inputs
hashed_idsarrayrequired- An array of the media hashed IDs to be archived.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: message,background_job_status(id,hashed_id,status)
wistiamcp_bulk_delete_subfoldersBulk-delete multiple subfolders from a folder (project).Destructivebulk delete subfolders
Bulk-delete multiple subfolders from a folder (project). Their media is also sent to the trash, so confirm with the user before calling; only an account owner or manager can restore it. To keep the media, call delete-subfolder for each subfolder instead — it moves the media to the folder's root level. Runs asynchronously and returns a background_job_status object.
- Idempotent
Inputs
folderIdstringrequired- The hashed ID of the folder containing the subfolders
hashed_idsarrayrequired- An array of the subfolder hashed IDs to be deleted.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: message,background_job_status(id,hashed_id,status)
wistiamcp_cancel_motion_kitStop or cancel a motion kit that is still authoring, as the app's Stop does.Destructivecancel Mochine motion kit
Stop or cancel a motion kit that is still authoring, as the app's Stop does. Every role stops and status becomes stopped; a stopped kit never becomes ready and can't be revised or retried. Credit holds settle as Stop settles them. There is no resume; a way to resume a stopped kit may be added later. 409 not_in_progress when the kit isn't authoring.
Inputs
motionKitIdstringrequired- The kit's id (its slug), from get-motion-kits.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,object,kind,name,status,roles_done,roles_total,pending_roles,failed_roles,preview_iframe_url_template,created_at,updated_at,ready_at,description,when_to_use,roles(role,status,revising,phase,failure_message,rejected,warnings),logo(status,rejection_reason),revision(routed_as,reauthoring_roles,updated_tokens,message,fallback_reason),fonts(headline(family,weight),body(family,weight)),colors(accent,accent_deep,paper,ink,pop_1,pop_2),cursor
wistiamcp_create_bulk_actionsBatch create, update, delete, move, add_tags, and archive changes across media, folders, subfolders, channels, channel episodes, caption tracks, media speakers, and player customizations, processed asynchronously.Destructivecreate bulk actions
Batch create, update, delete, move, add_tags, and archive changes across media, folders, subfolders, channels, channel episodes, caption tracks, media speakers, and player customizations, processed asynchronously. Send per-record actions, or one job that applies a shared payload to every record under a scope or in an id list. Prefer this over repeated single calls when changing many records at once. - Apply one player setting, metadata value, or tag set across a folder. - Rename, move, or delete many records, each with its own payload. - Create many folders, subfolders, channel episodes, or caption tracks. Not for uploads or imports, orders (create-bulk-purchase), or copies (bulk-copy-media, copy-folder). Related: show-*-customizations for a concern's field names, list-transcripts for caption track ids and speaker data, get-speakers for speaker profiles, bulk-tag-media for the same tags on any set, delete-subfolder to remove a subfolder but keep its media, and get-background-job-status for per-action results.
Inputs
actionsarray- An array of actions to process, one per record. Maximum 1000 actions per request, and the request body must stay under 2 MB -- whichever limit is reached first. An oversized body is rejected with a `413` and no action in it runs. Each action specifies an operation (create, update, delete, move, add_tags, or archive), a resource type, and the relevant payload or record ID. Actions run independently, so one request can mix operations and resource types, but no action can depend on another's result. Provide exactly one of `actions` or `job`; a request carrying both is rejected. Use `job` instead when every record takes the same payload.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name.
jobobject- One change applied to many records, named by a parent (`scope`) or listed explicitly (`ids`). The server resolves the target and runs one action per record, so a folder of 400 media takes one job rather than 400 actions. Provide exactly one of `job` or `actions`; a request carrying both is rejected. A `scope` resolves to exactly what the matching list endpoint returns for that parent, including its defaults -- so a `folder` scope on `media` reaches media in that folder's subfolders, but not media already archived out of it. A job resolves to at most 5000 records. Beyond that it is rejected rather than truncated, so a job never silently acts on part of the set you named -- narrow the scope, or send the records as an actions array. Cannot be used with `create`, which has no record to address, and is not available to external contacts.
wistiamcp_create_bulk_purchaseOrder captions, localizations (dubs), extended audio descriptions, or text translations for multiple media.Destructivecreate bulk purchase
Order captions, localizations (dubs), extended audio descriptions, or text translations for multiple media. Supply either actions or job, never both. A job uses either ids or scope (folder, subfolder, channel, or account), never both. Each action uses operation purchase, a supported resource_type, the media's hashed id, and payload with the chosen purchase options. Captions accept automated and rush; localizations require output_language; audio descriptions accept ai_enabled and ietf_language_tag; text translations require target_language and accept source_language. On this account, eligible paid orders use Credits for each media, with per-minute rounding applied to each minute-priced order. Automated captions use no Credits. Confirm the full scope and the account's supplied Credit rate for each order type (per-minute, or per translation for text translations) before ordering; do not guess a total or substitute legacy dollar pricing or free allowances. Credits are held when each order starts, charged on completion, and released on failure. Orders run independently and may partially succeed. Returns a background job status. Call get-background-job-status with it until the job is finished or failed, then report each failed order and its error from the per-order results. Submitted orders may still be processing at the vendor. Use create-bulk-actions for non-purchase work.
Inputs
actionsarray- The orders to place, one per media. Maximum 1000 per request, and the request body must stay under 2 MB -- whichever limit is reached first. An oversized body is rejected with a `413` and no order in it is placed. Every order is priced and placed independently: one failing (an ineligible media, an account without a saved card, a language that already has a localization) does not stop the rest of the batch. Use `job` instead to order for a whole folder, channel, or account.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name.
jobobject- One order placed for many media, named by a parent (`scope`) or listed explicitly (`ids`), so ordering captions for a folder of 47 videos takes one job rather than 47 orders. A `scope` resolves to exactly what List Media returns for that parent, including media in the folder's subfolders and **archived** media, and to at most 5000 media -- beyond that the job is rejected rather than truncated. The job attempts one order for every media it resolves to. Ineligible media fail individually without placing an order; successful orders are metered and may incur charges according to the account's plan. Confirm the scope and potential cost with the customer before submitting. Not available to external contacts.
wistiamcp_create_localizationCreate, add, or order a localization: a new version of a video dubbed into a chosen output language, with the speech translated in the speaker's own voice and the video lip-synced to match (not just a replacement audio track).Destructivecreate localization
Create, add, or order a localization: a new version of a video dubbed into a chosen output language, with the speech translated in the speaker's own voice and the video lip-synced to match (not just a replacement audio track). This can incur a charge on the account (it orders a dubbed video from a third-party service) and is processed asynchronously. Confirm the cost using the account's supplied Dub Credit rate or legacy Dub rate; do not guess a price. A non-null expected_billed_credits reports Credits held until completion and released on failure. Otherwise the result reports legacy dollar pricing. Use this when someone wants to translate or produce a different-language variant of a video. Use gets-localizations to list a media's localizations, show-localization for one, or delete-localization to remove one. For subtitle tracks instead, see create-captions.
Inputs
mediaHashedIdstringrequired- The hashed ID of the media to create a localization for.
output_languagestringrequired- The language to localize the media to as a 3-character IETF language code.
auto_enableboolean- Whether to automatically enable the localization.default
true fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: hashed_id,language_code,iso639_2_language_code,language_name,native_language_name,created_at,updated_at,ordered_at,enabled_at,enabled,source_media(hashed_id,name,duration,created_at,updated_at),transcript(hashed_id,language_name,native_language_name,text,created_at,updated_at),auto_enable_dubbing,expected_billed_minutes,expected_billed_price_per_minute,expected_billed_price,expected_billed_credits,billed_at
wistiamcp_delete_brandPermanently delete a brand kit; the account default cannot be deleted.Destructivedelete brand
Permanently delete a brand kit; the account default cannot be deleted. - Retiring an obsolete brand so its media, folders, and channels return to inherited branding. - Retiring the kit while preserving its appearance on those resources with sync_to_customizations true, which copies the styling into each resource. This cannot be undone. Find brandId with get-brands.
- Idempotent
Inputs
brandIdstringrequired- The id of the brand
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,name,is_default,created,updated,primary_color,page_background_color,body_font_family,headline_font_family,button_font_family,border_radius,contrast_icons,opaque_controls,page_logo(url,dimensions(width,height),size),player_logo(url,dimensions(width,height),size),cursor
sync_to_customizationsboolean- When true, the brand's values are baked into the customizations of everything it was applied to before it is deleted, so those items keep their current appearance. Defaults to false.
wistiamcp_delete_captionsDelete a media's caption track for a specified ISO-639-2 language.Destructivedelete captions
Delete a media's caption track for a specified ISO-639-2 language. Use list-transcripts to identify the track first. - Withdraw an incorrect translation that viewers should no longer see. - Delete a caption language that is no longer needed; use update-captions when a replacement track is available.
- Idempotent
Inputs
languageCodestringrequired- Language code conforming to ISO-639-2 for which the captions should be removed. Must be the track's stored code (e.g., `fre`).
mediaHashedIdstringrequired- Unique identifier for the media.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name.
wistiamcp_delete_channelDelete a Wistia Channel and its episode entries by channelHashedId.Destructivedelete channel
Delete a Wistia Channel and its episode entries by channelHashedId. The underlying media remains; there is no channel-restore tool. - Retire a discontinued series or a duplicate content hub; use delete-channel-episode if only one video should leave the gallery.
- Idempotent
Inputs
channelHashedIdstringrequired- The hashed id of the Channel
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,created,description,hashed_id,media_count,live_stream_event_count,name,public_url,locked,updated,auto_publish_enabled,podcast_enabled,custom_url,embedded_url,podcast_settings(copyright,episode_format,author_name,explicit,owner_name,owner_email,category1,category2,category3,language),cursor
wistiamcp_delete_channel_collaboratorRevoke a channel collaborator's explicit access.Destructivedelete channel collaborator
Revoke a channel collaborator's explicit access. Use get-channel-collaborators to identify the collaborator. - End a contractor's access when their work on a series is complete. - Withdraw a channel invitation sent to the wrong person.
- Idempotent
Inputs
channelHashedIdstringrequired- Channel Hashed ID (e.g., "abc123")
idintegerrequired- Collaborator ID
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,role,created_at,share(id,name,type,email),cursor
wistiamcp_delete_channel_episodeDelete a channel episode by channelEpisodeHashedId, removing its gallery entry while keeping the underlying media.Destructivedelete channel episode
Delete a channel episode by channelEpisodeHashedId, removing its gallery entry while keeping the underlying media. There is no episode-restore tool. - Remove a video added to the wrong series, or retire an obsolete episode; use un-publish-channel-episode for a temporary withdrawal.
- Idempotent
Inputs
channelEpisodeHashedIdstringrequired- The hashed id of the Channel Episode
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,channel_hashed_id,created,cursor,description,summary,hashed_id,media_hashed_id,live_stream_event_hashed_id,published,publish_at,title,updated,podcast_settings(episode_type,episode_number,season_number,explicit_content,hide_from_feed)
wistiamcp_delete_customizationsDelete every customization on a video: not only the player look but also chapters, thumbnail overrides, CTAs, forms, sharing, and any password gate.Destructivedelete customizations
Delete every customization on a video: not only the player look but also chapters, thumbnail overrides, CTAs, forms, sharing, and any password gate. Reset one area with its own update tool. - Start a video's setup over.
- Idempotent
Inputs
mediaIdstringrequired- The hashed ID of the media whose customizations are to be deleted.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name.
wistiamcp_delete_folderDelete a folder (formerly project) and trash its media and subfolders.Destructivedelete folder
Delete a folder (formerly project) and trash its media and subfolders. Confirm with the user first; only an account owner or manager can restore the media, and only into a different folder_id, since no tool restores the folder itself. - Retire a discarded folder and its assets; move the keepers out first, or use delete-subfolder for one nested section.
- Idempotent
Inputs
idstringrequired- Folder Hashed ID (e.g., "4d23503f70")
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,name,description,media_count,medias(url),created,updated,hashed_id,public,public_id,anonymous_can_upload,anonymous_can_download,kind,personal_library,cursor
wistiamcp_delete_folder_sharingRevoke a person's or group's explicit sharing on a folder (formerly project).Destructivedelete folder sharing
Revoke a person's or group's explicit sharing on a folder (formerly project). Use get-folder-sharings to identify the sharing. - End a contractor's folder access after a project is delivered. - Withdraw an invitation sent to the wrong recipient; use update-folder-sharing when access should remain with fewer permissions.
- Idempotent
Inputs
folderIdstringrequired- Hashed ID of the folder (e.g., "4d23503f70")
sharingIdstringrequired- ID of the sharing to be deleted
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,is_admin,can_share,can_download,can_upload,share(id,name,type,email),folder(id,name),cursor
wistiamcp_delete_localizationDelete a dubbed language version by localization hashed ID.Destructivedelete localization
Delete a dubbed language version by localization hashed ID. Use gets-localizations to identify it first. - Withdraw an inaccurate dub that should no longer be available to viewers. - Delete a language variant a region no longer needs.
- Idempotent
Inputs
localizationHashedIdstringrequired- The hashed ID of the localization to delete.
mediaHashedIdstringrequired- The hashed ID of the localization's media.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: hashed_id,language_code,iso639_2_language_code,language_name,native_language_name,created_at,updated_at,ordered_at,enabled_at,enabled,source_media(hashed_id,name,duration,created_at,updated_at),transcript(hashed_id,language_name,native_language_name,text,created_at,updated_at)
wistiamcp_delete_mediaDelete one media by mediaHashedId.Destructivedelete media
Delete one media by mediaHashedId. Recoverable only during its Recently Deleted window via restore-deleted-media; afterward it is permanently purged. - Delete an accidental upload or unwanted duplicate from the library. Use archive-media instead when the media should stay recoverable for reuse. Refused with 422 while the media is streaming in a pre-recorded webinar that is live right now; retry after the webinar ends.
- Idempotent
Inputs
mediaHashedIdstringrequired- The hashed ID of the media. (e.g., "4d23503f70")
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,name,type,archived,created,updated,duration,embedCode,hashed_id,description,progress,status,section,thumbnail(url,width,height),protected
wistiamcp_delete_media_extended_audio_descriptionPermanently delete an extended audio description (EAD).Destructivedelete media extended audio description
Permanently delete an extended audio description (EAD). Cannot be undone. - Withdraw an inaccurate or obsolete accessibility track. To stop a track from playing without losing it, turn extendedAudioDescription off with update-accessibility-customizations. id comes from get-media-extended-audio-descriptions.
- Idempotent
Inputs
idstringrequired- The hashed id of the Media Extended Audio Description
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,ietf_language_tag,created_at,updated_at,media(id,index_url,url),provided_media_file(id,index_url,url),contact(id,index_url,url),cursor
wistiamcp_delete_motion_kitDelete or remove a custom motion kit for good.Destructivedelete Mochine motion kit
Delete or remove a custom motion kit for good. Returns {id, object, deleted: true}. Deleting is free, even with no Credits left. A kit in use by edits can still be deleted: edits already made with it keep their look, and revising one without motion_kit_id keeps it, but a new edit or revision that names it fails with 422 motion_kit_unavailable (details.reason deleted); pass another kit's id to switch. Its id stays taken, so create-motion-kit under the same name returns 409 name_taken. A kit with a mochine.ai directory listing can't be deleted (409 has_listing), and a built-in kit can't be deleted (403 builtin_kit).
- Idempotent
Inputs
motionKitIdstringrequired- The kit's id (its slug), from get-motion-kits.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,object,deleted
wistiamcp_delete_recording_roomDelete a Record recording room.Destructivedelete recording room
Delete a Record recording room. Its `host_url` and `guest_url` stop working, including anywhere the guest link was already shared, such as calendar invites, and guests waiting to be let in are turned away. Recordings already made in the room stay in the account. While a recording session is in progress in the room, the request fails with 409 `reason: "session_in_progress"`; tell the user to try again once it ends. Confirm with the user first.
- Idempotent
Inputs
recordingRoomSlugstringrequired- The `slug` of the room to delete.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: slug,host_url,guest_url,requires_manual_admission,created,cursor
wistiamcp_delete_review_bundlePermanently delete a review bundle and its link, keeping the media.Destructivedelete review bundle
Permanently delete a review bundle and its link, keeping the media. - Revoking a shared review link after a review round. This cannot be undone; find its ID with get-review-bundles.
- Idempotent
Inputs
reviewBundleHashedIdstringrequired- The hashed id of the review bundle.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: hashed_id,name,url,allow_downloads,cursor
wistiamcp_delete_speakerDelete a speaker profile nothing uses, such as a duplicate or misspelled profile.Destructivedelete speaker
Delete a speaker profile nothing uses, such as a duplicate or misspelled profile. If anything still uses it, the request fails with 409 `reason: "in_use"` and says where; tell the user, and don't remove the person from those videos or webinars unless they ask for that. Confirm with the user first. Requires an account owner or manager.
- Idempotent
Inputs
speakerProfileIdstringrequired- The `speaker_profile_id` of the profile to delete.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: speaker_profile_id,name,title,image_url,cursor
wistiamcp_delete_subfolderDelete one subfolder, moving its media to the parent folder's root.Destructivedelete subfolder
Delete one subfolder, moving its media to the parent folder's root. Only the subfolder is soft-deleted. - Flatten a folder's organization while keeping its videos. - Delete an empty section after reorganizing media; bulk-delete-subfolders also trashes contents.
- Idempotent
Inputs
folderIdstringrequired- The hashed ID of the folder
subfolderIdstringrequired- The hashed ID of the subfolder
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: hashed_id,name,description,position,created,updated,cursor
wistiamcp_delete_tagPermanently delete an account tag by name, detaching it from every media; this cannot be undone.Destructivedelete tag
Permanently delete an account tag by name, detaching it from every media; this cannot be undone. - Retire an obsolete label after re-labeling its media with bulk-tag-media. To untag one media instead, send its remaining tags to update-media.
- Idempotent
Inputs
namestringrequired- Name of the tag to delete
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name.
wistiamcp_delete_webinarPermanently delete a webinar; this cannot be undone.Destructivedelete webinar
Permanently delete a webinar; this cannot be undone. It also deletes the event's live stream media, including the recording. - Removing an event created by mistake or canceled. Use update-webinar to reschedule an event instead.
- Idempotent
Inputs
idstringrequired- The hashed ID of the webinar
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,hashed_id,title,description,scheduled_for,event_duration,time_zone,lifecycle_status,registration_status,created_at,updated_at,audience_link,host_link,panelist_link,thumbnail_url,folder(id,index_url,url),series(id,index_url,url),cursor
wistiamcp_delete_webinar_collaboratorRevoke a collaborator's producer access to a webinar.Destructivedelete webinar collaborator
Revoke a collaborator's producer access to a webinar. - Removing a producer who has left the event team. - Ending temporary production access after a broadcast. Find the collaborator with get-webinar-collaborators.
- Idempotent
Inputs
idintegerrequired- Collaborator ID
webinarIdstringrequired- Webinar Hashed ID (e.g., "abc123")
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,role,created_at,share(id,name,type,email),cursor
wistiamcp_edit_captions_textCorrect words or phrases in one caption track, keeping unchanged word timings; use update-captions to replace a whole track.Destructiveedit captions text
Correct words or phrases in one caption track, keeping unchanged word timings; use update-captions to replace a whole track. Take `expected_version` from find-transcript-matches, which also returns match counts and candidate time ranges without loading the whole transcript; reuse a result already in the conversation rather than calling it again. When the target occurs more than once, pass the intended match's `start_ms` and `end_ms`. Nothing is written unless every edit resolves: on 409 re-read for `stale_version`, or wait and retry once for `diverged`; on 422 retry with a returned candidate. - Fix a misspelled name, product term, or mis-transcribed phrase. - Fix burned-in Remix text by editing its source media's transcript: previews refresh automatically, but an already-exported Remix must be exported again. Editing the Remix output's own track does not change rendered text; follow returned `warnings`.
Inputs
editsarrayrequired- The corrections to apply, all-or-nothing, in one new version.
expected_versionintegerrequired- The active caption version returned with the caption content used to prepare these edits. The edit applies only if that is still the active version; otherwise it returns 409 so you re-read and retry.
languageCodestringrequired- The 3-character ISO 639-2 language code of the caption track to edit (e.g., `eng`, `fre`, `spa`), exactly as stored. Some languages use extended IETF subtags (e.g., `zh-Hant`).
mediaHashedIdstringrequired- The hashed ID of the media whose transcript should be edited.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: applied,media_id,language,version(from,to),edits(target_text,replacement_text,matched_text,context,original(start_ms,end_ms),replacement(start_ms,end_ms)),warnings
wistiamcp_order_media_extended_audio_descriptionOrder, purchase, or buy an extended audio description (EAD) for a media — an accessibility audio track that narrates on-screen visuals for blind and low-vision viewers.Destructiveorder media extended audio description
Order, purchase, or buy an extended audio description (EAD) for a media — an accessibility audio track that narrates on-screen visuals for blind and low-vision viewers. This places a paid order and charges the account's credit card when the order is ready; only paid plans with the order_audio_descriptions feature can use it. Use this when someone wants to add audio descriptions to a video. Poll show-media-extended-audio-description-order-status to track the order, or use get-media-extended-audio-descriptions to list existing ones.
Inputs
media_idstringrequired- The hashed id of the media to order the extended audio description for.
ai_enabledboolean- Whether to use AI-generated audio descriptions (cheaper) or human-generated (higher quality). AI is only available for English orders.default
true enabledboolean- Whether the extended audio description should be automatically enabled once the order is complete.default
true fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: message,order(id,order_status,created_at,updated_at,ietf_language_tag,media(id,index_url,url),media_extended_audio_description(id,index_url,url)),expected_billed_credits
ietf_language_tagstring- IETF language tag for the audio description. Defaults to `eng` (English).
Non-English orders must set `ai_enabled: false` — AI-generated audio
descriptions are only available in English.
Spanish (`es-419`) orders are only accepted when the source media is
tagged as a Spanish-language variant or has no detected language
(e.g. silent videos). Spanish orders against a media in another
language return `400`.
one of
enges-419defaulteng order_instructionsstring- Optional instructions for the audio description provider.
wistiamcp_purchase_captionsPurchase, buy, or order Wistia-generated English captions (subtitles / closed captions / CC) for a video or audio media.Destructivepurchase captions
Purchase, buy, or order Wistia-generated English captions (subtitles / closed captions / CC) for a video or audio media. This can incur a charge billed to the saved credit card on the account (required), and is processed asynchronously. Do not quote a price or tell the user the order is free: computer-generated captions are included at no cost on some plans and billed per minute on others, and human-reviewed captions bill per minute at the account's standard or rush rate. Use this when someone wants Wistia to generate or order English subtitles rather than uploading their own. Then call translate-media to get them in another language, or use create-captions to upload your own SRT track.
Inputs
mediaHashedIdstringrequired- Unique identifier for the media.
automatedboolean- Order computer-generated captions or human-reviewed ones. What each costs depends on the account's plan and billing settings; computer-generated captions are included at no cost on some plans and billed per minute on others.default
false automatically_enableboolean- Automatically enable captions for the media once the order is ready or hold the captions for review before manually enabling.default
true fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: message,id
rushboolean- Enable rush order for one business day turnaround instead of the standard four, for human-reviewed captions only. Rush bills at the account's higher per-minute rate.default
true
wistiamcp_remove_speakerRemove a speaker from a media.Destructiveremove speaker
Remove a speaker from a media. Their named turns become an anonymous detected speaker again. Get the `media_speaker_id` from the media's `speakers` in get-medias with include=speakers. Confirm with the user first. Pass the current `speaker_data_version` from list-transcripts as `expected_version` when you have it; on 409, re-read and retry. This does not delete the speaker's profile from the account's library.
- Idempotent
Inputs
mediaHashedIdstringrequired- The hashed ID of the media to remove the speaker from.
mediaSpeakerIdstringrequired- The `media_speaker_id` of the assignment to remove, from `include=speakers` on the media.
expected_versioninteger- The media's current `speaker_data_version`. When given, a stale value returns 409.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: status,speaker(media_speaker_id,speaker_profile_id,name),speaker_data_version,changed_runs
wistiamcp_swap_mediaReplace a media's underlying file with another media already in the account (import-media-from-url or upload-media-to-folder it first), keeping the original's hashed_id, URLs, and embed code (async).Destructiveswap media
Replace a media's underlying file with another media already in the account (import-media-from-url or upload-media-to-folder it first), keeping the original's hashed_id, URLs, and embed code (async). The old file survives under replacement_media_id as "<name> [Replaced on <date>]"; delete-media removes it. - Publish a corrected cut everywhere its existing embed is already used. Use update-media for metadata-only changes, copy-media for a separate version.
Inputs
mediaHashedIdstringrequired- The hashed ID of the media to be replaced.
replacement_media_idstringrequired- The hashed ID of the media that will replace the original media. Must be the same media type as the original.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: media(id,name,type,archived,created,updated,duration,embedCode,hashed_id,description,progress,status,section,thumbnail(url,width,height),protected),message,background_job_status(id,hashed_id,status)
wistiamcp_update_brandEdit a brand kit; changes apply everywhere it is used.Destructiveupdate brand
Edit a brand kit; changes apply everywhere it is used. Omitted fields stay unchanged; null clears a field. Editing the is_default brand restyles everything with no brand of its own. - Rolling out a revised palette or typography across branded videos. - Replacing an outdated logo everywhere the brand applies. get-brands supplies brandId and the current logo URLs. For a new logo, upload an image with asset_type=brand_image through get-upload-credentials, where it's listed.
- Idempotent
Inputs
brandIdstringrequired- The id of the brand
body_font_familystring- The brand font family for body text.
border_radiusinteger- The border radius in pixels for rounded corners.
button_font_familystring- The brand font family for buttons.
contrast_iconsstring- Controls whether the player icon color is always white or uses an accessible contrast color when necessary.one of
enableddisabledunset fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: id,name,is_default,created,updated,primary_color,page_background_color,body_font_family,headline_font_family,button_font_family,border_radius,contrast_icons,opaque_controls,page_logo(url,dimensions(width,height),size),player_logo(url,dimensions(width,height),size),cursor
headline_font_familystring- The brand font family for headlines.
namestring- The brand's display name. Renaming the account-level default brand is ignored; its name is managed by Wistia.
opaque_controlsstring- Controls the opacity of the video player control bar and big play button.one of
enableddisabledunset page_background_colorstring- The brand color used for page backgrounds. Either a hex color string or a gradient represented as an array of [hexColor, percentage] tuples.
page_logoobject- The brand logo used for pages. On accounts without custom branding the player logo is ignored, but the page logo is always applied.
player_logoobject- The brand logo used for the player. Ignored on accounts whose plan doesn't include custom branding.
primary_colorstring- The primary brand color, used for primary buttons and the player playbar. Either a hex color string or a gradient represented as an array of [hexColor, percentage] tuples.
wistiamcp_update_brand_preloadSet the account's default page logo and player color.Destructiveupdate brand preload
Set the account's default page logo and player color. Both write into the account's default brand, restyling everything with no brand of its own. - Saving branding chosen during signup. - Setting an account-wide default logo or player color. For fonts, corners, or other brand fields use update-brand.
- Idempotent
Inputs
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: has_brand_kits,brandfetch_brand(domain,primary_color,logo,font,colors,logos(theme,type,tags,formats(src,format,background,height,width,size)),status)
selected_logo_hashed_idstring- Bakery hashed_id of an uploaded logo image, which will become the account's default page logo. Omit to leave the current logo untouched. Pass an empty string to clear the logo.
selected_player_colorstring- Hex color string (e.g. "#3366FF") for the account's default player color — 6 hex digits, with or without the leading `#`. Omit or send an empty string to leave the current color untouched (there is no clear operation — color always has a value). Malformed values are rejected at the API boundary; without this check, the model's sanitize step would return nil and silently reset the account color to the global default.
wistiamcp_update_captionsReplace an existing caption track with an SRT file or its contents for a specified ISO-639-2 language.Destructiveupdate captions
Replace an existing caption track with an SRT file or its contents for a specified ISO-639-2 language. This overwrites the entire track. - Install a fully revised transcript or corrected subtitle timing from a captioning vendor. - Replace an outdated translation with an approved SRT; use edit-captions-text for isolated wording fixes, or create-captions for a new language.
- Idempotent
Inputs
caption_filestringrequired- Either an attached SRT file or a string parameter with the contents of an SRT file.
languageCodestringrequired- Language code conforming to ISO-639-2 for which the captions should be updated. Must be the track's stored code (e.g., `fre`).
mediaHashedIdstringrequired- Unique identifier for the media.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name.
wistiamcp_update_recording_roomChange a Record recording room's slug or whether the host has to let each guest in.Destructiveupdate recording room
Change a Record recording room's slug or whether the host has to let each guest in. Changing the slug changes both the `host_url` and the `guest_url`, so any link already shared, for example in a calendar invite, stops working; say so and confirm with the user first, and share the new `guest_url` afterward. Turning `requires_manual_admission` off lets anyone with the guest link join without the host's approval. Find the room's current slug with get-recording-rooms.
- Idempotent
Inputs
recordingRoomSlugstringrequired- The current `slug` of the room to change.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: slug,host_url,guest_url,requires_manual_admission,created,cursor
requires_manual_admissionboolean- Whether the host has to let each guest in. When false, guests join as soon as they open the guest link.
slugstring- The room's new name, used as the last part of its URLs. Lowercase letters, numbers, hyphens and underscores only, with at least one letter or number, and unique within the account. Changing it changes both URLs, and the old URLs stop working.
wistiamcp_update_speakerChange a speaker profile's name or title, for example to fix a misspelling.Destructiveupdate speaker
Change a speaker profile's name or title, for example to fix a misspelling. The profile is shared, so the change shows everywhere the person appears, on every video and webinar; say so and confirm with the user first. To replace one person with another on a video, use remove-speaker and assign-speaker instead. Requires an account owner or manager.
- Idempotent
Inputs
speakerProfileIdstringrequired- The `speaker_profile_id` of the profile to change.
fieldsstring- JSON Mask selector (Google partial-response syntax, * = wildcard) returning only the fields you name. Unknown fields are rejected. Fields: speaker_profile_id,name,title,image_url,cursor
namestring- The speaker's new display name. Leading and trailing whitespace is removed.
titlestring- The speaker's new title. Leading and trailing whitespace is removed. Send null or an empty string to clear it.
No tools match.