# Wistia MCP MCP > Wistia MCP gives your AI agent full control over your video marketing assets, projects, and analytics inside Wistia. You can list every asset, check deep engagement statistics for any video, organize massive media libraries into specific folders, or even trigger the platform to download content from external URLs—all via conversation. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** video-hosting, video-marketing, engagement-analytics, media-management, content-distribution, video-player ## Description Running a content operation means constantly jumping between dashboards just to track performance or find a link. This MCP lets your AI agent handle that entire workflow through natural chat. Need to know which videos are performing well? Your agent retrieves detailed engagement statistics, showing play rates and average watch times without you exporting a spreadsheet. You can also organize huge media libraries by creating new projects or updating video titles and descriptions across the board. The real power comes when you chain this MCP with others; for example, connecting it to a CRM MCP allows your agent to pull performance data (using tools like `get_engagement_statistics`) and immediately draft an outreach message based on that performance. Because Vinkius manages all credentials through a zero-trust proxy, your API keys never sit anywhere but in transit. You just connect once from any compatible client and manage complex video pipelines without the manual clicks. ## Tools ### create_new_project Creates a new, dedicated project folder to organize related media assets. ### delete_media_asset Permanently deletes a single Wistia video or audio file and all its associated content. ### delete_wistia_project Deletes an entire project folder, losing every video and asset inside it—this is irreversible. ### get_engagement_statistics Retrieves a summary of viewer data for a specific video, including play rates and average watch time. ### get_media_details Fetches all technical metadata and information about one specific media asset. ### get_project_details Retrieves the full details of a project folder, including every piece of content housed within it. ### list_wistia_medias Lists all video and audio files currently stored in your entire Wistia account. ### list_wistia_projects Retrieves a list of every project folder you have set up in your account. ### update_media_metadata Changes the name or description for an existing video asset using its unique hashed ID. ### upload_video_via_url Instructs Wistia to download and host a new video by pointing it to a public web URL. ## Prompt Examples **Prompt:** ``` List all my videos in Wistia. ``` **Response:** ``` I found 12 videos in your account. The most recent are 'Spring Launch Overview' (ID: abc123def), 'Product Demo v2' (ID: ghi456jkl), and 'Customer Story' (ID: mno789pqr). Would you like to see the performance stats for any of these? ``` **Prompt:** ``` What are the engagement stats for the video with ID 'abc123def'? ``` **Response:** ``` Engagement summary for abc123def: Play rate is 42%, and the average watch time is 68%. Total plays: 1,250. The video is performing well compared to your project average. ``` **Prompt:** ``` Upload the video from 'https://example.com/promo.mp4' to my 'Campaigns' project. ``` **Response:** ``` Success! I've triggered Wistia to ingest 'promo.mp4' into your 'Campaigns' project (ID: proj-xyz). It will appear in your library once processing is complete. Is there anything else you need me to organize? ``` ## Capabilities ### List Assets and Projects You can retrieve a full inventory of every video and audio asset, plus list all organizational project folders. ### Analyze Performance Metrics Get detailed viewer statistics for any specific video, including the play rate and average watch time. ### Manage Content Lifecycle Update metadata (titles/descriptions) on assets or permanently remove obsolete videos and entire projects. ### Ingest External Videos Trigger Wistia to download and host video content directly from a public URL into a target project. ### Discover Asset IDs Quickly find the unique hashed ID for any media asset or project needed for automated workflows. ## Use Cases ### Auditing old content The data analyst needs to find out every piece of video created last quarter. They ask their agent, and it runs `list_wistia_medias` to surface a comprehensive list with asset IDs. ### Launching a campaign folder The content manager needs a dedicated space for the Q3 product launch videos. They ask the agent to run `create_new_project`, and it gets the new project ID, ready for uploads. ### Quickly embedding video assets A developer needs an embed link for a specific asset but only knows its general name. They ask the agent to use `get_media_details` to retrieve all necessary technical metadata and direct URLs. ### Consolidating scattered videos The team finds several great educational videos online that need hosting. They tell their agent to `upload_video_via_url`, pointing it to the source links, which automatically ingests them into a specified project. ## Benefits - Stop manually logging into Wistia. You can tell your agent to `list_wistia_medias` and get a full inventory of everything without leaving the chat window. - Never guess how well content is performing. Use `get_engagement_statistics` to pull deep metrics like play rates for immediate reporting. - Need a clean slate? You can use `create_new_project` to organize media or, if something's totally obsolete, run `delete_media_asset` to wipe it out permanently. - Building content requires new material. Use `upload_video_via_url` to ingest videos from any public link right into a specific project folder. - Metadata changes are simple. You can update titles and descriptions across the board using `update_media_metadata` by just providing the unique asset ID. ## How It Works The bottom line is you talk to your agent about videos and projects; it executes the commands against Wistia automatically. 1. Subscribe to this MCP and provide your Wistia API Token. 2. Connect your preferred AI client (like Cursor) to the Vinkius platform via that single token. 3. Ask your agent a question, like 'What's the play rate for my last campaign video?' The agent handles the rest. ## Frequently Asked Questions **How do I find all my videos using list_wistia_medias?** You just ask your agent to run `list_wistia_medias`. It returns a full, structured inventory of every video and audio asset in the account. **Can I update titles for multiple videos with update_media_metadata?** Yes. You supply the agent with several unique hashed IDs and a JSON object containing the new metadata you want to apply across all of them. **What if I need to organize my content using create_new_project?** You ask the agent to run `create_new_project` with the desired name, and it handles setting up the new folder structure for you. **How do I get engagement stats on a video? (get_engagement_statistics)** You ask your agent to run `get_engagement_statistics` and provide the unique media ID. It returns play rates, average watch time, and total plays. **If I run 'delete_wistia_project' or 'delete_media_asset', are these actions recoverable?** No, deletion is irreversible. The MCP executes permanent commands; always double-check the asset ID or project name before you confirm a delete action. **How do I get a full inventory of media within a specific folder using 'get_project_details'?** It pulls all metadata for that designated project, giving you a complete asset list. This is much faster than listing every single file in your entire Wistia account. **When I use 'upload_video_via_url', how soon will the content be ready to view?** The MCP just triggers the download process. The video won't appear instantly; you have to wait for Wistia to fully process and ingest it before it shows up in your library. **What technical information does 'get_media_details' give me beyond the title?** It provides comprehensive metadata, including hashed IDs and direct asset URLs. You need these details when writing scripts or automating video embeds.