--- title: Vidalytics MCP — Manage Your Videos by Talking to Your AI description: How to use the Vidalytics MCP connector to manage your video library from Claude, Cursor, or Windsurf — without opening the dashboard. --- [Skip to content](https://help.vidalytics.com/vidalytics-mcp-manage-your-videos-by-talking-to-your-ai#main-content) English Show submenu for translations ![Logo Inline Blue](https://help.vidalytics.com/hs-fs/hubfs/Logo%20Inline%20Blue.png?width=200&height=29&name=Logo%20Inline%20Blue.png) Open main navigation Close main navigation - English Show submenu for translations - Contact us Contact us How can we help you? - There are no suggestions because the search field is empty. 1. [Vidalytics Knowledge Center](https://help.vidalytics.com/?hsLang=en) 2. [Integrations & Embedding](https://help.vidalytics.com/integrations-embedding?hsLang=en) 3. [Automations](https://help.vidalytics.com/integrations-embedding?hsLang=en#automations) # Vidalytics MCP — Manage Your Videos by Talking to Your AI ## How to use the Vidalytics MCP connector to manage your video library from Claude, Cursor, or Windsurf — without opening the dashboard. The Vidalytics MCP connector lets you manage your videos by simply asking your AI assistant. Instead of opening the Vidalytics dashboard for routine updates, you can publish settings, duplicate videos, create CTAs, set thumbnails, and more — all from Claude, Cursor, or Windsurf in plain English. **Availability & Restrictions** - Available on **Premium and Enterprise plans** - Uses your existing **Public API quota** — no separate MCP fee or additional credits - Sub-users need the **Manage API permission** enabled to use MCP - Supported clients: **Claude Desktop/CLI**, **Cursor**, **Windsurf** ### **What You Can Do With MCP** Here is a full overview of what is currently supported: | Task | Example Prompt | | --- | --- | | Upload a video from a URL | "Upload this video from \[URL\] into the Launch folder." | | Publish draft settings | "Publish the draft settings on my checkout VSL." | | Duplicate a video | "Duplicate the webinar replay into the Test folder." | | Apply a settings template | "Apply the Webinar template to this video and publish." | | Create or update a CTA | "Add a CTA at 80% that links to \[URL\]." / "Update that CTA copy to…" | | Set a thumbnail | "Set the thumbnail from the frame at 0:12." / "Use this image URL as the thumbnail." | | Restore default thumbnail | "Restore the default thumbnail on this video." | | Create a folder | "Create a nested folder called Launch 2026 under Campaigns." | | Rename a video | "Rename this video to \[new title\]." | | Move a video | "Move this video into the Launch folder." | | Find videos and analytics | "Show me the retention data for my homepage VSL." / "How many live viewers does my webinar have right now?" / "Give me stats across all videos in the Launch folder." | | Get embed code | "Get the embed code for my webinar replay." | ### **Not currently supported via MCP:** - Deleting a video, CTA, or folder - Editing raw player settings field by field - Creating or editing pause screens - Uploading a thumbnail from a local file - Running Settings Experiments **Note:** For anything not supported in MCP, use the Vidalytics dashboard as usual. ### **How to Get Started** **Install MCP** — run the following command in your terminal: ``` npx @vidalytics/mcp install ``` **Restart your MCP client** — after installation, restart Claude Desktop, Cursor, or Windsurf. **Authenticate** — complete the OAuth flow on first use to connect your Vidalytics account. **Start prompting** — that's it. You can now manage your videos by talking to your AI. **Watch a step by step demo video below!** **[![Video+Thumbnail+KB-May-12-2026-11-43-09-6675-PM](https://help.vidalytics.com/hs-fs/hubfs/Knowledge%20Base%20Import/Video+Thumbnail+KB-May-12-2026-11-43-09-6675-PM.png?width=670&height=379&name=Video+Thumbnail+KB-May-12-2026-11-43-09-6675-PM.png)](https://preview.vidalytics.com/vid/MrZZ2Xdmq8iIYXCv)** **Note:** If MCP asks you to log in again or fails to connect, delete `~/.mcp-auth` and restart your client, then complete the OAuth flow again. ### **How Key Actions Work** **Publishing** Asking your AI to publish a video publishes any pending draft settings — exactly the same as clicking **Publish** in Vid Settings. It does not upload a new file or create a new video entry. **Duplicating** When you ask your AI to duplicate a video, a new published copy is created in your library immediately, ready to edit. This is not the same as Settings Experiments — duplicates are separate library entries. **Applying a Settings Template** When you apply a settings template, the settings are applied to the video. Your AI will confirm whether you want to publish immediately or hold the changes as a draft. **CTAs** You can create new CTAs or update existing ones — timing, URL, and copy. Pause screens are read-only in MCP. Deleting CTAs is not supported. **Thumbnails** You can set a thumbnail from a public image URL, from a specific frame in the video, or restore the default thumbnail. Uploading a thumbnail from a local file is not currently supported. **Folders** You can create folders, including nested ones. Renaming or deleting folders is not currently supported in MCP. **Resources:** - **npm package:** [npmjs.com/package/@vidalytics/mcp](https://www.npmjs.com/package/@vidalytics/mcp) - **GitHub:** [github.com/vidalytics/vidalytics-mcp](https://github.com/vidalytics/vidalytics-mcp) - **Install command:** `npx @vidalytics/mcp install` --- If you have any questions, feedback, or need assistance, feel free to reach out to our Customer Happiness Team at [hi@vidalytics.com](mailto:hi@vidalytics.com).  - [Account Management & Billing](https://help.vidalytics.com/account-management-billing?hsLang=en#main-content) - [Account Management](https://help.vidalytics.com/account-management-billing?hsLang=en#account-management) - [Billing](https://help.vidalytics.com/account-management-billing?hsLang=en#billing) - [Bandwidth](https://help.vidalytics.com/account-management-billing?hsLang=en#bandwidth) - [Team & Users](https://help.vidalytics.com/account-management-billing?hsLang=en#team-users) - [Plans & Upgrades](https://help.vidalytics.com/account-management-billing?hsLang=en#plans-upgrades) - [Affiliates](https://help.vidalytics.com/affiliates?hsLang=en) - [Video Management](https://help.vidalytics.com/video-management?hsLang=en#main-content) - [Uploading](https://help.vidalytics.com/video-management?hsLang=en#uploading) - [Video Management](https://help.vidalytics.com/video-management?hsLang=en#video-management) - [Integrations & Embedding](https://help.vidalytics.com/integrations-embedding?hsLang=en#main-content) - [Landing Page Builders](https://help.vidalytics.com/integrations-embedding?hsLang=en#landing-page-builders) - [CRM & Email Integrations](https://help.vidalytics.com/integrations-embedding?hsLang=en#crm-email-integrations) - [Automations](https://help.vidalytics.com/integrations-embedding?hsLang=en#automations) - [E-commerce](https://help.vidalytics.com/integrations-embedding?hsLang=en#e-commerce) - [Tagging & Tracking](https://help.vidalytics.com/tagging-tracking?hsLang=en#main-content) - [Tagging Basics](https://help.vidalytics.com/tagging-tracking?hsLang=en#tagging-basics) - [Conversion Tracking](https://help.vidalytics.com/tagging-tracking?hsLang=en#conversion-tracking) - [Zapier & Automation](https://help.vidalytics.com/tagging-tracking?hsLang=en#zapier-automation) - [Troubleshooting](https://help.vidalytics.com/troubleshooting?hsLang=en#main-content) - [Embedding Issues](https://help.vidalytics.com/troubleshooting?hsLang=en#embedding-issues) - [General Troubleshooting](https://help.vidalytics.com/troubleshooting?hsLang=en#general-troubleshooting) - [Analytics & Metrics](https://help.vidalytics.com/analytics-metrics?hsLang=en#main-content) - [Understanding Your Data](https://help.vidalytics.com/analytics-metrics?hsLang=en#understanding-your-data) - [Dashboard](https://help.vidalytics.com/analytics-metrics?hsLang=en#dashboard) - [Vids Stats](https://help.vidalytics.com/analytics-metrics?hsLang=en#vids-stats) - [Player & Display Settings](https://help.vidalytics.com/player-display-settings?hsLang=en#main-content) - [Player Setup](https://help.vidalytics.com/player-display-settings?hsLang=en#player-setup) - [Playback & Behavior](https://help.vidalytics.com/player-display-settings?hsLang=en#playback-behavior) - [Player Features](https://help.vidalytics.com/player-display-settings?hsLang=en#player-features) - [Advanced & Developer](https://help.vidalytics.com/player-display-settings?hsLang=en#advanced-developer) - [Captions](https://help.vidalytics.com/player-display-settings?hsLang=en#captions) - [Thumbnails](https://help.vidalytics.com/player-display-settings?hsLang=en#thumbnails) - [Vids AI](https://help.vidalytics.com/vids-ai?hsLang=en#main-content) - [AI features](https://help.vidalytics.com/vids-ai?hsLang=en#ai-features) - [Agencies](https://help.vidalytics.com/agencies?hsLang=en#main-content) - [Account Management](https://help.vidalytics.com/agencies?hsLang=en#account-management) - [Experiments & Split Testing](https://help.vidalytics.com/experiments-split-testing?hsLang=en#main-content) - [Setup & How-To](https://help.vidalytics.com/experiments-split-testing?hsLang=en#setup-how-to) - [Reference & FAQs](https://help.vidalytics.com/experiments-split-testing?hsLang=en#reference-faqs) - [Conversion & Engagement Tools](https://help.vidalytics.com/conversion-engagement-tools?hsLang=en#main-content) - [CTAs](https://help.vidalytics.com/conversion-engagement-tools?hsLang=en#ctas) - [Engagement Features](https://help.vidalytics.com/conversion-engagement-tools?hsLang=en#engagement-features) - [Thumbnails & Visual](https://help.vidalytics.com/conversion-engagement-tools?hsLang=en#thumbnails-visual) - [Getting Started](https://help.vidalytics.com/getting-started?hsLang=en#main-content) - [Platform Basics](https://help.vidalytics.com/getting-started?hsLang=en#platform-basics) - [Platform Reliability](https://help.vidalytics.com/getting-started?hsLang=en#platform-reliability) - [Smart Vids](https://help.vidalytics.com/smart-vids?hsLang=en#main-content) - [Setup & Configuration](https://help.vidalytics.com/smart-vids?hsLang=en#setup-configuration) - [Advanced Features](https://help.vidalytics.com/smart-vids?hsLang=en#advanced-features) - [Tagging & Data](https://help.vidalytics.com/smart-vids?hsLang=en#tagging-data) [![Logo Inline Blue](https://help.vidalytics.com/hs-fs/hubfs/Logo%20Inline%20Blue.png?width=200&height=29&name=Logo%20Inline%20Blue.png "Logo Inline Blue")](https://help.vidalytics.com/?hsLang=en) [mailto:hi@vidalytics.com](mailto:hi@vidalytics.com) Copyright © 2026, Vidalytics Inc