Skip to main content

The Wistia Model Context Protocol (MCP) Server

Learn about Wistia's MCP server to enable an AI agent to help manage your account.

Written by Caroline F

With Wistia's Model Context Protocol (MCP) server, you can connect an AI agent directly to your Wistia account.
​
This lets you work with your Wistia content, manage your account, and view information directly from Claude, Cursor, or ChatGPT using plain-language prompts. Instead of digging through documents or writing code, you can make simple requests to get the information you need.
​
At this time, you can enjoy the MCP server free of charge.

Note

Some MCP server actions use paid services or credits, just as they do in Wistia. These include ordering human-generated captions, video dubbing, extended audio descriptions, and Remix edits.

Who can use the Wistia MCP server

Anyone with a Wistia account login (Owners, Managers, Standard, and Limited users) can connect an AI agent. Your agent can only see and do what you can in Wistia.

Note

Your agent has the same permissions you do. For example, a Limited User's agent can only see and work in the folders shared with that user.

Don't have a Wistia account?

If you try to connect an AI tool without a Wistia account, you'll land on the Wistia sign-in screen. You can create a free account from there.

  1. On the sign-in screen, click "Sign up".

  2. Create your free Wistia account.

  3. After you sign up, you'll land on the Wistia welcome page, not back in your AI tool.

Return to your AI tool and authenticate again to finish connecting.

Wistia MCP server capabilities

Wistia's MCP server is a powerful tool that can help you manage your account in many ways.

So, what exactly can it do? Check out each section below for a full breakdown.

Understand your account

The MCP server can help you understand many areas of your account when it comes to management and what's included in your Wistia plan.

  • View your account summary—name, Wistia URL, record counts

  • Check your plan, usage, and limits (storage, bandwidth, seats, webinar minutes)

  • Check the permissions on the API token currently in use

  • Check how many AI Remix credits you have remaining this month

Search your content library

Use the MCP server to search across all of the content in your account.

  • Search across folders, media, Channels, and Channel episodes (it matches names and video transcripts)

  • List media filtered by folder, tag, type, or hashed IDs

  • List folders, subfolders, Channels, Channel episodes, tags, webinars, captions, and localizations

  • Get the filter/sort options for listing Channel episodes

Manage your media

With the MCP server, you can manage all of the media in your account—videos, audio files, images, PDFs. This means you can:

  • Upload a new media file

  • Import media from a public URL

  • Update media metadata

  • Archive, restore, or delete media

  • Swap a media file while keeping the same URL and analytics

  • Copy a single media, or bulk-copy many at once

  • Move media between folders

  • Trim a video to create a new media (you can specify ranges to keep or remove)

Organize and tag content

You can use the MCP server to organize all of the content in your account.

  • Create, update, delete, or copy folders

  • Create, update, delete, or list subfolders

  • Bulk-delete subfolders

  • Share folders with users and user groups: add, update, list, or remove users.

  • Create, list, or delete tags

  • Bulk-tag many media at once

Publish content in Channels

Use the MCP server to organize and manage all of the content in your Channels.

  • Create, update, or delete Channels

  • Create, update, or delete episodes

  • Publish or unpublish episodes

  • List Channels and their episodes

Run webinars

With the MCP server, you can manage many aspects of your webinar experience.

  • Create, update, delete, or list webinars

  • Register people for a webinar

  • List registrations for a webinar

Customize your captions, transcripts, and localizations

Set up your content to be more accessible and reach a wider audience. With the MCP server, you can:

  • Purchase English captions (automated and free or human-generated)

  • Create, update, and delete your own captions file that you upload

  • View a single captions file (metadata and text)

  • Translate a media's transcript into another language

  • Manage video dubbing for media in another language—order, list, view, or delete AI-dubbed localizations of a media

  • Create, list, view, or delete localized versions of a media

  • Order extended audio descriptions and check order status, view, or delete them

Edit videos with Remix

Use Wistia's AI-powered editing tool, Remix, with the Wistia MCP server.

  • Start a new remix with natural-language instructions (e.g., "cut the intro," "make it shorter")

  • Continue editing an existing remix with more instructions

  • Check remix job status

  • Export a finished remix to a folder

Analyze your account performance and programmatically sync data

For account analytics, the MCP server helps you list and organize analytics across all aspects of your account.

  • Account-level: Current snapshot or day-by-day over a date range

  • Media aggregate: Plays, engagement rate, play rate

  • Media trends: Day-by-day time

  • Media engagement: Second-by-second viewer engagement curve

  • Media audience: Languages, geography, and traffic breakdown

  • Media distribution: Embed locations—a snapshot of locations, as well as what's trending.

  • Embed location: Specify a URL and find videos with activity on that exact page

  • Media conversions: Form and CTA conversions

  • Folder-level: Analytics for a folder

  • Webinar-level: Overview of analytics, audience breakdown, engagement histograms, registration, and traffic sources

  • Events: List all play events, view a single event, or get the iframe URL for an event's engagement heatmap

  • Visitors: List visitors and view a specific visitor's full journey with your content

Run background jobs

Many background jobs can run in your Wistia account. The Wistia MCP server lets you check the status of these async jobs (e.g., bulk-deleting subfolders).

Set up the Wistia MCP server

Follow the steps below to connect the Wistia MCP server to Claude Code, Claude, Cursor, or ChatGPT using OAuth, which means signing in with your Wistia login. For a full walk-through, including how to connect with an access token, see our developer documentation.

Tip

If you have access to more than one Wistia account, you'll choose which one to connect when you approve the connection.

Claude Code

To connect to Claude Code using OAuth, run the command:

claude mcp add --transport http wistia https://api.wistia.com/mcp/api

From here (re)start Claude Code, run /mcp, and then do the following:

  • Select "Wistia"

  • Select "Authenticate"

When you do this, a browser window should open up prompting you to
log in. Once you log in, make sure to authorize Claude Code.

Reviewing action permissions

Once connected, open the connector's settings to review which Wistia actions
Claude can run and how much approval each one needs. By default, every action
requires your approval before it runs. You can change this per individual
action, or for whole groups of actions (for example, all get actions, or all
create/destroy actions), setting each to one of:

  • Always allow: Claude runs the action without asking

  • Ask each time: Claude requests your approval before running the action (the default)

  • Never allow: Claude cannot run the action

Read-only get actions are generally safe to always allow; leave actions that
create or destroy data set to ask for approval unless you have a reason to
change them.

Claude

To connect to Claude, go to "Customize" and then "Connectors." Click the "+" sign and then "Add custom connector."

  • Paste in the URL:

https://api.wistia.com/mcp/api
  • Review your settings to determine which actions are always allowed, which require approval, and which are never allowed.

Cursor

To connect to Cursor using OAuth:

  1. Open "Cursor Settings"

  2. Go to "Tools & MCP"

  3. Click "New MCP Server"

  4. Add Wistia to the configuration file so it looks like this:

{
"mcpServers": {
"wistia": {
"url": "https://api.wistia.com/mcp/api"
}
}
}

5. Find the Wistia MCP server in the list, click "Connect," and accept any prompts from Cursor.

6. When a browser window opens, sign in to Wistia and authorize Cursor.

Tip

If you already have other MCP servers set up in Cursor, add the Wistia entry alongside them inside "mcpServers."

ChatGPT

Wistia is available as an app in ChatGPT's app directory, so you don't need to copy and paste a URL.

  1. In ChatGPT, open the apps directory and search for "Wistia," or go straight to the Wistia app.

  2. Click "Connect".

  3. When prompted, sign in to Wistia and approve the connection.

Once you're connected, you can ask ChatGPT about your Wistia content, or have it manage your account, right in the chat.

Did this answer your question?