# api.video MCP for AI Agents MCP

> api.video lets you manage your entire video content pipeline through natural conversation. It handles everything from uploading and encoding high-fidelity assets to retrieving detailed performance analytics, all without logging into a dashboard. Get full control over streaming media workflows with an AI agent.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** video-hosting, video-streaming, encoding, media-infrastructure, video-analytics, api-first

## Description

Need to run complex video operations? This MCP connects your workflow directly to a professional media infrastructure, giving your agent the power of a dedicated media engineer. You can list and manage your entire library of encoded videos, check deep analytics like total plays, or fetch direct asset URLs for players and chapters—all using plain language commands.

It takes the manual labor out of video management. Instead of navigating complex dashboards to update metadata or compile performance reports, you just tell your agent what needs doing. The system handles everything from checking multilingual subtitle tracks to retrieving custom player theme information. When you connect this MCP via Vinkius, your AI client becomes a centralized command center for all things streaming media. You're ready to orchestrate high-fidelity video content and performance instantly.

## Tools

### create_video_object
Initializes a new video entry and sets its core title and description in the platform.

### delete_video
Permanently removes a specified video asset from your library.

### get_video_analytics
Retrieves specific performance metrics, such as total plays and impressions, for any given video.

### get_video_details
Pulls comprehensive metadata for a single video asset, including its current status and settings.

### list_video_captions
Lists all available subtitle tracks and languages associated with a specific video.

### list_video_chapters
Retrieves the structured chapter markers for a video, useful for navigation or timed content.

### list_player_themes
Shows you all the custom player themes currently configured in your account.

### list_videos
Searches and lists your entire video library, supporting filters by title or tags.

### update_video_details
Modifies the descriptive metadata (like titles or descriptions) of an existing video asset.

## Prompt Examples

**Prompt:** 
```
What's the status of our new training videos? I need player links for three different IDs.
```

**Response:** 
```
**Video Status Report**

| ID | Title | Status |
| :--- | :--- | :---: |
| vi901 | Training v3.0 | Ready to Stream |
| vi902 | Onboarding Flow | Needs Review |
| vi903 | Sales Demo Q3 | Active |

Here are the player URLs for immediate use:
```

## Capabilities

### Manage Video Libraries
List or create new video objects, allowing you to manage your entire asset catalog programmatically.

### Retrieve Performance Metrics
Access real-time analytics to track total plays and impressions across all your content.

### Get Asset Details and Links
Pull specific metadata, direct URLs for players, thumbnails, or chapters needed for embeds and documentation.

### Update Video Metadata
Modify titles, descriptions, or other key details of existing videos without touching the core files.

### Handle Global Subtitles and Chapters
Access and manage subtitle tracks in multiple languages, plus list specific chapter markers for segmented content.

## Use Cases

### Analyzing Campaign Performance
A Product Manager asks their agent, 'What were the total plays and impressions for all videos last month?' The agent runs get_video_analytics, providing an immediate report to inform the next marketing push.

### Setting up a New Asset Embed
A Developer needs to embed a video. They prompt their agent to retrieve the player link and metadata for 'Project Phoenix,' which uses get_video_details, allowing them to copy the correct URL immediately.

### Localizing Content Quickly
A global marketing team needs to update subtitles. They prompt their agent to list_video_captions for a specific video ID, finding both Spanish and French tracks ready for deployment.

### Auditing the Video Library
A Content Creator runs a query asking to see all videos tagged 'legacy' using list_videos. This quickly surfaces old assets that need review or deletion via delete_video, preventing clutter.

## Benefits

- Stop manually toggling between dashboards. Your agent handles the full lifecycle, from creating new video objects to updating their metadata.
- Deep analytics are always available. Get performance metrics for any video using get_video_analytics without running separate reporting queries.
- Never lose track of your content details again. You can retrieve player links and comprehensive metadata by calling get_video_details with a simple prompt.
- Manage global reach easily. List_video_captions handles subtitle tracks across multiple languages, ensuring consistent viewer experiences.
- Structured video management: Use list_video_chapters to programmatically define navigation markers, which is critical for long-form tutorials.

## How It Works

The bottom line is that your AI client acts as a single point of control, executing complex media operations through simple conversation.

1. Subscribe to this MCP on Vinkius and retrieve your Production API Key from your api.video dashboard.
2. Connect the key to your preferred AI client (Claude, Cursor, etc.) through the natural language interface.
3. Tell your agent exactly what you need done—for example, 'Show me last month's play count for Project Beta.' The MCP executes the request and delivers the structured data.

## Frequently Asked Questions

**How do I get performance metrics for my videos using api.video MCP?**
You simply ask your agent to check analytics. It pulls real-time data on total plays and impressions, so you always know which content is performing well without leaving your chat interface.

**Can I use the api.video MCP to update video descriptions or titles?**
Yes, it handles metadata changes easily. You tell your agent what new title and description you want, and it updates those details on the asset for you.

**Does this MCP help me manage multilingual subtitles?**
Absolutely. You can list all available subtitle tracks and languages for any video in one command, making global content rollout straightforward.

**What if I need to find the embed link for a specific video ID?**
You just ask your agent to get the details. It retrieves the direct player URL and other necessary metadata instantly, eliminating manual dashboard searching.

**Is api.video MCP only good for big companies?**
Not at all. This tool helps any creator or small team manage their media assets professionally. You get enterprise-level control over encoding and streaming without the complexity.