# Aliyun VOD MCP for AI Agents AI Agent Connect

> Aliyun VOD MCP lets your AI agent manage your Alibaba Cloud video infrastructure. It handles things like retrieving play URLs, searching your media library, and managing upload credentials so you don't have to jump back and forth between your AI client and the Aliyun Console.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_N38QmQazbUcQ3WUPvCU1iewUJm5La6tOjSP2AOYO/ai-agent-connect
- **Tags:** video-processing, media-orchestration, transcoding, asset-management, playback-authorization, video-metadata

## Description

You're usually stuck jumping between tabs to find a specific video ID, check its playback status, or grab a secure URL for a new release. This Connector changes that by letting your AI agent do the heavy lifting. Instead of navigating complex menus, you just tell your agent what you need. It can pull technical metadata, search through massive libraries, and even handle the boring stuff like refreshing upload tokens or listing transcode templates. It turns your media management into a conversation. You'll find this among the 4,000+ options in the Vinkius catalog, making it easy to plug into your existing workflow without the manual overhead.

## Tools

### create_upload_auth
Generates the necessary credentials for starting a new upload. It provides the tokens needed for your media pipeline.

### get_media_metadata
Retrieves technical details like status and duration. It gives you a snapshot of your video's technical state.

### list_categories
Shows all available media categories in your project. It helps you organize your library structure.

### list_media
Pulls a list of your stored VOD media. Use this to check what's currently in your library.

### refresh_upload_auth
Updates your upload token when it expires. This keeps your upload sessions active without manual intervention.

### search_vod_media
Finds specific videos in your library using keywords. It makes finding assets much faster than manual browsing.

### get_playback_info
Fetches secure play URLs for specific video IDs. Use this to get authorized links for different resolutions.

### delete_media
Removes a video from your library permanently. Use this to clean up old assets or failed uploads.

## Prompt Examples

**Prompt:** 
```
List the most recent 10 videos in my Aliyun VOD library.
```

**Response:** 
```
I've retrieved your recent media list. I found 10 videos, including 'Main_Event_Recap' (VideoId: `88210934`) and 'Product_Demo_v2'. 

| Video Title | Video ID | Status |
| :--- | :--- | :--- |
| Main_Event_Recap | 88210934 | Normal |
| Product_Demo_v2 | 88210935 | Normal |
| 
| ... | ... | ... |

Would you like me to get the authorized play URLs for any of these?
```

**Prompt:** 
```
Get the technical metadata and playback info for video '88210934'.
```

**Response:** 
```
I've retrieved the details for video `88210934`.

**Technical Metadata:**
- **Duration:** 120s
- **Status:** Normal
- **Transcode Template:** Standard_HD_Group

**Authorized Playback URLs:**
- **SD:** `https://vod.example.com/play/sd/88210934...`
- **HD:** `https://vod.example.com/play/hd/88210934...`
- **Full HD:** `https://vod.example.com/play/fhd/88210934...`
```

**Prompt:** 
```
Search for videos matching 'Tutorial' and show their categories.
```

**Response:** 
```
I've performed a search for 'Tutorial'. I found 5 matching videos. 

**Search Results:**
- Tutorial_01 (ID: `1021`) - Category: Education (ID: `1024`)
- Tutorial_02 (ID: `1022`) - Category: Education (ID: `1024`)
- Tutorial_03 (ID: `1023`) - Category: Education (ID: `1024`)
- Tutorial_04 (ID: `1024`) - Category: Education (ID: `1024`)
- Tutorial_05 (ID: `1025`) - Category: Education (ID: `1024`)

Would you like me to list all available categories in your VOD project to help organize your library better?
```

## Capabilities

### Get secure play URLs
Fetch authorized playback links for different video resolutions instantly.

### Search your media library
Find specific videos in your library using keywords and filters.

### Retrieve technical metadata
Get video details like duration, status, and technical specs.

### Automate upload credentials
Generate and refresh tokens to manage video uploads without manual steps.

### List media categories
View all organized categories within your VOD project.

### Delete obsolete media
Permanently remove videos from your library to keep it clean.

### Audit transcode templates
Check your available transcode groups to ensure consistent video processing.

## Use Cases

### Finding specific tutorial assets
A content manager needs to find all 'Tutorial' videos. They ask the agent to use search_vod_media to find them and list_media to check their current status.

### Generating secure app links
A developer needs a secure link for a mobile app. They ask the agent to use get_playback_info for a specific VideoId to get the SD and HD URLs.

### Cleaning up a media library
An ops person needs to clean up a library. They use list_media to identify old assets and delete_media to remove them from the platform.

### Automating new video uploads
A team is starting a new upload. They use create_upload_auth to get the credentials and refresh_upload_auth to keep the connection active.

## Benefits

- Stop manually copying IDs by using search_vod_media to find exactly what you need in seconds.
- Get secure links instantly with get_playback_info instead of hunting through the Aliyun Console.
- Keep your library clean by using delete_media to purge old assets without extra clicks.
- Simplify your upload flow by having the agent call create_upload_auth for your team.
- Audit your processing standards quickly by listing transcode templates with list_categories.
- Stay organized by having your agent use list_media to give you a status report on your library.

## How It Works

The bottom line is you get a natural language interface for your entire Alibaba Cloud video pipeline.

1. Subscribe to the Aliyun VOD MCP on Vinkius.
2. Enter your Aliyun AccessKey ID and AccessKey Secret in the configuration.
3. Ask your AI client to list videos, search your library, or generate play URLs.

## Frequently Asked Questions

**What is the Aliyun VOD MCP?**
The Aliyun VOD MCP is a bridge that connects your AI agent to Alibaba Cloud's professional video platform. It lets you manage your video infrastructure, find content, and handle playback links using natural language.

**Can I use the Aliyun VOD MCP to find my videos?**
Yes, you can ask your agent to search your library using keywords or list all your media to see what's currently hosted on the platform.

**How do I get secure play URLs with Aliyun VOD MCP?**
You can simply ask your AI agent to fetch the play URLs for a specific video ID. It will retrieve the authorized links for various resolutions like SD and HD.

**Can the Aliyun VOD MCP help with video uploads?**
Yes, it can generate the necessary upload credentials and refresh tokens to keep your upload sessions active without you having to manually manage the keys.

**Is Aliyun VOD MCP for video editing?**
No, this Connector is for managing video infrastructure and distribution. It handles metadata, playback, and library management, not the actual video editing or transcoding process.

**Can I use Aliyun VOD MCP to organize my content?**
Absolutely. You can ask your agent to list your media categories or search for specific content to help you organize your library more effectively.

**How do I find my Aliyun AccessKey ID and Secret?**
Log in to the [Alibaba Cloud Console](https://usercenter.console.aliyun.com/), navigate to [AccessKey Management] to find or create your unique ID and Secret.

**What is a VideoId?**
A VideoId is the unique identifier for a video file in the Aliyun VOD system. It is assigned when a video is created or uploaded and is required for all video-specific operations like metadata retrieval or playback info.

**Does this server handle authentication signatures?**
Yes! The server automatically calculates the required Aliyun RPC signature (HMAC-SHA1) for every request using your provided AccessKey Secret, ensuring secure authorized communication with the Aliyun VOD gateway.