X (Twitter)LinkedInGitHubDiscordYouTube

Runway MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Runway MCP or direct API to generate videos, transform images, create media assets, and automate creative workflows through natural language.

Get started for freeGet a demo
Runway logoRunway
Api Key

Runway is a generative AI media platform for creating and transforming video, images, audio, avatars, voices, and creative workflows. It helps teams build high-quality visual content faster with API-driven media generation.

22 Tools

Try Runway now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Runway
Try asking
TOOLS

Supported Tools

Every Runway action and event your agent gets out of the box.

Cancel Task

Cancel a running Runway task or delete its task record.

Create Document

Create a Runway knowledge document from markdown or plain text for reuse by avatar workflows.

Create Ephemeral Upload

Create only a temporary Runway media upload slot and return its presigned multipart form details and runway:// URI.

Delete Document

Permanently delete a Runway knowledge document by its ID.

Generate Image

Start a Runway text-to-image or reference-guided image generation task and return its task ID and estimated credit cost.

Generate Sound Effect

Generate an audio effect from a text prompt and return the task ID and estimated credit cost.

Generate Speech

Synthesize speech with Runway using an exact model-specific voice and option contract, then return the task ID and estimated credit cost.

Generate Video from Image

Animate one or more input images with a selected Runway model and return the task ID and estimated credit cost.

Generate Video from Text

Start a Runway text-to-video task with a model-specific typed request and return its task ID and estimated credit cost.

Get Document

Get one Runway knowledge document, including its full content and the avatars that currently use it.

Get Organization

Return the connected Runway organization's credit balance, monthly credit spend cap, exact per-model quotas, and current daily generation usage.

Get Task

Get the current status, cost, output URLs, and failure details for a Runway generation task.

Get Usage

Return daily Runway credit usage by model for an optional UTC date range of up to 90 days.

Get Workflow

Get a published Runway workflow version and its graph so node IDs and output keys can be inspected before running the workflow.

Get Workflow Invocation

Get the current status, completed node output URLs, and node or invocation failure details for a Runway workflow invocation.

List Documents

List Runway knowledge documents one page at a time, with sorting and an opaque continuation cursor.

List Workflows

List the connected account's published Runway workflows and their available versions, ordered as returned by Runway.

Run Workflow

Invoke a published Runway workflow, optionally overriding graph node outputs, and return the created workflow invocation ID.

Transform Video

Transform or restyle an existing video with Runway and return the created task ID and estimated credit cost.

Update Document

Change the name, content, or both for an existing Runway knowledge document.

Upscale Image

Start a Runway image upscaling task and return its task ID and estimated credit cost.

Upscale Video

Start a Runway video upscaling task and return its task ID and estimated credit cost.

SETUP GUIDE

Connect Runway MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK for Python or TypeScript
2

Initialize Client and Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
Import and initialize the Composio client, then create a Tool Router session for Runway
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'Create a Runway image-to-video animation from my product photo'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent (Anthropic Claude or Mastra)
SETUP GUIDE

Connect Runway API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Runway Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Generate a 5-second Runway video of a futuristic city skyline at sunset'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Runway actions with your Agent

Why Use Composio?

AI Native Runway Integration

  • Supports both Runway MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable video, image, audio, and media workflow execution
  • Rich coverage for generating, transforming, and querying Runway media jobs without custom glue code

Managed Auth

  • Bring your own Runway API key and keep it out of agent prompts and app code
  • Use auth_configs.create() and connected_accounts.link() to manage Runway credentials per user or environment
  • Composio handles secure credential storage and API request handling for Runway actions

Agent Optimized Design

  • Runway tools are exposed with clear schemas that language models can understand and call correctly
  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know which Runway job ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Runway
  • Scoped, least privilege access to Runway media generation and transformation workflows
  • Full audit trail of agent actions to support review, billing checks, and compliance
FAQ

Frequently asked questions

Yes, Runway requires you to configure your own API key. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with Runway.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Runway tool your agent needs.Free to start.

Start building