# Vidyard MCP MCP

> Vidyard MCP connects your AI agent directly to your video hosting account. Use natural conversation to list, retrieve metadata for, and manage every aspect of your video library, from creating custom players to grabbing direct stream links.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** video-hosting, video-messaging, content-management, video-analytics, sales-enablement, media-assets

## Description

You can treat your entire corporate video asset library like a database you talk to. Instead of navigating deep dashboards just to find an ID or check encoding status, your AI agent handles it all through simple chat commands. You'll list every existing player, check technical details for any video—like length and encoding status—and grab direct download links for specific qualities (480p, 720p). Need to reorganize content? You can create new players or attach videos to existing ones instantly. The whole setup runs securely because credentials pass through a zero-trust proxy; your keys never sit on a disk. This lets you manage everything from asset renaming and permanent deletion right up to building custom player facades, all without ever touching the Vidyard UI.

## Tools

### attach_video_to_player
Adds a specific video asset into an existing player container.

### create_empty_player
Makes a new, empty video player container that can hold content later.

### delete_video_asset
Permanently deletes a video asset from your Vidyard library. This action cannot be undone.

### delete_video_player
Removes an entire video player container, though the original videos remain untouched.

### get_player_details
Retrieves all technical and organizational details associated with a specific video player.

### get_video_details
Fetches the core technical metadata for any given video asset, like its length or encoding status.

### get_video_source_files
Provides direct stream URLs and raw download links for various resolutions of a chosen video.

### list_video_players
Shows you a list of all the player containers currently set up in your account.

### list_videos
Generates a complete manifest listing every single video asset stored on Vidyard.

### update_player_name
Changes the visible name or title of an existing player container.

## Prompt Examples

**Prompt:** 
```
List all my videos in Vidyard.
```

**Response:** 
```
I found 8 videos in your library. The most recent ones are 'Q4 Product Update' (ID: vy-123), 'Sales Training 101' (ID: vy-456), and 'Customer Interview' (ID: vy-789). Would you like the full details for any of these?
```

**Prompt:** 
```
Get the direct download links for the 'Product Demo' video.
```

**Response:** 
```
Here are the direct stream and download links for 'Product Demo': 1080p (MP4: https://vidyard.com/stream/...), 720p (MP4: https://vidyard.com/stream/...), and 480p (MP4: https://vidyard.com/stream/...).
```

**Prompt:** 
```
Create a new player called 'Website Homepage' and attach my latest video to it.
```

**Response:** 
```
Success! I've created the player 'Website Homepage' (ID: pl-999) and attached the video 'Company Vision 2026' (ID: vy-888) to it. The player is now ready for embedding.
```

## Capabilities

### List video assets
Retrieves a complete list of every video stored in your account.

### Get video technical details
Pulls specific metadata for any video, including its length and encoding status.

### Manage video players
Creates new player containers or updates existing ones to customize how videos are embedded on a webpage.

### Retrieve direct stream links
Gets raw, usable MP4 download and streaming URLs for various resolutions (e.g., 1080p, 720p).

### Organize video content
Attaches a specific video asset into a designated player container.

## Use Cases

### The QA Engineer needs source links for testing.
Instead of logging into Vidyard and manually finding the download link, they ask their agent: 'Get all source files for the onboarding video.' The agent calls get_video_source_files and delivers structured URLs instantly.

### The Marketing Manager needs to update a campaign page.
They instruct their agent to first list_videos to confirm the correct asset ID, then use create_empty_player to build a new player facade, and finally attach_video_to_player with the right content.

### The Support Team needs to audit old projects.
They ask the agent to list_videos, review the metadata for older assets using get_video_details, and confirm which players can be safely deleted via delete_video_player.

## Benefits

- You stop clicking through dashboards just to check status. Use get_video_details to instantly know a video's encoding status or length.
- Need multiple stream links? The get_video_source_files tool gives you direct, raw MP4 URLs for various qualities (480p, 720p, etc.) without manual export.
- Building custom embeds is fast. You can use create_empty_player to build a shell and then attach_video_to_player to fill it immediately.
- The system keeps you safe. Credentials pass through the Vinkius zero-trust proxy, meaning your API keys are only used in transit—they never live on disk.
- It handles cleanup too. When a campaign ends, use delete_video_asset or delete_video_player to clean up containers and unused files.

## How It Works

The bottom line is that your AI client becomes a dedicated administrator for your entire video content system.

1. First, connect your Vidyard API Token to the MCP via Vinkius.
2. Next, tell your AI client what you need; for example, 'List all my video assets' or 'Get metadata for vy-123'.
3. The agent executes the necessary tool call and hands back the structured data, allowing you to continue the conversation.

## Frequently Asked Questions

**Can I get direct download links for my videos through the agent?**
Yes. The `get_video_source_files` tool allows your agent to retrieve direct MP4 download links and stream URLs for different qualities (like 720p or 1080p), making it easy to share raw files or use them in other applications.

**How do I add a video to a specific player?**
Use the `attach_video_to_player` tool. You'll need to provide the `player_id` and the `video_id`. Your agent can help you find these IDs by listing your players and videos first.

**Can I create new video players through conversation?**
Absolutely. The `create_empty_player` tool lets you provision a new player container with a descriptive name. Once created, you can attach videos to it and manage its settings directly through your agent.

**If I need to permanently remove content, how do I use `delete_video_asset`?**
The tool immediately and irreversibly deletes a video asset. Use this function only after confirming the unique video ID, as this action cannot be undone.

**How can I use `list_videos` to check what assets I have?**
This function pulls a comprehensive list of every video stored in your Vidyard dashboard. It gives you the necessary IDs and titles needed for any subsequent actions, like attaching or checking metadata.

**I need to rename a container; what is the purpose of `update_player_name`?**
It changes the visible display name (or title) of an existing video player. You must provide the exact ID of the player you want to modify.

**What technical data do I get when running `get_video_details`?**
This retrieves core metadata, including the video's length and its current encoding status. It confirms if your content is ready for distribution or if further processing is needed.

**Before attaching anything, how do I use `list_video_players`?**
It lists every single configured video player container in your account. This helps you see exactly which players exist and what their IDs are before you try to add or delete them.