# EX.CO Video Experience MCP

> EX.CO Video Experience MCP gives your AI agent control over video libraries and interactive content. It lets you pull detailed performance metrics, audit playlists, and track engagement data—all from a simple conversation.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** video-engagement, interactive-content, performance-analytics, content-distribution, audience-metrics, video-library

## Description

Need to know how well your video campaigns are performing? This connector links directly to the EX.CO platform, letting your AI client manage everything from core video assets to polls and quizzes. You stop manually navigating multiple dashboards just to compile a single performance report. Instead, you can ask your agent for a high-level view of total views this quarter or pull specific details on an interactive quiz's engagement rate. It manages the entire content lifecycle—from listing every available asset in your library to providing detailed metadata on distribution channels and playlists. When you connect it through Vinkius, you get one central place to orchestrate your video strategy using plain language commands.

## Tools

### get_ex_co_account_metadata
Retrieves usage limits and general metadata for your entire EX.CO account.

### get_video_analytics_summary
Generates a high-level overview of video views, completions, and overall engagement rates.

### get_content_detailed_intelligence
Pulls deep settings and performance data for one specific piece of interactive content.

### quick_video_performance_audit
Runs a fast, high-level audit to summarize key video performance metrics and analytics.

### get_video_detailed_data
Fetches detailed settings and technical metadata for one specific video asset.

### list_video_distribution_channels
Lists all video channels configured within your organization's setup.

### list_interactive_content
Lists all available interactive items, such as polls or quizzes, in your account.

### list_video_playlists
Lists all curated playlists that have been created within your account.

### list_successfully_published_videos
Identifies and lists only those videos that are currently live and published to the public.

### list_video_library
Provides a complete list of every video asset stored in the EX.CO library.

## Prompt Examples

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

**Response:** 
```
I've found 15 videos in your EX.CO library, including 'Product Launch 2024' and 'Tutorial - Getting Started'. 12 are currently 'Published'. Would you like to see the analytics for the Product Launch video?
```

**Prompt:** 
```
Show me analytics summary for this week.
```

**Response:** 
```
This week across your library, you have 15,000 total views and a 65% completion rate. The video 'Interactive Quiz - Q1' has the highest engagement (12%). Would you like to see the channel distribution breakdown?
```

**Prompt:** 
```
Search for interactive content matching 'Quiz'.
```

**Response:** 
```
I've found 3 interactive items matching 'Quiz': 'Customer Feedback Quiz', 'Product Knowledge Quiz', and 'Fun Personality Quiz'. All are currently 'Active'. Would you like the detailed performance for the Customer Feedback Quiz?
```

## Capabilities

### Audit Content Status
List every video in the library or identify only those assets currently marked as published.

### Track Performance Metrics
Get immediate, high-level summaries of total views and overall engagement rates across your content.

### Manage Interactive Elements
List all quizzes and polls, and pull specific performance data for any single interactive item.

### Review Metadata & Scope
Check detailed settings for a video or retrieve metadata limits for the entire EX.CO account.

### Map Distribution Structure
See all configured playlists and available distribution channels for your content.

## Use Cases

### Quarterly Campaign Review
The Marketing Manager needs to report on video performance. They ask their agent to run `get_video_analytics_summary` and then follow up by running `list_video_playlists`. The resulting data shows total views, completion rates, and which curated playlists drove the most traffic.

### Compliance Check
An Operations Analyst needs to know if all required compliance videos are live. They first run `list_video_library` to see everything, then filter using `list_successfully_published_videos`. This confirms the correct assets are visible to the public.

### Quiz Engagement Deep Dive
A Content Editor wants to know why one quiz is failing. They use `list_interactive_content` to find the ID, and then call `get_content_detailed_intelligence` with that ID. This provides performance data that shows exactly where participants are dropping off.

### New Content Rollout Prep
A Digital Publisher is setting up a new content series. They first check `list_video_playlists` to find the correct container, then use `get_ex_co_account_metadata` to ensure their account has enough capacity for the incoming assets.

## Benefits

- Instead of calling `list_video_library` and then manually checking 50 video IDs, you can use the `quick_video_performance_audit` tool to get an immediate summary view of total views and engagement rates.
- Need to know how many quizzes or polls are live? Use `list_interactive_content` to see every item in your account without navigating multiple tabs. You also check its performance using `get_content_detailed_intelligence`.
- Stop guessing where content lives. If you need to map out distribution, first run `list_video_playlists`, then use `list_video_distribution_channels` to see every potential destination for those assets.
- The moment you want deep technical specs on one video, don't search through the UI. Just ask your agent to use `get_video_detailed_data` and get the exact metadata instantly.
- You can filter content by status easily. Instead of scrolling forever, run `list_successfully_published_videos` to see only the assets ready for public viewing.

## How It Works

The bottom line is: you talk to it like a person, and your AI client pulls the data you need without opening any web dashboards.

1. Connect the EX.CO integration to your AI agent by authorizing it with your API key.
2. Tell your agent what you need—for example, 'What's the performance summary for Q2?'
3. Your agent executes the necessary tools and returns a concise answer detailing views, completion rates, or metadata.

## Frequently Asked Questions

**How do I see all my videos in the EX.CO library using `list_video_library`?**
You simply ask your agent to run `list_video_library`. It returns a full list of every video asset you have, including their ID and basic metadata.

**Can I use `get_content_detailed_intelligence` for videos, or just quizzes?**
The `get_content_detailed_intelligence` tool is specifically designed for interactive items like polls and quizzes. You'll need to use `get_video_detailed_data` for core video files.

**What if I only want my published videos? Is there a specific tool?**
Yes, you can run `list_successfully_published_videos`. This instantly filters the entire library down to only those assets that are ready and visible to users.

**How do I check my account limits before publishing a major campaign?**
Run `get_ex_co_account_metadata`. This tool pulls your current usage metrics and tells you what the platform's structural limits are, preventing overages.

**When I use `get_video_analytics_summary`, what specific metrics can my AI client retrieve about viewer behavior?**
The summary provides key performance indicators like total views, completion rate, and interaction rates. You can also request data on average session duration or traffic source breakdowns within the same call.

**How do I use `list_video_playlists` to see which videos belong together?**
The tool first lists all playlists and their IDs. Then, you pass a specific playlist ID back into the agent to retrieve the exact metadata for every video contained within that grouping.

**If I try running `get_video_detailed_data` for an ID that doesn't exist, how should my agent handle the error?**
The MCP will return a specific 'Not Found' status code. Your client must check this response body before attempting further operations on any content item to prevent script failure.

**What is the best way to perform a broad, high-level audit of my entire video content using `quick_video_performance_audit`?**
This tool gives you an instant snapshot of overall volume and channel activity across your library. It's ideal for quick health checks before diving into deep performance metrics or metadata retrieval.

**How do I get an EX.CO API Key?**
Log in to your EX.CO platform, navigate to **Settings > API Integration**, and you can generate or retrieve your unique **REST API Key** from there. Ensure you have the necessary organizational permissions.

**Does the integration show real-time views?**
Yes, you can use the get_video_analytics_summary tool to retrieve the latest view counts, completions, and interaction metrics across your entire video library.

**Can the agent upload new videos?**
This integration currently focuses on listing and auditing videos, interactive content, and analytics. Uploading or editing video assets should be managed via the EX.CO platform dashboard.