# Mux MCP for AI Agents AI Agent Connect

> Mux MCP lets you manage your video assets and live streams directly from your AI agent. You can create new assets from URLs, track live stream statuses, and pull recent view metrics without leaving your workspace. It handles the heavy lifting of your video infrastructure so you can focus on content.

## Overview
- **Category:** ship-it
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_tlveLdTlI92XZT5oSRWP3QfB773aASoCb6pcYb4L/ai-agent-connect
- **Tags:** video-infrastructure, live-streaming, asset-management, video-encoding, playback-api, media-processing

## Description

This Connector changes how you handle video content by bringing your account directly into your conversation with your AI agent. Instead of hunting for IDs or refreshing pages, you can just ask your agent to list your current assets or create a new one from a link. It handles the technical details of video infrastructure, like setting up secure upload sessions or pulling specific metadata for a stream. Because Vinkius hosts this Connector in its catalog, you can connect it to any of your preferred clients and start managing your media pipeline through natural language. It's about getting your video work done where you already spend your time, whether that's in a code editor or a chat window. You get a direct way to monitor broadcast health and pull analytics without the friction of switching tabs or navigating complex dashboards.

## Tools

### create_asset
Creates a new video asset from a provided source URL. This allows you to start the video processing workflow instantly.

### get_recent_views
Retrieves the most recent view metrics for your videos. You can use this to see how your content is performing in real-time.

### create_direct_upload
Starts a new secure session for uploading video files. This is the proper way to handle large file ingestion for your platform.

### create_live_stream
Sets up a new live stream configuration. Use this to prepare your infrastructure for an upcoming broadcast.

### delete_asset
Deletes a specific video asset from your account. This helps you remove old files or content you no longer want to host.

### delete_live_stream
Removes a live stream from your account. This helps you keep your active stream list clean.

### get_asset
Pulls specific details for a single video asset. You can use this to check the status or playback ID of a specific file.

### get_live_stream
Fetches the current configuration and status of a live stream. This lets you verify that your broadcast is live and configured correctly.

### list_assets
Shows a list of all video assets in your Mux account. This is the fastest way to see your entire video library at once.

### list_direct_uploads
Displays a list of active direct video upload sessions. This helps you track files that are currently being ingested.

### list_live_streams
Lists all live streams currently in your account. Use this to get a full overview of your active and past broadcasts.

## Prompt Examples

**Prompt:** 
```
Show me all my videos and tell me which ones are still processing.
```

**Response:** 
```
I've pulled your current video assets. Here is the status of your library:

| Asset ID | Status | Duration |
| :--- | :--- | :--- |
| `vid-001` | **Ready** | 02:45 |
| `vid-002` | **Processing** | 01:12 |
| `vid-003` | **Ready** | 05:30 |

Would you like me to check the progress on `vid-002` again in a minute?
```

**Prompt:** 
```
Create a new video from this URL: https://example.com/clip.mp4
```

**Response:** 
```
I've started creating a new video asset from that URL. 

**Status:** Preparing
**Asset ID:** `new-asset-9921` 

I'll keep an eye on it and let you know as soon as it's ready for playback.
```

**Prompt:** 
```
How many views did my latest video get in the last hour?
```

**Response:** 
```
I've retrieved the recent analytics for your latest video:

*   **Total Views (Last Hour):** 1,240
*   **Player Success Rate:** 99.2%
*   **Average Watch Time:** 03:15

Would you like a breakdown of these views by country?
```

## Capabilities

### Create video assets from URLs
Turn a public link into a playable video asset instantly.

### Monitor live stream status
Check the configuration and health of your active broadcasts.

### Pull video view analytics
Get recent view metrics to see how your content is reaching people.

### Start secure upload sessions
Create direct upload sessions for reliable video file ingestion.

### Fetch asset metadata
Retrieve specific details for any video asset or live stream.

### Delete old content
Remove video assets or live streams you no longer need from your account.

## Use Cases

### Checking asset readiness
A developer needs to know if a video is ready for the frontend. They ask their agent to check the status of a specific file using get_asset.

### Automating asset creation
A content manager receives a new promo link. They ask their agent to create a new asset from that URL using create_asset.

### Live stream monitoring
A broadcast team needs to verify that the main stream is live. They ask their agent to show the current status using get_live_stream.

### Performance tracking
A marketing lead wants to see how a new campaign is doing. They ask their agent to pull the most recent views using get_recent_views.

## Benefits

- Skip the dashboard by using list_assets to see your entire video library instantly without clicking through menus.
- Speed up content creation by using create_asset to turn URLs into playable video assets in seconds.
- Monitor stream health in real-time with get_live_stream to catch issues before they hit your audience.
- Get immediate feedback on content reach with get_recent_views to see how your videos are performing.
- Secure your file transfers by using create_direct_upload for reliable and safe video ingestion.
- Clean up your library quickly by using delete_asset to remove old or unnecessary content from your account.

## How It Works

The bottom line is you get a direct text-based interface for your entire video infrastructure.

1. Subscribe to the Mux MCP via the Vinkius catalog.
2. Enter your Mux Token ID and Token Secret into your AI client configuration.
3. Ask your agent to list assets, create new videos, or check live stream stats.

## Frequently Asked Questions

**Can I use the Mux MCP to create video assets?**
Yes, you can use this Connector to turn public URLs into playable video assets instantly. Your agent will handle the request and start the processing workflow for you.

**Does the Mux MCP support live streaming?**
Yes, it allows you to manage your live stream configurations and monitor their status in real-time. You can check if your broadcast is live or see its current settings.

**Can I check my video analytics with the Mux MCP?**
Yes, you can pull recent view metrics for your videos. This helps you see how your content is performing and how many people are watching.

**How do I connect Mux to my AI agent?**
First, subscribe to the Connector on Vinkius. Then, add your Mux Token ID and Token Secret to your AI client's configuration to get started.

**Can I delete old videos using the Mux MCP?**
Yes, the Connector includes a tool to delete specific video assets. This is a great way to keep your library organized by removing content you no longer need.

**Does the Mux MCP help with direct uploads?**
Yes, it can create secure direct upload sessions. This is the best way to handle high-quality video file ingestion for your platform.

**How do I create a Mux API Token?**
Go to the Mux Dashboard, navigate to Settings > API Tokens, and click 'Create new token'. Ensure you copy the Token Secret immediately as it will only be shown once.

**What format should the asset URL be?**
The URL must be publicly accessible and point directly to a video file (e.g., MP4, MOV). Mux will then fetch and process the file from that location.

**Is the analytics data real-time?**
Yes, the `get_recent_views` tool retrieves near real-time data about video views occurring in your account.