# Runway MCP server

The Runway [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 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](https://docs.runway.team/overview#create-an-api-key "mention").

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:

{% tabs %}
{% tab title="Claude Desktop" %}
Add the following to your `claude_desktop_config.json` file.

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

{% endtab %}

{% tab title="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.

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

{% endtab %}

{% tab title="VSCode" %}
Add or edit the .`vscode/mcp.json` file in your workspace.

```json
{
  // 💡 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}"
      ]
    }
  }
}
```

{% endtab %}

{% tab title="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](https://zed.dev/docs/ai/mcp)]

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

{% endtab %}
{% endtabs %}

### Example usage

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

<figure><img src="https://727226624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MjFmyReUsbJqDjHEAlW%2Fuploads%2FrwpYNlw9d1LE2YdomDIu%2FScreenshot%202025-08-04%20at%2010.53.42.png?alt=media&#x26;token=1a90be7d-d131-42cd-8c38-b1b613c76eb7" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="https://727226624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MjFmyReUsbJqDjHEAlW%2Fuploads%2FAFbeerMUHiu0sTeIpkNZ%2FScreenshot%202025-08-04%20at%2010.05.59.png?alt=media&#x26;token=4f672425-9a5e-4b3f-a343-6af06b9ca8ee" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="https://727226624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MjFmyReUsbJqDjHEAlW%2Fuploads%2FFH3J5Sj3PvdRR6m5TJSf%2FScreenshot%202025-08-04%20at%2011.03.56.png?alt=media&#x26;token=4436f0e8-531f-4a12-9e3b-58bcefcae119" alt="" width="563"><figcaption></figcaption></figure>