Runway MCP Server
Connect Runway to your AI agents with the Runway MCP server.
Updated
What is Runway MCP?
The Runway MCP server is a Model Context Protocol server that connects Runway to AI agents and assistants as a set of tools. With it connected, an agent can work with Runway (ai video and image generation from text and prompts) directly — instead of you copying data in and out by hand.
It is a remote MCP server that uses OAuth, so you point your client at the server URL, authorize once, and the Runway tools become available to the model.
Connect the Runway MCP server
Connect Runway MCP to Claude Code
- 1
Add the server
Use `claude mcp add` with the Runway MCP server URL (or its `npx` command), following the official docs.
- 2
Authorize
Complete authentication (OAuth) so Claude Code can call the server.
- 3
Verify
Ask Claude to use a Runway tool to confirm the connection is live.
Connect Runway MCP to Cursor
- 1
Open MCP settings
In Cursor, go to Settings → MCP → Add new server.
- 2
Add Runway
Provide the Runway MCP server URL or command and complete authentication.
- 3
Test
Reference Runway from chat to confirm Cursor can reach the tools.
Sample use cases
A content agent generates video clips from text prompts for social media
It submits generation requests to Runway, polls for completion, downloads the output, and uploads the clips to the content library.
A brand agent creates product demo videos from screenshots
It uses image-to-video generation to animate static product shots into short motion clips for landing pages and ads.
A batch processing agent handles a queue of video generation requests
It manages rate limits, retries failed generations, tracks credit usage, and notifies the team when the batch is complete.
A creative review agent organizes generated video variants
It generates multiple versions of a scene with different prompts, arranges them in a comparison sheet, and routes the options to the creative director for approval.
A marketing agent produces weekly social video content
It reads the content calendar, generates video clips matching each post's theme, applies brand-consistent style prompts, and queues them for scheduling.
An ad creative agent tests video variations for performance campaigns
It generates multiple ad creatives from a single brief, uploads them to the ad platform, and monitors which variants drive the best engagement.
A training content agent creates explainer video segments
It converts documentation sections into visual walkthroughs using Runway's generation models, producing short clips for each step in a tutorial.
Using Runway MCP with Gamut
On Gamut, the Runway MCP server becomes a tool your agents use inside an automated, event-driven workflow — triggered by an event or a schedule, acting through Runway and your other connected MCP servers, with the connection managed by Gamut rather than a local config file.
Frequently asked questions
What is the Runway MCP server?
It is a Model Context Protocol server that exposes Runway to AI agents as tools so they can work with it (ai video and image generation from text and prompts).
How do I connect the Runway MCP server?
Point your MCP client (Claude, Cursor, or Gamut) at the Runway MCP server URL and complete authentication (OAuth). See the official documentation for the exact URL and scopes.
Can I use Runway MCP with Gamut?
Yes — Gamut supports the Runway MCP server, so your agents can use it as a tool in automated, triggered workflows.
What video generation models does the Runway MCP support?
The MCP server works with Runway's latest generation models including Gen-3 Alpha for text-to-video and image-to-video. Available models depend on your Runway plan and API access tier.
How long does a Runway video generation take through the MCP?
Generation times vary by model and video length, typically 30 seconds to a few minutes per clip. The MCP server supports async polling so agents can handle other tasks while waiting.
Does the Runway MCP charge separately from Runway credits?
No. Video generations through the MCP consume your standard Runway credits at the same rate as the web interface or direct API. The MCP adds no additional fees.
Can an agent control video resolution and aspect ratio?
Yes. The MCP server exposes parameters for resolution, aspect ratio, and duration that Runway's API supports, letting agents generate content sized for specific platforms.