# Mux MCP

> Mux MCP connects your video infrastructure directly to your AI agent. Instantly manage everything from creating new assets and handling secure uploads to monitoring live streams and pulling view analytics. Control complex video workflows using natural conversation, without touching a dashboard.

## Overview
- **Category:** ship-it
- **Price:** Free
- **Tags:** video-infrastructure, live-streaming, asset-management, video-encoding, playback-api, media-processing

## Description

You'll take full control of all your video content and streaming operations right through your chat client. Forget jumping between dashboards just to check an asset status or generate metadata. This MCP lets you talk to your video infrastructure like it’s a simple database query.

Need to launch a new stream? Just ask for it. Need to see how many views a piece of content got last week? Your agent pulls that data instantly. You can even trigger the creation of an asset just by giving it a public URL, and your agent handles the whole process. When you connect this MCP through Vinkius, you get access to a comprehensive catalog of tools, making sure video management is always available wherever you work.

It covers everything: listing all existing files, checking which are finished processing, setting up direct upload sessions for large files, and monitoring live stream health in real-time. It makes your entire media pipeline conversational.

## Tools

### create_asset
Create a new video asset

### create_direct_upload
Create a direct upload session

### create_live_stream
Create a new live stream

### delete_asset
Delete a video asset

### delete_live_stream
Delete a live stream

### get_asset
Get specific asset details

### get_live_stream
Get specific live stream details

### get_recent_views
Get recent video views analytics

### list_assets
List Mux video assets

### list_direct_uploads
List direct video uploads

### list_live_streams
List Mux live streams

## Prompt Examples

**Prompt:** 
```
List all my video assets and show their status.
```

**Response:** 
```
I've retrieved your video assets. You have 12 assets, including 'asset-123' (Status: ready) and 'asset-456' (Status: processing). Shall I check if 'asset-456' is finished now?
```

**Prompt:** 
```
Create a new video asset from https://example.com/video.mp4.
```

**Response:** 
```
I've initiated the creation of a new video asset from the URL provided. The new Asset ID is 'new-asset-789' and its current status is 'preparing'. I'll let you know when it's ready for playback.
```

**Prompt:** 
```
Check recent views for my videos.
```

**Response:** 
```
Fetching recent analytics... You had 156 views in the last 15 minutes, with a 98% player success rate. Shall I breakdown the views by country?
```

## Capabilities

### Manage Asset Lifecycle
Create, list, retrieve details for, or delete any video asset using simple commands.

### Handle Live Streaming
Set up new live streams and check the current configuration or status of existing broadcasts.

### Secure Video Uploading
Generate secure, temporary endpoints for users to upload large video files directly to your system.

### Monitor Performance and Data
Fetch recent view metrics or pull complete metadata records for both assets and live streams.

## Use Cases

### Checking asset readiness after an update
A video developer finishes uploading raw footage and asks their agent to list assets. The agent then calls get_asset for the new file, confirming it's still 'processing.' They ask the agent to check its status again in 10 minutes, saving them from having to manually refresh a dashboard.

### Generating campaign content quickly
A marketing team member needs three video assets for an ad rollout. They tell their agent which source URLs are available. The agent uses create_asset multiple times, then lists_assets to give the manager a confirmation list of all new IDs.

### Diagnosing stream failure
A broadcast engineer notices a live feed dropping connections. They ask their agent to get_live_stream details for the main channel ID, immediately pinpointing if the issue is with the configuration or credentials, and not just general network failure.

### Analyzing content reach post-launch
A content manager posts a video and later asks their agent to get_recent_views. The agent pulls the analytics data right away, allowing them to decide if they need to promote it or rethink its topic based on real numbers.

## Benefits

- Eliminate dashboard hopping. Instead of manually checking the Mux UI to see if a file is ready, just ask your agent to list assets and check their status; it's immediate.
- Speed up deployment by automating asset creation. You can initiate new video assets simply by giving your agent a source URL and asking it to create the resource.
- Handle huge files securely. Use the direct upload tool to generate temporary, secure links, letting users bypass traditional file sharing methods when uploading large videos.
- Keep track of performance without logging in. Get recent views metrics instantly, allowing you to know exactly how well your content is performing right inside your chat window.
- Simplify live broadcasting setup. Your agent can list available streams or create a brand new one just by talking to it, handling all the underlying configurations.

## How It Works

The bottom line is you control complex media operations by talking to the system instead of clicking through multiple web tabs.

1. Subscribe to this MCP and provide your unique Mux Token ID and Secret.
2. Authorize your AI client, giving it permission to interact with video resources.
3. Ask your agent to perform a task, such as 'List all my assets that are ready for playback.'

## Frequently Asked Questions

**How do I use the Mux MCP to check an asset's status?**
Use the list_assets tool and then specify the ID of the video you want checked. Your agent will retrieve the current details, letting you know if it’s still processing or ready for playback.

**Can the Mux MCP handle live stream setup?**
Yes, you can use create_live_stream to set up a new broadcast and list_live_streams to see all your existing configurations. It keeps your streaming monitoring centralized.

**What is the best way to upload large videos using Mux MCP?**
Always use the create_direct_upload tool first. This generates a temporary, secure URL that allows massive files to be uploaded directly without burdening your internal infrastructure.

**Does the Mux MCP give me performance data?**
Absolutely. The get_recent_views tool fetches analytics showing view counts and other metrics, so you can track content reach instantly through natural language prompts.