Runway API MCP Server

This repository holds the code for a MCP server that calls the Runway API.

Tools

The following tools are available in this MCP:

Tool Name	Description	Parameters
`runway_generateVideo`	Generates a video from an image and a text prompt	- promptImage - promptText (optional) - ratio - duration
`runway_generateImage`	Generates an image from a text prompt, and reference images	- promptText - referenceImages (note that uploaded images won't work as references, only previously generated ones, or URLs to images will work.) - ratio
`runway_upscaleVideo`	Upscale a video to a higher resolution	- videoUri
`runway_editVideo`	Edits a video, optionally provide reference images.	- videoUri, referenceImages, promptText
`runway_getTask`	Gets the details of a task	- taskId
`runway_cancelTask`	Cancels or deletes a task	- taskId
`runway_getOrg`	Get organization information

Prerequisites

Before starting, you'll need to have setup your Developer account on the Runway API, setup Billing, and also created an API Key.

You'll also need Node.js setup.

Setup

Clone this repository and save it to a folder on your computer. Remember where you saved this folder because you'll need it in a later step.
Run npm install in the folder, then npm run build. You should now see a new folder called build with a index.js file inside.

Using the MCP with Claude Desktop

Follow the MCP quickstart instructions to setup a config file for Claude. If you already have it, open it by running:

MacOS

open ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows

notepad %APPDATA%\Claude\claude_desktop_config.json

Add the runway-api-mcp-server to the config, make sure to replace the file path and Runway API key.

{ "mcpServers": { "runway-api-mcp-server": { "command": "node", "args": [ "<ABSOLUTE_PATH_TO_YOUR_CLONED_REPO_FROM_STEP_1>/build/index.js" ], "env": { "RUNWAYML_API_SECRET": "<YOUR_RUNWAY_API_KEY_HERE>", "MCP_TOOL_TIMEOUT": "1000000" } } } }

Now restart Claude Desktop, and you should see the runway-api-mcp-server in Claude's tools:

Runway MCP Server Screenshot

Now, try asking Claude to generate images or videos!

NOTE

Images generated by the Runway API lives only for 24 hours at the generated link. There is no way to recover them after this link expires. Make sure to download the images before they expire.

Deploy Server

HTTP connection URL

A

security – no known vulnerabilities

-

license - not tested

A

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Enables AI video and image generation through the Runway API. Supports video generation from images and text prompts, image creation, video upscaling and editing, and task management.

Runway API MCP Server

Runway API MCP Server

Tools

Prerequisites

Setup

Using the MCP with Claude Desktop

Tools

New MCP Servers

MCP directory API