# api.video MCP for AI Agents AI Agent Connect > api.video MCP lets you take full control of your video infrastructure through natural conversation. You can upload content, manage live streams, pull performance metrics, and customize video players without leaving your chat or editor. It handles everything from creating video containers and managing watermarks to generating AI summaries and setting up webhooks for real-time automation. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_AAgxPvJfVVDY5RiNgqzHB92Z5NB9dYEDsZzCrPyW/ai-agent-connect - **Tags:** video-hosting, video-streaming, encoding, media-infrastructure, video-analytics, api-first ## Description The api.video MCP lets you take full control of your video infrastructure through natural conversation. Imagine you're managing a massive library of video content. Usually, this means jumping between a dashboard, an FTP client, and a spreadsheet to track encoding statuses, update metadata, and manage player themes. With this Connector, that workflow disappears. You can just tell your AI agent to organize your library, and it handles the heavy lifting. It can create new video containers, manage your live streaming sessions, and even set up webhooks so you're notified the moment a video is ready for distribution. If you need to know how your audience is reacting, your agent can pull specific analytics breakdowns or time-series data instantly to help you make better content decisions. You can also customize the viewer experience by tweaking player themes or adding watermarks on the fly. It even handles the tedious stuff like generating summaries or adding chapters to make your content more searchable and accessible. Because Vinkius makes it so easy to connect these capabilities into a single interface, your AI becomes a dedicated video engineer. You get to stay focused on the creative side while the agent handles the technical pipeline of uploading, streaming, and analyzing. This means you can move from a messy pile of tasks to a clean, automated system where your AI handles the logistics of your video business. ## Tools ### list_video_captions List captions for a video ### list_video_chapters List chapters for a video ### list_player_themes List custom player themes ### update_video_details Modify video metadata ### create_video_object Set title and description here. Initialize a new video ### get_video_analytics Retrieve performance metrics ### get_video_details Get metadata for a video ### delete_video Permanently deletes a video object. Use this to remove content from your library. ### list_videos Lists all video objects in your project. Use this to see your entire video library at a glance. ## Prompt Examples **Prompt:** ``` How's my content doing lately? ``` **Response:** ``` I've pulled your latest metrics. Your 'Product Demo' video has a 78% retention rate, while the 'Customer Interview' is seeing a 12% increase in viewership this week. Would you like a full breakdown of the time-series data? ``` **Prompt:** ``` Can you set up a live stream for my webinar tomorrow? ``` **Response:** ``` I've created a new live stream called 'Webinar: Q4 Strategy'. Here are the details: * **Stream Key:** `x7y2z9...` * **RTMP URL:** `rtmp://broadcast.api.video/s` I've also set up a webhook to notify you as soon as the stream goes live. ``` **Prompt:** ``` Make the 'Product Demo' video more searchable. ``` **Response:** ``` I've generated a summary for 'Product Demo' with a clear abstract and key takeaways. I also updated the player theme to include your new logo and added a watermark to the corner. Your content is now much more accessible. ``` ## Capabilities ### Manage video libraries Create, update, and delete video containers and assets across your project. ### Control live streams Start, stop, and update live broadcast settings with simple commands. ### Pull performance data Get aggregated analytics and time-series metrics for your content. ### Customize video players Manage themes, watermarks, and logos to brand your viewer experience. ### Enrich video content Generate summaries, chapters, and captions to improve accessibility. ### Automate with webhooks Set up event triggers and manage upload tokens for secure ingestions. ## Use Cases ### Updating thumbnails for a new campaign A content manager has 50 videos and needs to update the thumbnail for all of them. They ask the agent to use update_thumbnail for every video in the list to set a consistent look. ### Quickly spinning up a live broadcast A live streamer wants to start a webinar but hates the setup. They tell the agent to create_live_stream, then they just copy the RTMP URL and Stream Key from the chat. ### Monitoring a batch encoding queue A developer needs to know if a batch of videos finished encoding. The agent uses get_video_status on a list of IDs and reports back only the ones that are still processing. ### Compiling a weekly performance report A data analyst needs a weekly viewership report. The agent runs get_metrics_timeseries and get_metrics_breakdown to compile a summary of viewership trends. ## Benefits - Stop manual dashboard navigation by using list_videos and get_video_status to check your entire library from a chat. - Automate your content distribution by using create_webhook to trigger actions the moment your videos are ready. - Improve viewer engagement by quickly updating player themes with update_player and delete_player_logo. - Speed up content production by using create_summary and create_upload_token to handle metadata and secure uploads. - Get deeper insights into your audience by pulling time-series data with get_metrics_timeseries and get_metrics_breakdown. - Enhance accessibility for all viewers by managing captions and chapters with list_captions and list_chapters. ## How It Works The bottom line is you get a hands-free way to manage a professional video pipeline using only natural language. 1. Subscribe to the api.video MCP on the Vinkius Marketplace. 2. Enter your api.video API key to authorize the connection. 3. Start asking your AI client to manage your videos, streams, or analytics. ## Frequently Asked Questions **Can the api.video MCP help me manage my live streams?** Yes, it lets you create, update, and stop live streams using just text commands. You can get your stream keys and RTMP URLs instantly through your AI client. **How do I use api.video to get my video analytics?** Your agent can pull aggregated metrics and time-series data. You can ask for specific breakdowns to see how your content is performing over time. **Can this Connector help with video accessibility?** Yes, you can use it to manage captions and chapters. Your agent can list existing ones or help you organize them to make your content easier to navigate. **Can I use the api.video MCP to update my video player?** Absolutely. You can change player themes, manage watermarks, and update logos through your AI client without ever opening the api.video dashboard. **What happens if I need to restore a deleted video?** If you have Video Restore enabled, your agent can use the restore tool to bring back a discarded video from your library. **Can the api.video MCP automate my video workflow?** Yes, by using the webhook tools, you can set up triggers that react to video events, allowing your AI to help manage your entire pipeline. **Can I check if a video has finished encoding and is ready to play?** Yes! Use the `get_video_status` tool with the Video ID. It will return the ingestion and encoding status, letting you know exactly when the video is playable. **How do I upload a video file that is already hosted online?** You can use the `upload_video_source` tool. Just provide the Video ID and the public URL of the source file, and api.video will ingest it automatically. **Is it possible to see how many people watched my videos yesterday?** Absolutely. Use the `get_metrics` or `get_metrics_timeseries` tools to retrieve viewership data and performance analytics for your account or specific videos. **How do I find my api.video API Key?** Log in to your account, navigate to the **API Keys** section in your dashboard, and copy your unique Production API Key. **Can I get a direct player link via AI?** Yes! The `get_video_details` tool retrieves high-fidelity asset URLs including the player, mp4 source, and thumbnails for any specific video. **How do I check video analytics?** Use the `get_video_analytics` tool and specify the metric (e.g., 'play') and aggregation (e.g., 'total') to retrieve real-time performance data.