Skip to main content

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

  1. 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.
  2. Select Customize in the sidebar, and choose Connectors.
    Customize option in the Claude sidebar
  3. Select Add in the top right corner.
    Connectors tab on Claude's Customize page with the Add button in the top right
  4. Enter Runway as the name, paste the link https://mcp.runwayml.com/mcp, and select Continue.
    Add custom connector window in Claude with the Runway name and URL entered
  5. Select Connect, and Sign in to your Runway account. You should see Runway listed under your Connectors.

 

Connect to ChatGPT
  1. Go to https://chatgpt.com/plugins and search for Runway. You can also open the Runway plugin page directly.
  2. Select Install Plugin, then Sign in with Runway to connect your Runway account.
  3. 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

  1. Download and install Grok Bot from x.ai if you don't have it yet.
  2. 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.
  3. Select Authenticate and sign in with your Runway account.
  4. 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

  1. 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.
  2. Press Cmd+Shift+J (Mac) or Ctrl+Shift+J (Windows) to open Settings, then select Tools & MCPs. You should see runway listed.
  3. Select Connect, and Sign in to your Runway account.
  4. 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:

  1. Open Settings, select Tools & MCPs and click + new MCP server. This opens ~/.cursor/mcp.json.
  2. Paste or merge the following into your mcpServers:

    "Runway": {
      "url": "https://mcp.runwayml.com/mcp"
    }
  3. 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
  1. Go to https://replit.com/.
  2. Select Integrations and choose Add MCP Server.
    Add MCP Server option in Replit
  3. Name the server Runway and paste in the link https://mcp.runwayml.com/mcp.
    MCP server name and URL fields in Replit
  4. Select Trust and Save, and click Authorize Server to sign in with your Runway account.
    Trust and Save and Authorize Server buttons in Replit

 


 

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.