# api.video MCP MCP

> api.video connects your AI client to a professional video hosting workflow. It lets you manage every aspect of media—from uploading raw assets to pulling detailed play counts and coordinating multilingual captions. Use it to automate content pipelines, monitor performance metrics, and orchestrate complex video delivery without touching a dashboard.

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

## Description

You can use this MCP to take full control of professional video hosting infrastructure through natural conversation. Need to know how many times 'Project Alpha Demo' played last month? Your agent pulls the exact analytics. Want to update the description or add new chapters to five different videos at once? It handles that metadata work. You can manage everything from player themes and subtitle tracks across multiple languages, all without manual logins. If your workflow requires combining video management with other services—say, triggering a message when a video hits 10k views—you'll appreciate how easily you can chain this MCP with another service using Vinkius. This ensures that data flows correctly between systems and the whole process runs reliably. The result is an automated media architect running inside your AI client.

## Tools

### create_video_object
Initializes a new video record with basic details like title and description.

### delete_video
Permanently removes a specified video asset from the hosting platform.

### get_video_analytics
Pulls performance metrics, such as total play counts and impressions, for tracking content success.

### get_video_details
Retrieves specific metadata about a video object, including its current status and basic information.

### list_player_themes
Lists the custom themes available for your video player embed codes.

### list_video_captions
Retrieves a list of all subtitle tracks and languages associated with a video.

### list_video_chapters
Lists the defined chapter markers or segments within a long-form video file.

### list_videos
Finds and lists all videos in your account, supporting filtering by tags or title.

### update_video_details
Modifies existing video metadata, such as changing the title or description.

## Prompt Examples

**Prompt:** 
```
List the last 5 videos in my api.video account.
```

**Response:** 
```
I've retrieved your video library. You have 5 recent uploads, including 'Project Alpha Demo' (ID: vi123) and 'Onboarding Tutorial'. Would you like the detailed high-fidelity status for any of these?
```

**Prompt:** 
```
Show the play count analytics for all videos this month.
```

**Response:** 
```
Accessing media intelligence... This month, your videos have reached a total of 12,450 plays. Your top performing asset is 'Product Feature v2' with 5,200 impressions. Shall I retrieve the high-fidelity hourly breakdown?
```

**Prompt:** 
```
Get the player link and captions for video ID 'vi123'.
```

**Response:** 
```
Asset orchestrated! For video vi123, the high-fidelity player URL is [url]. I've also identified 2 available caption tracks: English and French. Need help updating the video high-fidelity metadata?
```

## Capabilities

### Manage video library contents
List, create, or delete entire videos by title or tag.

### Retrieve detailed asset metadata
Pull specific data like chapter markers, player links, and high-fidelity status for any given video ID.

### Monitor performance metrics
Get total play counts, impressions, and other key statistics across your entire content library.

### Update video details
Modify core information about a video, such as the title or description.

### Handle multilingual captions
List and manage subtitle tracks for a video across various languages.

## Use Cases

### The Quarterly Performance Review
A content director needs to know which of the 50 videos shot last quarter are underperforming. Instead of downloading a massive CSV and sifting through it, they ask their agent to run `get_video_analytics` on all assets tagged 'Q2'. The AI client delivers a summary report showing play counts versus goals.

### The Global Launch Prep
A product manager is launching in five new countries. They use the agent to run `list_video_captions` and confirm that all 20 core training videos have approved subtitle tracks ready for those specific languages.

### The Metadata Clean-Up Day
A developer needs to update the title and description of a batch of archived videos. They run `list_videos` to get the IDs, then use the agent to call `update_video_details` for all 30 assets simultaneously, logging every change.

### The Asset Management Check
Before building a new embed page, an engineer needs to know what player styling options are available. They ask the agent to run `list_player_themes`, getting a list of approved themes and their required parameters immediately.

## Benefits

- Instantly pull performance data—like total plays or impressions—using the `get_video_analytics` tool, so you never have to check a separate analytics dashboard again. This is critical for refining your content strategy.
- Manage complex media structures by listing and updating details using `list_video_chapters` and `update_video_details`. You can automate adding markers to hundreds of videos at once.
- Keep global rollouts coordinated by accessing all available subtitle tracks with `list_video_captions`, ensuring your multilingual content is always ready for deployment.
- Quickly locate any asset using `list_videos` and then get its specific details with `get_video_details`. This makes finding the right video ID a simple conversation instead of a database query.
- Maintain brand consistency by listing player themes (`list_player_themes`) before embedding. You can ensure every stream uses your correct custom look, all via natural language.

## How It Works

The bottom line is that your AI client talks directly to your video hosting backend without you ever seeing an API endpoint.

1. First, connect your API key to this MCP client through the Vinkius platform.
2. Next, tell your agent exactly what you need—for example, 'List all videos tagged 'tutorial'' or 'Give me analytics for vi123'.
3. Your agent executes the call and sends back a clean, structured report with the requested data.

## Frequently Asked Questions

**How do I find out what themes are available with list_player_themes?**
You run `list_player_themes` and your agent returns a directory of custom player themes you can use. This saves you from guessing which embed style works best.

**Can I update video details using update_video_details for multiple videos?**
Yes, you feed the tool a list of IDs and the required changes (like new tags or descriptions), letting the agent batch-process the updates for efficiency.

**What is the difference between list_videos and get_video_details?**
`list_videos` gives you a high-level overview, allowing filtering by title or tags. `get_video_details`, however, drills down into one specific video's full metadata.

**If I want to add chapters, what tool do I use? list_video_chapters?**
You need the `list_video_chapters` tool. It reads out the existing chapter markers and segments for a video so you know exactly where you can start adding new ones.

**When I use the `delete_video` tool, is the deletion permanent, or does it go into a trash bin first?**
The deletion is immediate and irreversible. Once you call `delete_video`, the video asset is purged from your account permanently. Be careful with this function.

**Can I get detailed performance metrics like regional or device breakdowns using `get_video_analytics`?**
Yes, `get_video_analytics` supports advanced filtering for granular data. You can pull play counts broken down by geographic region and specific client hardware types.

**If I use `list_video_captions`, how do I manage or upload subtitle tracks for multiple languages?**
The tool lists available caption tracks, but you must reference the language code to initiate an update. After listing them, another action is required to actually upload or modify the track content.

**What do I need to know about asset creation when running `create_video_object`?**
You must provide a valid title and description upon creating an object. The tool initializes the metadata record, but actual file uploads are handled by separate processes.