# Vadoo MCP

> Vadoo MCP Server handles the entire video content pipeline: AI generation, automatic captioning, and viral clip extraction. It lets you turn text prompts or long YouTube videos into multiple finished assets—from vertical shorts for social media to conversational podcasts.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** ai-video-generation, video-editing, viral-clips, video-seo, content-creation, subtitles

## Description

Listen up. This Vadoo MCP Server handles your whole video game from start to finish: generating the content, chopping it up for social media, and making sure you can actually use it. You connect this server to your agent, and suddenly, you're running a full-scale video production house without leaving your chair.

**Generating New Videos**
You gotta script something? Just give us some detailed text prompts or upload a whole script; we’ll crank out an entirely new AI video asset for ya. You don't have to worry about the technical side of making it look good—you just write what you wanna say, and we handle the rest.

**Extracting Viral Clips**
Got a long YouTube video or some other external link that’s too much? Don't sweat it. We analyze that URL and automatically generate multiple short, ready-to-post segments perfect for social media platforms. You feed us the raw footage, and we give you bite-sized gold.

**Turning Text into Podcasts**
Need a conversational audio track but don’t wanna write two people talking? Give us some text or just throw out a couple of topics, and we'll generate a structured, two-person AI podcast. It's like hiring two professional voices who talk exactly how you want them to.

**Optimizing the Finish**
Once your video is done, it ain't finished until it has captions. You send us the completed video asset, and we overlay accurate, synchronized captions right on top of it. This isn't just for accessibility; it seriously boosts SEO and keeps viewers hooked.

**Managing Your Library Assets**
You won't lose anything here. If you want to see everything you've ever made, use the `list_videos` tool; it pulls a full manifest of every video asset in your library, giving you metadata and status checks on all of 'em. For any single piece of work, say you only need to know what’s up with that one specific ID, you just run `get_video_details`, and we hand over the exact status, details, and info for that video.

This whole setup means you're never stuck on a dead end. You create the concept, generate the core asset, chop it into viral pieces, make sure it’s captioned right, or even turn it into a podcast—it’s all one pipeline. It saves ya time, period.

## Tools

### add_captions
Adds accurate, synchronized captions to a finished video asset.

### create_clips
Analyzes an external video URL and generates multiple short segments for social media use.

### generate_podcast
Generates a conversational, two-person podcast from text or topics you provide.

### generate_video
Creates an entirely new AI video asset based on your script or prompt input.

### get_video_details
Retrieves specific metadata, status, and details for a single video ID.

### list_videos
Pulls a comprehensive list of all videos you've generated so far in your library.

## Prompt Examples

**Prompt:** 
```
List all the AI videos I've generated so far.
```

**Response:** 
```
I've retrieved your video library. You have 8 generated videos, including 'Marketing Intro', 'Product Demo v1', and 'AI News Weekly'. Which one would you like to get the download link for?
```

**Prompt:** 
```
Create viral clips from this YouTube video: https://youtube.com/watch?v=123.
```

**Response:** 
```
Processing video... I've initiated the clip creation for the provided URL. Vadoo AI is now identifying viral moments. I'll let you know once the clips are ready for review.
```

**Prompt:** 
```
Generate a vertical AI video about 'The future of remote work'.
```

**Response:** 
```
AI video generation started! I've triggered a new creation with a 9:16 aspect ratio. The project ID is vid_10293. The AI is now assembling the visuals and script.
```

## Capabilities

### Generate New Videos
Creates a new video asset using detailed text prompts, allowing you to define the script or topic.

### Extract Viral Clips
Analyzes an external video URL and generates multiple short clips suitable for social media platforms.

### Add Captions
Takes a finished video asset and overlays synchronized captions, improving accessibility and SEO.

### Generate Podcasts
Converts written material or topics into a structured, conversational two-person podcast audio track.

### List Video Assets
Pulls a full list of your generated videos, providing metadata and status checks.

## Use Cases

### Turning a long webinar into social content
The Marketing Director uploads a 60-minute recorded webinar. Instead of spending hours reviewing it, they ask their agent to run `create_clips` on the video URL. The server immediately identifies and generates five distinct, short clips ready for posting across different platforms.

### Quickly launching a product announcement
The Product Team writes a detailed pitch document. They ask their agent to use `generate_video` with the text as the script. The server then builds and generates the video asset, ready for review without needing any visual design team time.

### Improving podcast reach and SEO
A Podcaster has a written transcript from an interview. They feed the text into the agent, which uses `generate_podcast`. This creates a fully produced audio file that's ready to upload, vastly improving their content pipeline.

### Auditing and tracking assets
The Content Lead needs to know if 'Q3 Strategy Update v2' was finished. They run `list_videos` to check the asset status, then use `get_video_details` on the specific ID to confirm it has a final download link.

## Benefits

- Stop manually editing raw footage. Use `generate_video` to create high-quality, structured videos from simple text prompts or scripts instantly.
- Need shorts for Reels? Instead of downloading a massive file and trimming it in Premiere, just run `create_clips` on the full YouTube URL to pull out viral moments.
- Accessibility is built-in. After your video is done, running `add_captions` ensures every word gets transcribed and overlaid correctly, boosting SEO and reach.
- Podcasting doesn't need a microphone anymore. Give it an article outline, call `generate_podcast`, and you get a fully formed, two-person audio conversation.
- Never lose track of your work. Use `list_videos` to see every asset you’ve generated, then grab `get_video_details` for the direct download link when you're ready to publish.

## How It Works

The bottom line is you use your agent to speak natural commands that trigger these specific functions; no manual dashboard clicking is necessary.

1. Subscribe to the Vadoo server and enter your unique Vadoo AI API Key into your agent's configuration.
2. Your AI client sends a structured request (e.g., 'run `create_clips` on this URL').
3. The server processes the request, generating or modifying the content and returning the final asset details or download link.

## Frequently Asked Questions

**How do I list all my videos using list_videos?**
You simply ask your agent to run `list_videos`. It returns a comprehensive list of every asset you’ve generated, along with their current status (e.g., 'Processing' or 'Ready').

**Can I make clips from a video link using create_clips?**
Yes. You pass the external URL to `create_clips`. The server analyzes it and generates multiple social-media-ready segments, pulling out the best moments automatically.

**What's the difference between generate_video and create_clips?**
`generate_video` makes a brand new video from scratch using a text script. `create_clips`, however, takes an existing video file or URL and only extracts short segments from it.

**Do I need to run add_captions every time?**
Not always, but you should if your audience is international or if you need high accessibility. Running `add_captions` ensures the captions are generated and overlaid correctly onto the final video file.

**What credentials do I need to connect the Vadoo AI server?**
You require your personal Vadoo AI API Key. You find this key in your account dashboard. Your agent uses it for authentication, so make sure you keep it secure.

**How can I check the status of a job using get_video_details?**
You pass the specific video project ID to `get_video_details`. This returns metadata showing if the video is queued, processing, or finished. It’s the best way to track long-running jobs.

**What kind of source material should I use when calling generate_podcast?**
The `generate_podcast` tool accepts text topics or scripts directly. You don't need a video link; just provide the raw content you want the AI to discuss in a conversational format.

**Are there rate limits when calling Vadoo AI tools?**
Yes, API usage is governed by specific rate limits. If you exceed them, your client will receive an appropriate HTTP exception code. Check the official documentation for current quotas.

**Can I generate a video in a specific aspect ratio?**
Yes! When using the `generate_video` tool, you can specify the `ratio` parameter (e.g., '9:16' for vertical shorts or '16:9' for horizontal videos).

**How do I turn a long YouTube video into viral clips?**
Use the `create_clips` action and provide the YouTube URL. Vadoo AI will analyze the content and automatically extract high-potential segments for social media.

**Is it possible to add captions to an existing video ID?**
Absolutely. Use the `add_captions` tool and provide the Video ID. The AI will generate and overlay the subtitles onto that specific video in your library.