# Aliyun VOD MCP for AI Agents MCP

> Aliyun VOD MCP connects your AI agent directly to Alibaba Cloud's professional video processing pipeline. It lets you manage massive digital asset libraries, generate secure playback links on demand, and audit complex media metadata all through natural conversation.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** video-processing, media-orchestration, transcoding, asset-management, playback-authorization, video-metadata

## Description

Managing a large-scale video library used to mean logging into multiple proprietary consoles just to find basic information or check link validity. This MCP changes that. You can talk to your agent about your entire digital asset management process—from finding specific content to checking its technical details and even deleting old assets. Your AI client acts like an expert media operations specialist, giving you accurate results instantly without forcing you to navigate complex UIs. When you connect this VOD MCP via the Vinkius catalog, your agent becomes a single point of truth for all things video metadata and playback authorization.

## Tools

### create_upload_auth
Generates the necessary credentials to start uploading a new VOD video file.

### delete_media
Permanently removes a specified VOD video asset from the platform.

### get_media_metadata
Retrieves detailed technical information about an existing video file, such as its duration and status.

### get_playback_info
Creates secure, temporary play URLs for a given video ID across multiple definitions (SD, HD, Full HD).

### list_categories
Shows all established media categories within your VOD project.

### list_media
Lists a general directory of the video assets stored on the platform.

### refresh_upload_auth
Renews your upload token and address, useful when initial credentials expire or need updating.

### search_vod_media
Searches the video library using keywords and filters to locate specific content.

## Prompt Examples

**Prompt:** 
```
List the 15 most recently added videos that are categorized under 'Product Demos' and what their current status is.
```

**Response:** 
```
**Media Audit Report: Product Demos**

| Video Name | Video ID | Category | Status |
| :--- | :--- | :--- | :--- |
| Q2_Launch_Trailer | 88210934 | Product Demo | Normal |
| Feature_Update_v3 | 77345612 | Product Demo | Processing |
| Best Practices Guide | 66231109 | Education | Normal |

*Note: 'Processing' means the transcode template is currently running.*
```

**Prompt:** 
```
I need secure play links for three videos. Two are from last month, and one needs to be deleted.
```

**Response:** 
```
Got it. I've processed your request:

**✅ Play URLs Generated:**
*   Video ID `88210934`: [SD Link] | [HD Link]
*   Video ID `77345612`: [SD Link] | [Full HD Link]

**🗑️ Action Taken:**
The video with ID `66231109` has been permanently deleted from the library.
```

**Prompt:** 
```
How do I get started uploading a new asset, and what are the current categories available?
```

**Response:** 
```
Here's how you get set up:

**Step 1: Get Credentials.** First, we need to call `create_upload_auth` to generate your secure token and upload address.

**Available Categories:**
*   Education (ID: 1024)
*   Product Demo (ID: 2001)
*   Internal Training (ID: 3500)
```

## Capabilities

### Search Video Assets
Find specific videos across your entire library using text matching or filtering by defined media categories.

### Retrieve Detailed Video Information
Get comprehensive technical metadata for any video, including its duration and current processing status.

### Generate Secure Playback Links
Automatically create authorized URLs that allow users to stream content at different definitions (SD, HD, Full HD).

### Manage Upload Credentials
Get fresh tokens and addresses needed to initialize direct video uploads into the system.

### Audit Media Library Health
List all stored videos or review available transcode template groups to ensure consistent processing standards across your content.

## Use Cases

### Conducting a Digital Content Audit
A PM needs to know which videos are compliant. They ask their agent to search the library for all assets tagged 'training' and then use `get_media_metadata` on each result to confirm they haven't exceeded their maximum file size.

### Coordinating a Live Video Distribution
A marketing team needs temporary viewing links. They prompt the agent with a list of video IDs, and the MCP uses `get_playback_info` to generate all necessary secure URLs for immediate use.

### Onboarding New Content Creators
The ops engineer asks their agent to refresh upload tokens using `refresh_upload_auth`. The agent provides the correct, current credentials so the creator can start uploading immediately without delay.

### Archiving Old Project Footage
A project manager wants to clean up storage. They prompt the agent to list all media older than two years using `list_media`, and then call `delete_media` on confirmed obsolete assets.

## Benefits

- Stop clicking through multiple dashboards. Your agent handles everything, allowing you to list all stored videos or perform a deep content search just by asking a question.
- Generate playback authorization instantly. Instead of manual link creation, the agent provides secure play URLs for any defined video ID across different definitions.
- Streamline uploads and asset cleanup using dedicated tools. Use `create_upload_auth` to get fresh credentials or call `delete_media` to permanently remove outdated content.
- Gain complete visibility into your assets. You can use `get_media_metadata` for a full technical audit, confirming video duration and current processing status in seconds.
- Maintain consistency across the board. Check available transcode template groups by listing them or using `list_categories` to keep your content standards high.

## How It Works

The bottom line is: you talk naturally about your media assets, and the MCP handles all the complex backend API calls to give you a simple answer.

1. Subscribe to this MCP and provide your Aliyun AccessKey ID and Secret.
2. Connect the credentials to your preferred AI client (like Cursor or Claude).
3. Ask your agent questions like, 'What are the play URLs for video X?' The agent executes the request and returns the necessary data.

## Frequently Asked Questions

**How can I manage video assets using the Aliyun VOD MCP for AI Agents?**
You can ask your agent to perform almost any routine task, from listing every asset in your library to getting full technical metadata on a single file. It turns complex console navigation into simple conversation.

**Do I need to worry about generating play links manually with the Aliyun VOD MCP for AI Agents?**
No, you don't. The agent handles it automatically using `get_playback_info`. Just tell it which video ID needs links, and it provides secure URLs across all required definitions.

**Can the Aliyun VOD MCP for AI Agents help me audit my entire media library?**
Yes. You can ask your agent to list assets and then check their metadata in bulk, helping you confirm things like file status or duration without manually checking every single video.

**What if I need to delete old videos using the Aliyun VOD MCP for AI Agents?**
You can instruct your agent to identify and permanently remove obsolete assets. It uses a dedicated tool, making sure deletion happens correctly and safely.

**Is the Aliyun VOD MCP for AI Agents better than using direct API calls?**
It's much easier. Instead of writing complex code or dealing with multiple endpoints, you just talk to your agent. It handles all the underlying complexity for you.