About Runway API MCP Server
Runway API MCP Server is an MCP server published by runwayml in the Developer Tools category.
The repository has 23 stars and 13 forks, with the last commit 28 days ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/runwayml/runway-api-mcp-serverThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (4)
runway_cancelTaskDeletes or cancels a given task.
Parameters not published.
runway_generateAudioGenerate spoken audio (text-to-speech) from text. Returns IMMEDIATELY with status PENDING and a taskId — does NOT wait for completion. Poll with runway_getTask(taskId) after ~15-30s; never re-submit on host timeouts. Default model is `seed_audio`; `eleven_multilingual_v2` requires a `voice`. Call runway_listModels for audio models.
Parameters not published.
runway_getOrgReturns details like credit balance, usage details, and organization information.
Parameters not published.
runway_listModelsLists the available Runway models for each generation capability (image, video,
Parameters not published.
Ask AI
Ask AI about Runway API MCP Server
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
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 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 installin the folder, thennpm run build. You should now see a new folder calledbuildwith aindex.jsfile 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-serverto 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-serverin Claude's tools:
- 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.
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.