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:

Claude Desktop

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": {}
    }
  }
}

Cursor

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>"
      }
    }
  }
}

VSCode

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}"
      ]
    }
  }
}

Zed

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": {}
  }
}

Example usage

You can get an overview of the different Runway MCP tools available by asking your agent:

You can ask for the details of any release, without necessarily knowing or specifying the exact version number:

You can make changes to progress any release, e.g. updating regression testing status: