# Runway ML MCP for AI Agents AI Agent Connect

> Runway ML lets you build and manage high-end video assets using your favorite AI client. It handles the heavy lifting of triggering Gen-3 Alpha and Gen-2 models, setting specific parameters like aspect ratios and seeds, and tracking progress so you don't have to keep checking a browser tab.

## Overview
- **Category:** ai-frontier
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_FzKS58CS7GrKP3SzLX2e7AIMNzTDbvY8eQtVxSEb/ai-agent-connect
- **Tags:** video-generation, generative-ai, media-production, text-to-video, creative-automation

## Description

Runway ML lets you turn a conversation with your AI agent into a production-ready video. Instead of jumping back and forth between a browser and a prompt window, you tell your agent what you want to see. It handles the specific settings for high-end models like choosing between different versions, setting the duration, and choosing the right aspect ratio. Your agent keeps an eye on the progress and pings you when the video is ready. It also keeps your workspace clean by letting you list, delete, or cancel tasks on the fly. This makes the whole process feel like you have a production assistant who knows the technical details of the API while you focus on the creative direction. You'll find this Connector in the Vinkius catalog, where it sits alongside other professional media tools to help you build a cohesive creative stack. It takes the friction out of iterative video production.

## Tools

### delete_task
Remove a specific generation from your history. This helps you keep your workspace organized and clear out failed attempts.

### get_task
Check the current status of a specific video generation. It tells you if the task is still processing or if it's ready to view.

### create_task
Start a new video generation using specific models and settings. This lets your agent handle the technical parameters for Gen-3 Alpha or Gen-2.

### list_tasks
See a full list of your recent and active video generations. This helps you keep track of everything your agent has started for you.

## Prompt Examples

**Prompt:** 
```
Make a 10-second video of a futuristic city with neon lights in a 16:9 ratio.
```

**Response:** 
```
I've started that for you using the Gen-3 Alpha Turbo model. Your task is now in the queue. I'll let you know as soon as the video is ready to view.
```

**Prompt:** 
```
What's the status of my cyberpunk street video?
```

**Response:** 
```
I've checked the status for you. The generation is complete! You can view and download your video here: **[Video Link]**

**Task Details:**
* Status: Succeeded
* Model: Gen-3 Alpha
* Duration: 10s
```

**Prompt:** 
```
List all the videos I've made today.
```

**Response:** 
```
Here are the tasks you've initiated today:

| Task Name | Status | ID |
| :--- | :--- | :--- |
| Cyberpunk Street | Succeeded | 7a8b9c-d1e2 |
| Mountain Sunset | Processing | 9f8e7d-c6b5 |
| Neon City | Succeeded | 1a2b3c-4d5e |
```

## Capabilities

### Trigger Gen-3 Alpha and Gen-2 generations
Start new video tasks using the latest models with specific prompt instructions.

### Set specific video dimensions and durations
Define the exact aspect ratio and length for every video you create.

### Track real-time progress of active tasks
Check the status of your videos to see when they are ready for review.

### Retrieve final video URLs automatically
Get the direct link to your finished video as soon as the processing is done.

### Organize and clear your generation history
View all your past creations and remove old tasks to keep your workspace tidy.

### Cancel tasks that aren't hitting the mark
Stop active generations immediately if the output doesn't match your vision.

## Use Cases

### Rapid Storyboarding
A director describes a scene, and the agent uses create_task to generate 5 different 5-second clips to see which vibe works best.

### Automated B-Roll
A content creator asks for a rainy cyberpunk street and the agent handles the Gen-3 Alpha Turbo settings to create a batch of assets.

### Project Cleanup
A developer uses list_tasks and delete_task to clear out dozens of test generations before presenting a final reel to a client.

### Status Monitoring
A user asks Is my video done yet? and the agent uses get_task to provide a direct link to the finished file.

## Benefits

- Stop tab-switching by using create_task to trigger videos directly from your agent. You stay in your flow while the heavy lifting happens in the background.
- Get precise control over every frame using create_task to set seeds, aspect ratios, and durations. This ensures the output matches your creative vision exactly.
- Monitor production status with get_task so you don't have to keep refreshing a browser page. Your agent handles the polling for you.
- Keep your production history clean by using delete_task to remove old or failed generations. It makes managing large projects much easier.
- Quickly reference previous work using list_tasks to see what's been created. This helps you maintain consistency across a long project.

## How It Works

The bottom line is you get to move from idea to video asset without leaving your chat window.

1. Connect your Runway API key to the Connector.
2. Describe your video scene to your AI client.
3. Get a task ID and a notification when the video is done.

## Frequently Asked Questions

**Can I use the Runway ML MCP to make cinematic videos?**
Yes, this Connector connects your agent to Runway ML so you can generate high-end video assets using natural language.

**Does the Runway ML MCP support Gen-3 Alpha?**
Yes, it allows your agent to trigger both Gen-3 Alpha Turbo and Gen-2 models with specific settings.

**How does the Runway ML MCP handle video dimensions?**
You can tell your agent the exact aspect ratio or dimensions you need, and it applies those to the generation task.

**Can I see my previous video generations with the Runway ML MCP?**
Yes, your agent can list your entire generation history so you can keep track of your projects.

**Is the Runway ML MCP good for batch creating content?**
It's great for this because you can ask your agent to generate multiple scenes in a row without manual clicking.

**Can I cancel a video if it's not looking right?**
Yes, the Connector allows your agent to cancel active tasks so you can start over immediately.

**How do I start a new video generation with a specific prompt?**
Use the `create_task` tool. You can specify the model (like `gen3a_turbo`), the `promptText`, and even optional parameters like `duration` (5 or 10 seconds) or `ratio`.

**How can I check if my video is ready to download?**
Use the `get_task` tool with your unique task ID. It will return the current status and the output URL once the generation is complete.

**Is it possible to remove a task from my history or stop a running one?**
Yes, the `delete_task` tool allows you to cancel an active generation or remove the record of a completed task from your account.