Runway API

by runwayml

Not rated
GitHub

About

Generate images and videos using the Runway API.

Details

Author
runwayml
Categories
Developer Tools, Other, AI

Setup

Install Runway API in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/runwayml/runway-api-mcp-server

Follow the installation instructions in the repository README, then restart your MCP client.

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

The following tools are available in this MCP:

Generation tools accept an optionalmodelparameter to override the recommended default. Recommended models: Nano Banana Pro (gemini_image3_pro) for images, Seedance (seedance2) for video, and Aleph (aleph2) for video editing. Validratio,duration, and other parameter values are model-specific, sorunway_listModelsreturns the exact valid values and required parameters for every model — call it before choosing aratio/duration.

Before any generation request is sent to the Runway API, the server validates the payload against OpenAPI-derived per-model constraints (allowed enums, numeric ranges, string lengths, required fields). Invalid payloads fail locally with a readable error and never hit the network.

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

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.

Runnpm installin the folder, thennpm run build. You should now see a new folder calledbuildwith aindex.jsfile inside. If you later modify any source files, runnpm run buildagain to pick up the changes.

Using the MCP as a Claude Desktop extension (recommended)

This installs the server as an unpacked Claude Desktop extension, so you don't have to edit any config files by hand.
-

Launch Claude Desktop and openSettings.

Go toExtensions, thenAdvanced Settings.

ClickInstall Unpacked Extensionand select the folder you cloned in step 1 (for example/Users/edwin/runway-api-mcp-server). ClickInstallon the prompt.

Get your API key fromhttps://dev.runwayml.com, paste it into the installed extension's settings, thenEnablethe extension.

Now, try asking Claude to generate an image!

Using the MCP with Claude Desktop (config file)

Alternatively, register the server manually through Claude's config file.
- Follow the
MCP quickstart instructionsto setup a config file for Claude. If you already have it, open it by running:

open ~/Library/Application\ Support/Claude/claude_desktop_config.json
notepad %APPDATA%\Claude\claude_desktop_config.json

- Add therunway-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 therunway-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.

The same code can run as an HTTP MCP server, which lets clients likeclaude.ai web, Cursor, Zed, and Windsurf connect to a single hosted URL instead of installing the extension locally.

RUNWAYML_API_SECRET=key_xxx npm run start:http # server listens on http://0.0.0.0:3000/mcp curl http://127.0.0.1:3000/healthz # → {"ok":true}

To test from web clients (claude.ai) without deploying, use a tunnel that returns HTTPS. Cloudflared works; ngrok is currently blocked by Anthropic's connector backend:

cloudflared tunnel --url http://127.0.0.1:3000

Use the printedhttps://<random>.trycloudflare.com/mcpas the connector URL.

Railwaydeploys the HTTP server with zero config.

npm i -g @railway/cli # one-time railway login railway init # create a new project, link this folder railway up # builds & deploys railway domain # provisions https://<your-app>.up.railway.app

Set environment variables in the Railway dashboard (orrailway variables):
- Settings → Connectors → Add custom connector
- URL:https://<your-app>.up.railway.app/mcp
- Leave OAuth fields blank (Bearer-key flow)

For public, multi-tenant hosting, every user supplies their own Runway API key:

curl -X POST https://<your-app>.up.railway.app/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "Authorization: Bearer <user_runway_key>" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

WhenREQUIRE_AUTH=true, requests without a Bearer header receive a 401. Bearer keys take priority overRUNWAYML_API_SECRETeven when both are set.

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

Server for advanced AI-driven video editing, semantic search, multilingual transcription, generative media, voice cloning, and content moderation.

Trim, watermark, extract audio from, and convert any video to 9:16 vertical — via REST API or MCP tools for Claude, Cursor, and other AI agents.

Generates AI images and videos using the GPT4O Image Generator API.

Generate and manipulate AI videos and images using Luma AI's Dream Machine API.

Interact with MiniMax's powerful APIs for text-to-speech, voice cloning, and video/image generation.

A JavaScript/TypeScript server for MiniMax MCP, offering image/video generation, text-to-speech, and voice cloning.

OpenAI-compatible MCP gateway for 787+ chat, image, and video models.

Interact with the RunwayML and Luma AI APIs for video and image generation tasks.

An MCP server for AI-powered video creation using the FAL AI API.

An MCP server for AI video generation. MCP server for AI video generation. Lets Claude, ChatGPT, OpenClaw , Hermes & other agents create AI videos and publish them to YouTube, TikTok, Instagram etc..

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.