# SproutVideo MCP > SproutVideo MCP Server manages video hosting, playlists, and analytics for any AI agent. Use it to list all videos, update metadata programmatically, track engagement stats, or delete old assets without opening a browser. It's full content management control through natural conversation. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** video-hosting, video-cms, streaming, video-marketing, content-management, sproutvideo ## Description **SproutVideo MCP Server** gives your AI agent full content management control over your video hosting account, letting you manage everything—playlists, analytics, and assets—without ever opening the browser. You'll handle your entire content pipeline using only chat prompts, keeping your workflow sharp and efficient. ### Managing Your Content Library Structure You need to know what's in there before you change a thing. To start an audit, run `list_videos` to get a basic list of every video asset hosted on the platform along with its initial metadata. If you want more depth on that specific video, use `get_video_details`; this pulls all stored information about a single file, including its precise dimensions and file path. To map out your whole content structure, check what folders you've set up using `list_folders`. You can also run `list_playlists` to see every video grouping you’ve created. For cataloging purposes, use `list_video_tags`—this pulls a list of every unique tag used across all your videos, which helps you map out how your content is actually organized. ### Analyzing Performance and Metadata You don't want to guess if a video hit or missed. Run `get_video_analytics` on any specific asset; it gives you deep usage metrics like the total number of plays and detailed viewer retention data, so you know exactly where people drop off. When you need to fix something—say, someone misspelled the title or you grouped content under the wrong tag—you don't touch a GUI. You simply use `update_video_metadata` to change the title, description, or tags for one or several specific video assets in bulk. ### Building and Organizing Playlists Keep your content curated. To start grouping videos, run `create_playlist`; this builds an entirely new collection of videos you can assign to a campaign. If you need to see what playlists already exist, use `list_playlists`. To check the contents of a specific group or get all the details about one playlist, call `get_playlist`. This tells your agent exactly which assets belong in that grouping. ### Maintenance and Account Health When you're done with an asset, don't just ignore it. You can permanently remove old or redundant videos using `delete_video`, taking the asset right out of your library. For keeping tabs on overhead, run `get_account`; this pulls all your overall usage data and shows you what your current account limits are. These tools let you maintain complete control over every video, tag, folder, and playlist in SproutVideo, doing it all through natural conversation with your AI client. ## Tools ### create_playlist Creates a new video playlist collection in your account. ### get_account Retrieves overall usage data and current account limits for tracking overhead. ### get_playlist Fetches detailed information about a specific video playlist, including its contents. ### get_video_analytics Pulls deep usage metrics for one video, like total plays and viewer retention data. ### list_folders Lists every organizational folder currently set up in your SproutVideo account structure. ### delete_video Permanently removes a specified video asset from your library. ### get_video_details Retrieves all stored information about a single video asset, including its file path and dimensions. ### list_playlists Retrieves a list of all existing video playlists you've created. ### list_video_tags Lists every unique tag used across your entire library, helping you map content structure. ### list_videos Retrieves a list of all videos hosted on the platform and their basic metadata. ### update_video_metadata Changes the title, description, or tags for one or more specified video assets. ## Prompt Examples **Prompt:** ``` List all videos in SproutVideo. ``` **Response:** ``` I've retrieved your video library. You have 20 videos, including 'Product Demo 2024' (Duration: 120s) and 'Customer Success Story'. ``` **Prompt:** ``` Show me the video engagement analytics for all published videos with viewer retention data. ``` **Response:** ``` 45 published videos analyzed. Total plays: 23,400 this month. Total watch time: 1,234 hours. Average engagement: 67%. Top 5 by plays: "Product Demo 2025" (4,560 plays, 78% engagement, avg 4:23 watch time), "Getting Started Tutorial" (3,200 plays, 82%), "Customer Success Story" (2,100 plays, 71%), "Feature Walkthrough" (1,890 plays, 64%), "CEO Keynote" (1,456 plays, 55%). Retention analysis: 89% watch past 25%, 67% past 50%, 45% past 75%, 34% complete. Drop-off hotspots: intro screens (first 10 seconds). Bandwidth: 890 GB served. ``` **Prompt:** ``` Create a new playlist called Product Tutorials and add the top 5 most viewed tutorial videos. ``` **Response:** ``` Playlist created: "Product Tutorials". 5 videos added by view count: 1) "Getting Started Tutorial" (3,200 plays, 12 min). 2) "Feature Walkthrough" (1,890 plays, 8 min). 3) "Advanced Configuration" (1,234 plays, 15 min). 4) "API Integration Guide" (987 plays, 20 min). 5) "Mobile App Setup" (756 plays, 6 min). Total playlist duration: 61 minutes. Privacy: public (embeddable). Custom thumbnail generated from first video. Embed code and share link ready. SEO metadata: title and description auto-populated. Player: branded with company colors. ``` ## Capabilities ### List and Filter Video Assets Retrieve a list of all videos, folders, or playlists in your SproutVideo account using `list_videos` or `list_playlists`. ### Pull Performance Metrics Get detailed analytics for specific videos, including total plays and engagement rates, via the `get_video_analytics` tool. ### Update Video Metadata Change a video's title, description, or tags without touching the web interface by running `update_video_metadata`. ### Build and Query Playlists Create new collections of videos with `create_playlist`, or retrieve details about existing groupings using `get_playlist`. ### Perform Content Audits Understand your library structure by listing all available tags (`list_video_tags`) or retrieving folder structures (`list_folders`). ## Use Cases ### The Quarterly SEO Audit A Content Manager needs to ensure every video asset has the current brand name in its description. Instead of logging into SproutVideo and manually editing 80 videos, they ask their agent: 'Run `list_videos` and then for all results, use `update_video_metadata` to change the descriptor to [New Brand Name].' The server handles the loop, saving hours. ### Launching a New Campaign Series A Digital Marketing Specialist has 15 new videos ready. They ask their agent: 'Create a playlist called 'Q3 Launch Assets' and add all videos tagged 'New Product'. Then, run `get_playlist` to confirm everything is grouped correctly.' The entire campaign setup happens in minutes. ### Debugging Low Engagement A Video Producer notices one video underperforms. They ask their agent: 'Run `get_video_analytics` on the ID 12345 video. I need to know the total plays, average engagement rate, and retention data.' The server immediately returns the stats needed for a strategic pivot. ### Archiving Old Content A team needs to clear out drafts older than 6 months. They ask their agent: 'List all videos tagged 'Draft' and run `delete_video` on any that haven't been accessed in a year.' The server executes the clean-up, preventing storage bloat. ## Benefits - Stop manually updating titles. Use `update_video_metadata` to push bulk changes across dozens of videos instantly, keeping your SEO data consistent without opening the web GUI. - Get granular performance checks using `get_video_analytics`. You can query total plays and specific retention rates for any video—data you need for campaign reports. - Keep content organized with playlists. Use `create_playlist` to group top-performing videos, or run `list_playlists` to see what collections you already have set up. - Audit your library structure quickly. If you're unsure how tags are being used, run `list_video_tags`. It pulls out every tag in one command so you can find gaps in your content strategy. - Automate cleanup and maintenance. Need to delete old drafts? Use `delete_video` or check usage limits with `get_account` before running big operations. ## How It Works The bottom line is: your AI client runs video ops directly against your SproutVideo account, giving you programmatic control over content management tasks. 1. Subscribe to the SproutVideo server and provide it with your API Key from your SproutVideo account settings. 2. Point your AI client (Claude, Cursor, etc.) at this MCP Server endpoint. It authenticates your connection. 3. Tell your agent exactly what you want—e.g., 'List all videos tagged 'Product Demo''—and the server executes the necessary tools. ## Frequently Asked Questions **How do I check my video usage limits using `get_account`?** You call the `get_account` tool. It retrieves your current account information and shows you exactly what your usage is versus any set limits. This helps prevent unexpected service interruptions. **Can I bulk update titles using `update_video_metadata`?** Yes, that's one of its core jobs. You can specify a list of video IDs and provide the new title for all of them in a single request. **What does the `get_video_analytics` tool return?** It returns specific performance data for one video, including total plays, engagement percentage, and crucial viewer retention metrics. You'll get the hard numbers you need for reports. **How do I find all available tags with `list_video_tags`?** You simply call `list_video_tags`. It returns a complete list of every tag used across your entire SproutVideo library, helping you audit your content structure. **If I run `get_account` and my API key fails, how does the agent handle the error?** The system returns a specific 401 authentication failure code. You simply need to update your SproutVideo API key within Vinkius settings for the agent to connect properly. **When I use `create_playlist`, what information must I provide to ensure it works?** You must supply a name and either a description or at least one video ID. The agent validates these required fields before the playlist is actually created. **Does running `delete_video` check if other playlists still reference that file?** Yes, the tool checks for internal dependencies first. If another playlist points to the video you want gone, it warns you instead of executing the deletion. **Beyond basic metadata, what extra data does `get_video_details` return?** It provides deep specs like the full resolution format, original upload date, and internal folder ID. This gives complete context for archiving or migration tasks. **Can I list all my hosted videos using my AI agent?** Yes! Use the `list_videos` tool to retrieve a comprehensive list of all videos currently hosted in your account.