# Creatomate MCP MCP

> Creatomate MCP automates your entire video production pipeline using conversation. Your AI agent handles everything from listing available video templates and checking project settings to triggering complex renders. It manages media assets, tracks render progress in real-time, and allows you to generate high-quality videos simply by talking to it.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** video-generation, automation, rendering, media-assets, video-templates

## Description

This MCP connects the Creatomate platform directly into your AI workflow, letting your agent handle all the heavy lifting of video content creation. You can now manage an entire media library—listing assets, checking project parameters, and finding available templates—all through natural conversation. Need a new ad? Your agent can trigger a full render using dynamic templates and custom text inputs with a single chat command. It monitors the task progress, letting you retrieve the final video URL as soon as it's ready. If your team is building complex content pipelines, integrating this via Vinkius lets you manage all these functions from one place, without ever having to open the web dashboard.

## Tools

### get_project_settings
Retrieves the configuration details and metadata for your current video project.

### get_render_status
Checks if a specific video render is complete, providing its URL when ready.

### get_template_details
Retrieves the exact structure and dynamic fields used within a specific video template.

### list_media_assets
Lists all images, videos, and audio files currently stored in your project library.

### list_video_automations
Lists all automated workflows configured to create videos based on certain triggers.

### list_recent_renders
Shows a history of completed or failed video rendering jobs, along with their status.

### list_video_templates
Retrieves a complete catalog of every video template available in your project.

### render_video
Starts the rendering process for a new video using specified templates and content modifications.

### search_templates_by_name
Searches through your available templates to find one matching a specific name or keyword.

## Prompt Examples

**Prompt:** 
```
Render a video using template 't8s9df7' with the text 'Flash Sale!' and background image 'sale.jpg'.
```

**Response:** 
```
Rendering task started (ID: r123abc). I'll let you know as soon as the 'Flash Sale!' video is ready. Should I send the final link to your marketing channel?
```

**Prompt:** 
```
What's the status of my video render 'r123abc'?
```

**Response:** 
```
Your video 'r123abc' is 100% complete. You can download or view it here: [Link]. The file format is MP4 and it lasts 15 seconds. Anything else?
```

**Prompt:** 
```
List all video templates in my project.
```

**Response:** 
```
I've found 4 templates in your project: 'Instagram Story Ad', 'YouTube Intro', 'Product Demo', and 'Customer Testimonial'. Which one would you like to use for a new render?
```

## Capabilities

### Initiate Video Production
Start a new video render by selecting a template and providing custom modifications like text or images.

### Manage Content Library
List, inspect, and retrieve details for all available media assets, including images, videos, and audio files.

### Audit Project Structure
View current project settings and list all available video templates to understand your content options.

### Track Render Status
Monitor the progress of a video render job, getting real-time updates until the final URL is available for download.

### View Production History
Get lists of recent rendering tasks and automated workflows to see what's already been created or scheduled.

## Use Cases

### Batch generating social media ad variations
A marketing manager needs 50 versions of a product launch video. Instead of manually creating each one, they ask their agent to run `render_video` using the 'Product Launch' template and list five different key messages as text modifications.

### Auditing an old content library
A developer needs to know what assets are available for a new project. They use `list_media_assets` to get a comprehensive inventory of all images, videos, and audio files before configuring the project.

### Tracking overdue campaign renders
The content team has several high-priority ads waiting for approval. Instead of refreshing the website repeatedly, they ask their agent to check `list_recent_renders` and then use `get_render_status` on the specific job ID.

### Finding the right ad template quickly
A team needs a new testimonial video but doesn't know which template works best. They use `search_templates_by_name` to narrow down options and then run `get_template_details` on the top choice to verify its dynamic fields.

## Benefits

- Stop guessing if your ad is done. Use `get_render_status` to check the progress of a render job, getting real-time updates until the final MP4 link pops up.
- Never start from scratch again. Instead of manually building ads, use `list_video_templates` or `search_templates_by_name` to instantly find proven structures for any campaign.
- Streamline content creation by having your agent handle asset management. Call `list_media_assets` to verify which images and videos are available before you even start a render.
- Manage complex projects without hitting the dashboard. You can audit project parameters using `get_project_settings`, ensuring all variables are correctly defined for success.
- Build predictable content pipelines by viewing all automated workflows via `list_video_automations` and understanding how different pieces fit together.

## How It Works

The bottom line is that you guide the content creation process through conversation; your AI client handles all the API communication.

1. Connect the Creatomate MCP to your AI client and authenticate using your API key.
2. Use conversational prompts to select templates, list assets, or set project parameters via the agent.
3. The agent executes the necessary calls (like triggering a render) and reports status updates directly in the chat.

## Frequently Asked Questions

**How do I check if my video render using `get_render_status` is finished?**
You ask your agent to run `get_render_status` with the job ID. The response will tell you the percentage complete and provide the final downloadable URL when it hits 100%.

**Which tool do I use to see all my available video templates?**
Use `list_video_templates` to get a comprehensive catalog of every template your project has. You can then refine this list using `search_templates_by_name` if you know the general topic.

**`list_media_assets` only shows finished videos, right?**
No, `list_media_assets` pulls everything—images, raw video clips, and audio files. It's your main source of truth for all stored media.

**What do I need to know before running a render with `render_video`?**
Before rendering, you should check `get_template_details`. This confirms the template is ready and shows exactly what dynamic fields (like text or background images) it expects from you.

**When I use `get_template_details`, how do I find out what dynamic fields a specific video template requires?**
The tool returns the complete schema for that template. You'll see all mandatory and optional input fields, which tells you exactly what data your render needs to run successfully.

**What information does `get_project_settings` provide about my overall Creatomate project?**
This tool retrieves the core metadata for your entire account. It lets you review global settings, API keys, and high-level parameters that affect all subsequent rendering tasks.

**If I want to audit or see which automated video pipelines I've set up, should I use `list_video_automations`?**
Yes, using `list_video_automations` shows a comprehensive catalog of all your defined workflows. This helps you manage and organize complex, multi-step processes beyond simple template rendering.

**How can I check the history or find details about a failed render job by using `list_recent_renders`?**
Running this tool lists all your recent video tasks, including their final status. This is essential for debugging because it provides detailed logs and IDs for jobs that didn't complete properly.

**How do I get a Creatomate API Key?**
Log in to your Creatomate account, select your project, and navigate to **Project Settings > API Keys** to generate a secret key.

**Can I provide dynamic text for videos?**
Yes, you can use the 'modifications' parameter in the render_video tool to swap text, images, or colors defined in your template.

**What is the rendering time?**
Rendering time depends on video length and complexity, but Creatomate is optimized for speed. You can use the get_render_status tool to check when it's done.