# ContentGroove MCP

> ContentGroove lets your AI agent automatically pull highlights and manage media projects from long videos. Upload source footage or link to a video, then use natural language prompts to tell it exactly what kind of clips you need—like finding all moments where the speaker mentions 'AI' or extracting every key takeaway from an hour-long podcast.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** video-editing, ai-transcription, content-repurposing, video-highlights, automated-clipping

## Description

This MCP connects an intelligent video processing engine right into your workflow. Instead of manually scrubbing through hours of footage, you chat with your agent and tell it what to find. You can command it to take a massive podcast recording and automatically slice out the most engaging, bite-sized segments. It pulls the best moments from long videos and gives you fully transcribed captions alongside them.

Managing content is easy: first, use the tools to list all your current media projects. Then, if you need more clips, just send a request. This process works whether you upload the file directly or give it a URL. When you're ready to check on everything, the system lets you review project status and even list every single clip generated so far. It’s one central place for all your video assets; connecting this through Vinkius gives you full control over complex media pipelines right from your chat interface.

## Tools

### create_media_from_url
Imports and queues a video for processing if you provide a direct public link to it.

### create_direct_upload
Generates a unique web address so you can upload the video file directly into the system.

### get_clip_details
Retrieves specific information, like duration or transcript snippet, about one single highlight clip.

### get_media_clips
Lists all the individual clips that were generated from a particular media project.

### get_media_details
Gathers general information about an entire video or media processing job.

### get_media_status
Checks if a submitted media project is still rendering or if it finished already.

### list_all_clips
Retrieves a list of the most recently generated video highlights across all your projects.

### list_media
Provides an overview and listing of every media project currently stored in ContentGroove.

## Prompt Examples

**Prompt:** 
```
Extract the 5 most engaging viral slices from project 'vid9x3a' for a social media campaign.
```

**Response:** 
```
Video slices identified and retrieved. From target 'vid9x3a', I've loaded 5 core highlight moments processed by ContentGroove. Would you prefer reviewing the direct links or looking at the extracted transcript captions?
```

**Prompt:** 
```
Check the status of my latest video project render queue.
```

**Response:** 
```
I checked ContentGroove. Your latest project titled 'Webinar Highlights 2024' is currently rendering slice elements at 82%. Should I notify you once it finishes completely?
```

**Prompt:** 
```
List all recent AI-generated clips across my account.
```

**Response:** 
```
I've fetched your clips. Here are the 5 most recent highlights from across your projects, including 'Interview with CEO' and 'Product Launch Keynote'. Which one would you like to inspect?
```

## Capabilities

### Generate Media Assets
Create highlight reels and segmented clips from long-form videos using simple text commands.

### Import Source Content
Accept video files uploaded directly or imported via a public URL for processing.

### Track Project Status
Check the current rendering percentage and status of any ongoing media project.

### View Content Inventory
List all active, stored media projects or every single generated highlight clip in one place.

### Review Metadata
Get detailed information about a specific project or a particular extracted video segment.

## Use Cases

### The Quarterly Webinar Cleanup
A marketing team just recorded a 90-minute QBR. Instead of spending an afternoon finding key quotes, they ask their agent to 'Extract the top five moments mentioning ROI.' The MCP uses `list_all_clips` and `get_media_clips` to pull the segments immediately.

### The Podcast Repurposing Funnel
A podcast host finishes a 2-hour episode. They use `create_media_from_url` to queue it up, then ask their agent to slice out every segment that sounds like an 'expert tip.' This turns one asset into dozens of usable clips.

### The Project Audit
A project manager needs to know if a complex rendering job finished last week. They simply call `list_media` to see the project name, then use `get_media_details` to confirm its final status and links.

### The Emergency Clip Need
A sales team needs a quick 30-second clip for an ad right now. They upload the full keynote via `create_direct_upload`, run the tool to identify 'pricing structure,' and immediately get usable assets.

## Benefits

- Stop manually clipping. You can use the tool to automatically find and slice engaging sections, giving you immediate micro-content for social media.
- Never lose source material again. Use `list_media` to see every single project you’ve ever uploaded or processed in one place.
- Speed up content review using `get_clip_details`. Instead of downloading everything, you can quickly check the timing and transcript of a specific highlight segment.
- Handle different sources easily. The MCP supports both `create_direct_upload` for local files and `create_media_from_url` for online videos.
- Track large jobs effortlessly. If you submit an hour-long video, use `get_media_status` to check exactly where the processing is at.

## How It Works

The bottom line is that your agent handles all the heavy lifting: ingestion, processing, and organization of video assets based on your chat prompts.

1. First, you initiate the process by giving your agent a source video—either by uploading it directly or providing a URL.
2. Next, you use conversation to issue commands, telling the system what specific highlights or segments you need extracted from that footage.
3. The engine processes the request and provides detailed results, letting you review project status or list all resulting clips.

## Frequently Asked Questions

**How do I upload a video using ContentGroove? (create_direct_upload)**
You use the `create_direct_upload` tool to generate a signed URL. You then use that link to push your local file into the system for processing.

**What is the difference between list_all_clips and get_media_clips? (list_all_clips)**
`list_all_clips` shows you a quick overview of every highlight across your account. `get_media_clips` requires a specific media project name to list only its associated clips.

**Can I check if my video is done processing with ContentGroove? (get_media_status)**
Yes, use the `get_media_status` tool. It provides a real-time percentage and status update on your media project render queue.

**How do I start processing a video from an online link? (create_media_from_url)**
Simply call `create_media_from_url` and provide the public URL. The MCP queues the job, allowing you to monitor its progress later.

**How can I use the `list_media` tool to view my entire project library?**
The `list_media` tool provides a full catalog of every media project you've uploaded or processed. It lets you see all your existing video assets and gives you an overview, including titles and current status for everything managed by ContentGroove.

**What does the `get_media_clips` tool handle, and how is it different from listing all clips?**
The `get_media_clips` tool lists every clip associated with a specific video project. You must provide a target media ID to use this function; otherwise, you'll just get the list of all general highlights available across your account.

**If I need full metadata on one project, how do I use `get_media_details`?**
The `get_media_details` tool retrieves comprehensive data for a single media project ID. This includes deep-dive information like original file size, creation date, and specific processing parameters used during generation.

**If I find an interesting highlight segment, how can I use `get_clip_details` to pull out more data?**
Using `get_clip_details`, you get granular information about one particular clip. This includes the exact source timestamps and duration of the highlight, which is crucial if you need to verify its placement in the original footage.

**How do I generate an API Key inside ContentGroove?**
Log into your active ContentGroove dashboard. Navigate to the **Settings** menu. From there, locate the section labeled **API Keys** and click 'Generate'. Securely copy the resulting string to connect your AI.

**Does AI video processing incur additional costs on ContentGroove?**
Every operation routed through the AI integration relies on your base ContentGroove tier limits. AI-invoked splicing acts as standard manual generation costs; ensure constraints are observed so you stay within your processing credits limit.

**Can I publish video clips straight from the integration?**
No, this integration strictly isolates the video editing capabilities and project listing utilities. To post on major platforms directly from chat, ensure you link subsequent social network MCP integrations into your workflow.