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.
This guide covers how to connect Runway to supported AI apps 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.
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 Explore Mode with Runway MCP?
Runway MCP only supports generating with credits. Explore Mode generations are not supported when using this connection.
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. Credits are consumed the same way they are in the web app — each video or image you generate through MCP draws from your account's credit balance. 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.