The Runway MCP (Model Context Protocol) brings the power of generative media into Claude, ChatGPT, and other LLM agents. With the Runway MCP connection set up in your LLM of choice, you can generate videos and images directly in your chats and agent workflows — no need to switch between apps. Every image or video your assistant generates through MCP uses credits from your Runway account, the same way it would in the Runway app.
This guide covers how to connect Runway to supported AI apps, tips to keep control of when your assistant uses credits, and answers common questions about billing, models, and setup.
Connecting through a company or enterprise account
Many AI apps let workspace admins control who can add custom connectors, so the option to add one may not appear for you. Ask your workspace admin to add Runway with the name Runway and the URL https://mcp.runwayml.com/mcp. Once it's added, connect and sign in to your Runway account as usual.
Setting up Runway MCP
You can connect Runway to any app that supports MCP. Below are setup instructions for connecting to specific apps:
Connect to Claude
On a Claude Team or Enterprise plan
You'll need to ask your workspace admin to add Runway with the name Runway and the URL https://mcp.runwayml.com/mcp. Once it's added, follow Anthropic's steps for Team and Enterprise plans to connect and sign in to your Runway account.
On a personal plan
- Go to https://claude.ai/, or open the desktop app. Tip: this link takes you straight to the add connector window, skipping steps 2 and 3: claude.ai/customize/connectors?modal=add-custom-connector.
-
Select Customize in the sidebar, and choose
Connectors.
-
Select Add in the top right corner.
-
Enter Runway as the name, paste the link
https://mcp.runwayml.com/mcp,
and select Continue.
- Select Connect, and Sign in to your Runway account. You should see Runway listed under your Connectors.
Connect to ChatGPT
- Go to https://chatgpt.com/plugins and search for Runway. You can also open the Runway plugin page directly.
- Select Install Plugin, then Sign in with Runway to connect your Runway account.
- Mention @Runway in any chat and describe the image or video you want. Attach a reference image if you have one.
Connect to Grok Bot
- Download and install Grok Bot from x.ai if you don't have it yet.
- Select Marketplace at the bottom of the sidebar. With Plugins selected, search for Runway and select Add. You can also open Runway for Grok Bot and select Add to Grok Bot.
- Select Authenticate and sign in with your Runway account.
- Ask your bot for an image or video. It picks the right Runway tool for the request, or you can name a model.
Connect to Cursor
Setup
- In the Cursor chat, type /add-plugin, search for Runway and install it. You can also open Runway in the Cursor Marketplace and select Add to Cursor.
- Press Cmd+Shift+J (Mac) or Ctrl+Shift+J (Windows) to open Settings, then select Tools & MCPs. You should see runway listed.
- Select Connect, and Sign in to your Runway account.
- Approve access and you'll be redirected back to Cursor. You should now see the available Runway tools under Tools & MCPs.
Manual setup
If your team manages MCP servers in a config file, you can add Runway without the plugin:
-
Open Settings, select Tools & MCPs and click
+ new MCP server. This opens
~/.cursor/mcp.json. -
Paste or merge the following into your mcpServers:
"Runway": { "url": "https://mcp.runwayml.com/mcp" } - Save the file, then select Connect next to runway and Sign in to your Runway account.
Troubleshooting
- If Runway is not connecting, press Cmd+Shift+U (Mac) or Ctrl+Shift+U (Windows) to open MCP Logs for the error.
- If you need to re-auth, open Tools & MCPs and click the refresh icon next to runway.
Connect to Replit
- Go to https://replit.com/.
-
Select Integrations and choose
Add MCP Server.
-
Name the server Runway and paste in the link
https://mcp.runwayml.com/mcp.
-
Select Trust and Save, and click
Authorize Server to sign in with your Runway account.
Approving generations before they use credits
Your app decides when to call Runway using the MCP, and each generation it starts uses credits — including retries and regenerations. Below are two ways to approve generations before credits are used.
Ask your app to check with you first
Tell your app in the chat, for example: “Always ask me before you start any generation with Runway.” The assistant will then describe what it plans to generate and wait for your approval.
Set the Runway plugin permission in ChatGPT
Some apps like ChatGPT have a permission setting for each plugin. The default, Allow low-risk tools, lets ChatGPT start Runway generations without asking you. To be asked every time:
- Open the Runway plugin permissions in your ChatGPT settings (Plugin settings → Runway → Permissions)
- Select Always ask
Other apps have their own settings for when tools can run without asking. Check your app’s documentation for how to require approval before a tool runs.
Runway MCP FAQ
Does Runway MCP support SSE connections?
Runway MCP currently only supports Streamable HTTP, not SSE or stdio.
Trying to use SSE connections will return a 405 error. If
your client settings let you set the transport type, choose
HTTP or Streamable HTTP.
What agents and tools can connect to Runway MCP?
Any LLM or agent that supports MCP will work — including Claude, ChatGPT, Cursor, and Replit. Using a different tool? Review its documentation to see if it supports MCP.
Can I use Unlimited Mode or Explore Mode with Runway MCP?
No. Runway MCP only supports Credits Mode, so every generation your assistant runs through MCP uses credits — including on Pro and Max plans that have Unlimited Mode, and on legacy Unlimited plans with Explore Mode. A generation that is free in Unlimited Mode in the Runway app, such as an upscale, still costs credits when it runs through MCP. To generate without using credits, use Unlimited Mode in the Runway app.
Which models can agents use?
Your agent can use models like Seedance 2.0, Kling, Gen-4.5, Veo, GPT image 2, Nano Banana Pro and more based on your Runway account plan. It can pick a model for you, or you can ask for a specific one.
How are MCP generations billed?
MCP uses your Runway credits, just like the Runway app. Each video or image your assistant generates through MCP draws from your account’s credit balance, and credits are charged when the generation runs. Retries and regenerations are separate generations and each one uses credits. The cost depends on the model, resolution, and other settings — see our credits guide for more details.
Is an API key required?
You don’t need an API key. Just add the Runway MCP URL to your agent settings. Then sign in with your Runway app account.