Skip to content

Latest commit

 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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-PDeveloper: 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

License

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

About

Runway plugin for Cursor, Grok Bot, and Grok Build: generate images, video, and audio via Runway's hosted MCP server.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors