runway-mcp-plugin

Runway plugin

Generate images, videos, music, speech, and sound effects with Runway from Cursor, Grok Bot, and Grok Build.

The plugin is a thin wrapper around Runway's hosted MCP server at https://mcp.runwayml.com/mcp. It adds a /runway command and two skills that teach the agent which Runway tool to use and how to handle uploads, async tasks, and credits. Sign in with your Runway account when prompted — no API key is needed; generations use your existing Runway plan.

Installation

Cursor

In Cursor, type /add-plugin in chat, search for Runway, and install it. Or install from the Cursor Marketplace.

Grok Bot

Open Plugins in the sidebar, search for Runway, click Add, and finish the Runway sign-in in your browser. Grok Bot installs plugins from the Cursor Marketplace; the same listing serves both.

Grok Build

grok plugin install runway --trust

Or add the server directly without the bundled skills:

grok mcp add --transport http runway https://mcp.runwayml.com/mcp

Any other MCP client

Add https://mcp.runwayml.com/mcp as a remote MCP server and sign in with Runway. See runway.com/mcp.

What's included

Path	Purpose
mcp.json / .mcp.json	Points at the hosted Runway MCP server (Cursor and Grok Build formats)
commands/runway.md	/runway <request> — routes a natural-language request to the right tool
skills/runway-media/SKILL.md	Single-shot image, video, and audio generation and editing
skills/runway-workflows/SKILL.md	Authoring and running multi-step Runway workflow graphs
.cursor-plugin/plugin.json	Cursor Plugin manifest
.grok-plugin/plugin.json	Grok Build plugin manifest

Network endpoints and credentials

For reviewers:

• The plugin makes no network calls itself. It configures the agent to talk to https://mcp.runwayml.com/mcp (Streamable HTTP).
• Authentication is OAuth 2.1 with PKCE and dynamic client registration, delegated to auth.runwayml.com. The user signs in with their Runway account in the browser. No API keys or secrets are stored in this repository or requested from the user.
• Tools that create media consume credits on the user's Runway plan and announce this in their descriptions. Purchases happen on runway.com, never in chat.
• No hooks, no shell commands, no bundled binaries.

Local development

Cursor scans ~/.cursor/plugins/local/<plugin-name>/ for local plugins:

git clone https://github.com/runwayml/runway-mcp-plugin.git
ln -s "$(pwd)/runway-mcp-plugin" ~/.cursor/plugins/local/runway

Reload Cursor (Cmd-Shift-P → Developer: Reload Window). Verify Customize → Plugins lists Runway and Customize → MCPs shows runway; the first connection prompts you to sign in.

For Grok Build, test the checkout as a local marketplace:

grok plugin marketplace add /absolute/path/to/runway-mcp-plugin
grok plugin install runway --trust

Uninstall

rm ~/.cursor/plugins/local/runway

then reload Cursor.

Support

• Help center: help.runwayml.com
• Issues: github.com/runwayml/runway-mcp-plugin/issues

License

MIT — see LICENSE. The plugin files are open source; the Runway MCP server and Runway models are governed by Runway's terms.