runway-api-mcp-server

runwayml/runway-api-mcp-server

3.3

If you are the rightful owner of runway-api-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This document provides a comprehensive overview of the Runway API MCP Server, detailing its features, tools, resources, and usage instructions.

Tools

  1. runway_generateVideo

    Generates a video from an image and a text prompt.

  2. runway_generateImage

    Generates an image from a text prompt and reference images.

  3. runway_upscaleVideo

    Upscale a video to a higher resolution.

  4. runway_getTask

    Gets the details of a task.

  5. runway_cancelTask

    Cancels or deletes a task.

  6. runway_getOrg

    Get organization information.

Demo

Video sped up for demo purposes

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 NameDescriptionParameters
runway_generateVideoGenerates a video from an image and a text prompt- promptImage
- promptText (optional)
- ratio
- duration
runway_generateImageGenerates 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_upscaleVideoUpscale a video to a higher resolution- videoUri
runway_getTaskGets the details of a task- taskId
runway_cancelTaskCancels or deletes a task- taskId
runway_getOrgGet 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

  1. 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.

  2. 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

  1. 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
  1. 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"
      }
    }
  }
}
  1. Now restart Claude Desktop, and you should see the runway-api-mcp-server in Claude's tools:

Runway MCP Server Screenshot

  1. 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.