# Gumlet MCP MCP > Gumlet MCP manages your entire media workflow, letting you handle video uploads, image optimization, and CDN delivery straight through conversation. It gives you control over complex assets—from listing folders to checking viewing stats—without opening a dashboard or writing code. ## Overview - **Category:** image-video - **Price:** Free - **Tags:** video-hosting, image-optimization, cdn-delivery, transcoding, media-management, format-conversion ## Description Stop navigating clunky web dashboards just to check if an upload finished or grab some analytics. This MCP lets your AI agent treat Gumlet like a dedicated media operations team. You manage video life cycles, build structured collections, and handle image source updates using natural language conversation. It's about getting data when you need it. Need to know how many people watched last week? Just ask. Want to move an asset into a new folder or update that crucial thumbnail frame? Tell the agent. The whole process—from listing available users to deleting old videos and checking bandwidth usage—happens instantly through your AI client. By connecting Gumlet via Vinkius, you turn complex media infrastructure management into simple chat commands. ## Tools ### create_video_upload Initiates the process of uploading and processing a brand-new video asset. ### create_collection Adds a new folder to your media library organization structure. ### delete_video Removes an existing video asset from your account. ### get_video_details Checks the current status of a video asset, including its transcoding progress. ### get_account_info Retrieves basic details about your Gumlet profile and account settings. ### get_video_analytics Fetches detailed statistics, such as unique views and bandwidth usage, for a specific video. ### list_videos Gets a comprehensive listing of all current video assets in the account. ### list_video_collections Retrieves a list of all existing video folders in your library. ### list_image_sources Shows all available sources used for optimizing your image delivery. ### list_org_users Lists the team members and users who have access to the account. ### list_webhooks Retrieves information about any active webhooks configured for your account. ### update_video_thumbnail Sets a new thumbnail image by specifying the exact time or frame offset within a video. ## Prompt Examples **Prompt:** ``` Create a new video upload in collection 'col_123' titled 'Annual Report 2026'. ``` **Response:** ``` Upload initialized! I've created the asset 'Annual Report 2026' (ID: asset_987). You can now upload your file to the following URL: [upload_url]. I'll monitor the transcoding status for you. ``` **Prompt:** ``` Check the transcoding status of video 'asset_987'. ``` **Response:** ``` Checking asset_987... The video is currently 75% through transcoding. I'll alert you as soon as the HLS and DASH streams are ready for playback. ``` **Prompt:** ``` Show me the viewing stats for my latest product video. ``` **Response:** ``` Fetching analytics... Your latest video has 1,250 unique views and has consumed 45GB of bandwidth this month. Most viewers are based in North America and Europe. ``` ## Capabilities ### Organize Media Libraries Create new folders or collections for videos and images to keep your assets structured. ### Upload and Track Video Assets Upload new video files, track their transcoding status, and monitor the overall health of your media library. ### Check Performance Metrics Retrieve real-time analytics on viewing stats, bandwidth consumption, and asset performance for specific videos. ### Control Visual Assets Programmatically update video thumbnails by specifying exact frames or time offsets. ### Manage Users and Sources List team members and manage the sources used for image optimization to maintain content integrity. ## Use Cases ### Need to audit a campaign's reach? A marketer needs to know how many unique views the 'Q3 Product Launch' video got last month and which regions are driving traffic. They ask their agent, and it calls `get_video_analytics` immediately, returning the data they need. ### Need to move a finished asset? A content manager finishes an initial draft video and needs to place it into the 'Client Approved' folder. The agent uses `create_collection` first (if needed) and then guides the upload, keeping the library perfectly structured. ### Need to update branding visuals? A developer is told the video thumbnail needs to show a specific product feature at 15 seconds. Instead of manually editing frames, they use `update_video_thumbnail` and provide the exact time code. ### Need to clean up old data? An ops engineer wants to clear out all the raw video files from 2018 that are no longer needed. They use `list_videos` to confirm the assets and then instruct the agent to run `delete_video` on the specific IDs. ## Benefits - Stop manually checking status. You can use `get_video_details` to check a video's transcoding progress and know exactly when it's ready for public use. - Keep your content organized instantly by using `create_collection` or listing all folders with `list_video_collections`, letting you structure huge media libraries without clicking through dozens of menus. - Never guess the stats again. Run `get_video_analytics` to pull viewing metrics and bandwidth usage for any video, giving you instant performance insights. - Fine-tune your visual marketing assets by calling `update_video_thumbnail`, allowing you to select a specific time offset or frame for perfect visuals. - Manage team access easily. You can list all organizational users with `list_org_users` and check image source availability via `list_image_sources` in one conversation. ## How It Works The bottom line is, instead of logging into a website and clicking through menus, you just talk to your AI client about your media needs. 1. Subscribe to this MCP and retrieve your API Key from your Gumlet account dashboard. 2. Connect that key in your preferred AI client (like Cursor or Claude). 3. Ask your agent what you need done—for example, 'Check the stats for the Annual Report video'—and it executes the task directly against your media assets. ## Frequently Asked Questions **How do I check if a video finished processing with get_video_details?** You provide the asset ID, and the agent reports its status. It will confirm when transcoding is complete, letting you know exactly when it's ready for public use. **Can I organize my videos into specific folders using create_collection?** Yes. The `create_collection` tool lets you programmatically build out your media library structure before uploading content to keep things tidy. **What is the best way to get performance data for a video? Use get_video_analytics?** Yes, that's right. `get_video_analytics` pulls specific metrics like unique views and bandwidth consumption, giving you actionable insights without leaving your chat window. **Do I need to run list_videos before uploading a new video?** No. While you can use `list_videos` at any time to see what's there, the upload process starts with `create_video_upload`, which handles the asset ingestion. **How do I check which team members are set up in my organization using list_org_users?** It lists all current users and their associated roles. This lets you manage access and know who can view or contribute to your media assets. **What specific data does list_image_sources provide regarding my optimized images?** This tool retrieves details about the image sources configured for optimization. You'll get the necessary identifiers and settings required to ensure high-fidelity delivery across all your content. **If I need to remove an old video asset, how do I use delete_video?** You send this command with the specific video ID. This permanently removes the video from Gumlet and cleans up the associated storage space for you. **What is the purpose of list_webhooks when setting up my media pipeline?** This checks all active webhooks connected to your account. It lets you verify which external services are receiving updates when key events, like uploads or status changes, occur. **How do I start a video upload?** Use the `create_video_upload` tool, which will create the asset in your specified collection and provide a temporary `upload_url` for your file. **Can I update the thumbnail for a video already uploaded?** Yes! The `update_video_thumbnail` tool allows you to specify a time offset in seconds. Gumlet will extract that specific frame and set it as the new thumbnail. **Does it support viewing stats and bandwidth usage?** The `get_video_analytics` tool provides detailed viewing metrics and bandwidth consumption data for any video ID in your account.