Runway MCP server

The Runway Model Context Protocol (MCP) server provides AI agents with access to your Runway instance. Through this integration, you can ask agents for information about your apps and releases, make updates to releases, interact with build and buckets in Build Distro, and manage your team and organization in Runway.

Getting started

Authentication

The Runway MCP server uses the same API key authentication as Runway's REST API. Access to the different MCP tools that are available is limited by an API key's scopes, similar to how REST API endpoints are limited. For detailed information about creating and managing API keys, including scoping and permissions, see Create an API key.

You'll pass your API key as a bearer authentication header:

Authorization: Bearer <YOUR_API_KEY>

Headers are typically defined among the arguments you set in your MCP server configuration (see below).

Configuration

Runway's MCP server is located at https://mcp.runway.team and it supports streamable HTTP transport. SSE transport may also be available upon request, but it is being deprecated by most agents.

Different agents will require somewhat different configuration, but we've included a few examples below:

Add the following to your claude_desktop_config.json file.

{
  "mcpServers": {
    "runway": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.runway.team",
        "--header",
        "Authorization: Bearer <YOUR_API_KEY>"
      ],
      "env": {}
    }
  }
}

Add or edit the .cursor/mcp.json file in your project or ~/.cursor/mcp.json in your home directory. Note that it's important to pass the Authorization header argument exactly as shown below, without a space after the colon.

{
  "mcpServers": {
    "runway": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.runway.team",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

Add or edit the .vscode/mcp.json file in your workspace.

{
  // 💡 Inputs are prompted on first server start, then stored securely by VS Code.
  "inputs": [
    {
      "type": "promptString",
      "id": "runway-key",
      "description": "Runway API Key",
      "password": true
    }
  ],
  "servers": {
    "Runway": {
      "type": "http",
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.runway.team",
        "--header",
        "Authorization: Bearer ${input:runway-key}"
      ]
    }
  }
}

Open the Agent Panel's Settings view and click 'Add Custom Server', or add an entry to the context_servers key in your settings.json config file. [Zed docs]

{
  "runway": {
    "command": "npx",
    "args": [
      "mcp-remote",
      "https://mcp.runway.team",
      "--header",
      "Authorization: Bearer <YOUR_API_KEY>"
    ],
    "env": {}
  }
}