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!
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
- GitHub: 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.