# api.video MCP for AI Agents AI Agent Connect

> api.video MCP lets you manage your entire video hosting infrastructure through your AI client. You can create video objects, pull down high-fidelity analytics, manage multilingual captions, and update metadata without touching a dashboard. It handles the heavy lifting of video orchestration so you can focus on content.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_LmTjrRAGt9FcwedXKl17ybK2QuW9PmDZ2h28PuEz/ai-agent-connect
- **Tags:** video-hosting, video-streaming, encoding, media-infrastructure, video-analytics, api-first

## Description

Connect your api.video account to any AI agent and take full control of your professional video hosting infrastructure and automated media workflows through natural conversation. Imagine you're managing a massive library of video assets for a large brand or a growing content channel. Usually, that means jumping between tabs to check play counts, hunting for specific player URLs, or manually updating descriptions for dozens of files. This Connector changes that by letting your AI agent act as your media architect. Instead of digging through a dashboard, you just tell your agent to find the most popular videos this month or update the captions for your latest series. It handles the technical heavy lifting of interacting with the api.video backend, giving you a direct line to your video metadata, player themes, and performance metrics. Because Vinkius makes it so easy to connect these tools, you can move from "where is that link?" to "give me the links for all videos with the tutorial tag" in seconds. It's about getting your media infrastructure to work for you, rather than you working for it. You can automate the repetitive tasks of content management, like auditing your subtitle tracks or pulling down high-fidelity status reports for your stakeholders. This means you spend less time on data entry and more time on creative strategy.

## Tools

### create_video_object
Initialize a new video entry in your library. This lets you prep content for upload with a title and description instantly.

### delete_video
Permanently remove a video from your account. Use this to clean up your library or remove outdated content.

### list_video_captions
See all the subtitle tracks available for a specific video. This helps you verify that your global captions are active.

### list_video_chapters
Pull a list of all chapters for a video. You can use these to build navigation markers in your player.

### list_videos
Browse your entire library of videos. You can filter the results by title or specific tags to find content faster.

### update_video_details
Change the metadata or description of a video. This is the fastest way to update your content info at scale.

### get_video_analytics
Fetch performance data like total plays and impressions. Use this to see which videos are actually getting views.

### get_video_details
Get the full metadata and status for a specific video. This is how you quickly grab player URLs and thumbnails.

### list_player_themes
See all your custom player themes and configurations. Use this to manage the look and feel of your video player.

## Prompt Examples

**Prompt:** 
```
Show me the play counts for all my videos from last month.
```

**Response:** 
```
I've pulled the analytics for your library from last month. Here is the breakdown:

| Video Title | Plays | Impressions |
| :--- | :--- | :--- |
| **Product Feature v2** | 5,200 | 12,450 |
| **Onboarding Tutorial** | 1,200 | 3,100 |
| **Summer Series Intro** | 850 | 2,000 |

Your top performing asset is 'Product Feature v2'. Would you like a more detailed breakdown for any of these?
```

**Prompt:** 
```
I need the player URLs and thumbnails for the 'Intro' videos.
```

**Response:** 
```
I've gathered the high-fidelity assets for your 'Intro' series:

*   **Intro - Part 1**
    *   Player URL: `https://player.api.video/vi123` 
    *   Thumbnail: `https://img.api.video/thumb_vi123.jpg`
*   **Intro - Part 2**
    *   Player URL: `https://player.api.video/vi124` 
    *   Thumbnail: `https://img.api.video/thumb_vi124.jpg`

Do you need the metadata for these as well?
```

**Prompt:** 
```
Are there any captions for the French version of my latest upload?
```

**Response:** 
```
I've checked the caption tracks for your latest upload. Here is what's currently available:

*   **English** (Active)
*   **French** (Active)
*   **Spanish** (Pending)

It looks like the French tracks are ready to go. Would you like me to check any other language tracks?
```

## Capabilities

### Create new video entries
Initialize a new video object with a title and description to prepare for upload.

### Pull down playback metrics
Fetch performance data like total plays and impressions for your content.

### Manage multilingual captions
List and audit subtitle tracks across different languages for your videos.

### Retrieve direct player URLs
Get high-fidelity links for players and thumbnails directly through your agent.

### Update video metadata
Modify titles, descriptions, and other tags for existing videos in your library.

### Filter your video library
Search through your entire collection using specific tags or titles.

### Access player themes
View and manage your custom player themes and store-level configurations.

## Use Cases

### Bulk updating content metadata
A creator needs to update the descriptions for 20 different videos to reflect a new branding change and uses update_video_details to do it in one go.

### Auditing global captions
A content lead checks if the French and Spanish captions are active on a new series by using list_video_captions via their agent.

### Quickly grabbing player links
A developer needs to find the player URL and thumbnail for a specific tutorial and uses get_video_details to get them instantly.

### Monitoring performance metrics
A product manager asks the agent to show the play counts for all videos from last month using get_video_analytics to prepare a report.

## Benefits

- Stop manual data entry by using create_video_object to prep uploads instantly without touching a dashboard.
- Get precise performance data with get_video_analytics to see what's actually working for your audience.
- Handle global reach easily by managing multilingual tracks with list_video_captions for every release.
- Save time on content audits by using list_videos to filter your library by tags or titles in seconds.
- Update your entire catalog quickly by modifying metadata with update_video_details for any branding changes.
- Access player assets instantly using get_video_details to grab URLs and thumbnails for your app or website.

## How It Works

The bottom line is you get a voice-controlled dashboard for your entire video hosting infrastructure.

1. Subscribe to the api.video MCP on Vinkius.
2. Grab your Production API Key from your api.video dashboard.
3. Connect the key to your AI client and start asking questions about your video library.

## Frequently Asked Questions

**How does the api.video MCP help with my video library?**
It lets you manage your entire video collection through natural conversation. You can search, filter, and update your video metadata without having to navigate through a complex dashboard.

**Can I use this to see how many people watched my videos?**
Yes, the Connector can pull performance data like total plays and impressions. You can ask your agent for specific metrics on any video or your entire library.

**How do I update my video descriptions using this Connector?**
You can simply tell your agent to update the description for a specific video. It will handle the communication with the hosting platform to save your changes.

**Can the api.video MCP help with my multilingual subtitles?**
It allows you to list and audit all available caption tracks. This makes it much easier to verify that your global content has the correct subtitles active.

**Is this good for managing my custom player themes?**
Yes, it can list all your custom player themes and configurations. This helps you keep your video player's look and feel consistent across your different assets.

**How do I get links for my videos quickly?**
Your agent can retrieve direct player URLs and thumbnail links for any video in your library instantly, which is perfect for quickly updating your website or app.

**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.