# Vadoo AI MCP

> Vadoo AI lets you generate complex multimedia assets—videos, podcasts, and captions—using simple text prompts. Instead of spending hours in video editors or recording sessions, you feed it a prompt or a long video URL, and your agent handles the rest. It automatically creates engaging short clips, synthesizes full podcast episodes, and pulls precise subtitles, all without needing to touch a camera or microphone.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** ai-video, podcast-generation, automated-captions, content-synthesis, multimedia-tools

## Description

Listen up. This isn't your uncle's video editor. The **Vadoo AI MCP Server** lets you treat multimedia production like calling an API function—it’s straight-up power for your agent. You feed it simple text, and it spits out fully finished videos, podcasts, and captions.

When you need to make a whole new video, just use `vadooai_generate_video`. You give the tool a descriptive prompt—like, 'The history of space exploration'—and pick a voice; it builds the entire thing from scratch. For audio-only stuff, if you want an episode ready for publication, call `vadooai_generate_podcast`. You just drop in a topic or write out the script, and it synthesizes a complete podcast without needing any mics or recording studio time.

Got a massive video file that needs chopping up? Run `vadooai_create_clips` with a long video URL. It automatically analyzes the content and pulls out several short, punchy promotional clips you can use on social media. If you've got a finished video but it lacks subtitles, run `vadooai_generate_caption`. You process an existing video file, and it spits back perfectly timed, accurate captions or subtitles.

Since these jobs take time, you need to track them. To see if any generation job is done, use `vadooai_check_generation_status` by feeding it the job ID. If a video finished up already, you can call `vadooai_check_video_status` to get all the metadata and details about that final product.

You're not wasting time in complicated software; your agent handles the whole pipeline—from text prompt right through to ready-to-post assets. You just tell it what you want, and it takes care of the heavy lifting.

## Tools

### vadooai_check_generation_status
Checks the current status of a multimedia generation task using its ID.

### vadooai_check_video_status
Retrieves specific details and metadata for a video that has already been fully generated.

### vadooai_create_clips
Takes a long video URL and automatically extracts several short, engaging promotional clips.

### vadooai_generate_caption
Generates accurate captions or subtitles for an existing video file.

### vadooai_generate_podcast
Synthesizes a complete, ready-to-publish podcast episode from a topic or script.

### vadooai_generate_video
Creates an entirely new video file using only a descriptive text prompt and voice selection.

## Prompt Examples

**Prompt:** 
```
Generate a video about the history of artificial intelligence.
```

**Response:** 
```
Here is the information you requested based on the execution of the tools.
```

**Prompt:** 
```
Create short clips from this YouTube video URL: https://youtu.be/example
```

**Response:** 
```
Here is the information you requested based on the execution of the tools.
```

**Prompt:** 
```
Check the status of my video generation task ID 88992.
```

**Response:** 
```
Here is the information you requested based on the execution of the tools.
```

## Capabilities

### Generate Video from Text Prompt
Creates a complete video file based on a text prompt and selected voice.

### Extract Short Clips from Long Videos
Analyzes a video URL and generates multiple, engaging short clips automatically.

### Generate Video Subtitles/Captions
Processes a video file to generate accurate, time-coded captions or subtitles.

### Synthesize Podcast Episodes
Generates an entire podcast episode from just a topic or written script; no recording is needed.

### Check Job Status and Details
Queries the server to track job progress or retrieve metadata about already finished content.

## Use Cases

### Converting a Webinar Recording
A marketing director has a 90-minute webinar recording. Instead of manually watching it, she asks her agent to run the URL through `vadooai_create_clips`. The agent automatically identifies three key moments and delivers three distinct short promotional clips that can be posted immediately.

### Launching a New Podcast Series
A subject matter expert needs to launch a podcast on blockchain technology. They use `vadooai_generate_podcast`, feeding it the title and key bullet points. The agent produces a high-quality, synthesized episode that looks like they recorded it themselves.

### Creating Ad Copy for a Product
A small business owner needs five different ad videos for a new coffee blend. They use `vadooai_generate_video`, providing five distinct prompts (e.g., 'cozy morning routine,' 'energy boost,' etc.). The agent handles the video generation for all five, allowing rapid A/B testing.

### Adding Accessibility to Old Footage
A documentary filmmaker has archival footage with poor sound quality. They run the URL through `vadooai_generate_caption`. The server provides precise, time-coded captions, making the content accessible and ready for modern viewing platforms.

## Benefits

- **Build Videos from Zero:** Use `vadooai_generate_video` to turn a simple text prompt into a complete video file. No scriptwriting, no camera needed—just type what you want.
- **Repurpose Content Instantly:** Feed any long source video link into the agent and call `vadooai_create_clips`. You get multiple short, viral-ready snippets in seconds. This is massive time savings.
- **Never Record an Episode Again:** Instead of scheduling recording time for a podcast, use `vadooai_generate_podcast`. Provide the topic or outline, and we deliver a finished audio file ready for distribution.
- **Perfect Subtitles Every Time:** If you upload existing footage, run it through `vadooai_generate_caption` to get precise subtitles. This is critical for social media where people watch with sound off.
- **Full Visibility into Jobs:** You don't have to guess if your video job finished. Use status tools like `vadooai_check_generation_status` to track everything in real-time.

## How It Works

The bottom line is: you give it a goal or a link, and your agent handles all the complex multi-step media generation process for you.

1. First, pull your API Key from the Vadoo AI dashboard and provide it to this integration.
2. Next, instruct your agent with a high-level goal—for example, 'Make me three clips about renewable energy.'
3. The server executes the necessary sequence of tools (e.g., generate video -> check status -> create clips) and returns the final asset URLs.

## Frequently Asked Questions

**How do I check if my `vadooai_generate_video` job is finished?**
You must use a status tool. Call `vadooai_check_generation_status`, providing the task ID you received when you started the generation. This confirms completion before you try to download the asset.

**Can I use `vadooai_create_clips` on my own uploaded files?**
No. The `vadooai_create_clips` tool requires a public video URL (like YouTube or Vimeo). It analyzes the source material from that link to find engaging segments.

**What is the difference between `vadooai_generate_caption` and podcasting?**
They serve different media types. Use `vadooai_generate_caption` when you need text subtitles for a video source. Use `vadooai_generate_podcast` when you want to create an entirely new, synthetic audio episode.

**Is Vadoo AI good for generating educational content?**
Yes. You can use `vadooai_generate_video` by prompting it with academic topics (e.g., 'Principles of Thermodynamics'). This allows you to quickly prototype educational videos without external resources.

**If I call `vadooai_generate_video` with a bad prompt, how do I handle the error?**
The API will return a specific error code detailing the issue. Look for message codes related to content policy violations or insufficient detail. You'll need to revise your input and try again.

**What is the maximum number of clips I can create using `vadooai_create_clips`?**
Our system operates on a usage quota, not a hard limit per call. If you exceed your allotted rate for clip generation, subsequent calls will receive a 429 Too Many Requests error until the next billing cycle begins.

**Does `vadooai_generate_caption` support different output formats?**
Yes, it supports multiple formats. You can request captions as simple plaintext, industry-standard SRT files for video players, or structured JSON data for programmatic use.

**What should I do if `vadooai_check_generation_status` shows a task stuck 'Processing' indefinitely?**
If the status stalls after an unusually long period (over 30 minutes), it suggests an internal processing error. Try submitting the generation request again, or contact support with your original job ID.

**Can I generate an entire podcast just from a topic string?**
Yes. By invoking the 'vadooai_generate_podcast' tool and supplying a simple topic, the API synthesizes the audio and returns a task ID to track it.

**How do I download the generated video?**
Use the 'vadooai_check_video_status' tool with your Task/Video ID. Once generation is complete, the API will return the direct download URL.

**Is it possible to extract short clips from a YouTube URL?**
Yes. Provide the video URL to the 'vadooai_create_clips' tool, and Vadoo AI will automatically parse the video and generate short-form clips.