# Mux MCP

> Lets your agent upload and manage videos and live streams, run Mux Robots jobs and query Mux Data, all in your Mux account.

Mux's own MCP server brings Mux Video, Mux Data and Mux Robots into your agent. Instead of hundreds of endpoint tools, it gives your agent two: search_docs, to look things up in Mux's API and SDK docs, and execute, where it writes TypeScript against the full Mux SDK (@mux/ts) and gets back whatever the code returns.

What you can do with it
- Upload videos and manage assets, playback IDs, subtitle tracks and live streams
- Get playback URLs and check the status of your assets
- Run Mux Robots jobs, such as generating chapters, or summarizing a video and suggesting tags
- Query Mux Data: views, performance metrics, errors, dimensions and filters
- Look up answers in Mux's API and SDK documentation
- Verify webhook payloads and manage signing keys

How it connects
Mux hosts it at https://mcp.mux.com. Agents that support OAuth sign you in to the Mux Dashboard and ask which environment to connect. Otherwise, create an access token in the Dashboard and send it as Basic credentials in the Authorization header. On the hosted server, each execute call runs in a fresh, isolated sandbox that can only reach Mux's API.

To run it yourself, use npx -y @mux/mcp@latest with MUX_TOKEN_ID and MUX_TOKEN_SECRET set. Locally, the code runs in a Deno sandbox on your machine (Deno 2.9 or newer). Claude Desktop can also install it from the mux.mcpb bundle in Mux's releases.

Read-only when you want it
What it can do follows the environment and access token you authorize, and it doesn't treat destructive operations specially. To make sure your agent can't change anything, connect with an access token that has only Read permissions. When you run it locally, --code-allow-http-gets limits it to read requests, and other flags allow or block specific SDK methods or turn off either tool.

- Type: Plugin
- Made by: Mux
- Category: Media
- Formats: Remote MCP, Local MCP
- Version: 12.8.0
- Website: https://www.mux.com/docs/integrations/mcp-server
- Source: https://github.com/muxinc/mux-node-sdk/tree/HEAD/packages/mcp-server
- Page: https://pluginboard.ai/plugins/mux-mcp

## Works with

- ChatGPT
- Claude
- Muse
- Grok Bot
- Gemini
- Grok
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- Replit
- OpenClaw
- OpenCode
- Hermes Agent

## Install

You'll need:

- `Authorization` (optional): Optional basic authorization header you can include, combining your Access Token and Secret using HTTP Basic Auth. If not provided, authorization will be handled via OAuth.

Replace each `<NAME>` placeholder with your own value.

### ChatGPT

In ChatGPT on the web: Plugins → + → Add custom MCP server, then paste https://mcp.mux.com under Connection. Business and Enterprise plans; Pro can add read-only servers.

### Claude

In Claude (web or desktop): Customize → Connectors → Add custom connector, then paste https://mcp.mux.com

### Muse

In Muse: In a Muse chat, ask it to create a custom connector for the MCP server at https://mcp.mux.com. Then tap Connect on the card it shows and sign in, or add your key.

### Grok Bot

In Grok Bot: In a chat with your Bot, say "Add this MCP server: https://mcp.mux.com". It confirms the details with you and sets it up, and the tools are ready from your next message.

### Gemini

In Gemini: At gemini.google.com: Settings → Connected Apps → Add a custom app, then paste https://mcp.mux.com

### Grok

In Grok on the web: At grok.com/connectors: New Connector → Custom, then enter https://mcp.mux.com and sign in if it asks.

### GitHub Copilot

Add to VS Code: vscode:mcp/install?%7B%22name%22%3A%22mux-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.mux.com%22%7D

Copilot CLI:

```shell
copilot mcp add --transport http mux-mcp https://mcp.mux.com
```

### Cursor

Add to Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=mux-mcp&config=eyJ1cmwiOiJodHRwczovL21jcC5tdXguY29tIn0%3D

Add to .cursor/mcp.json:

```json
{
  "mcpServers": {
    "mux-mcp": {
      "url": "https://mcp.mux.com"
    }
  }
}
```

### Claude Code

Run in your terminal:

```shell
claude mcp add --transport http mux-mcp https://mcp.mux.com
```

### Codex

Run in your terminal:

```shell
codex mcp add mux-mcp --url https://mcp.mux.com
```

### Antigravity

Add to ~/.gemini/config/mcp_config.json:

```json
{
  "mcpServers": {
    "mux-mcp": {
      "url": "https://mcp.mux.com"
    }
  }
}
```

### Gemini CLI

Run in your terminal:

```shell
gemini mcp add --transport http mux-mcp https://mcp.mux.com
```

### Replit

In Replit: At replit.com/integrations, open MCP Servers → + Add MCP server, paste https://mcp.mux.com (add any headers under Advanced settings), then click Test & save.

### OpenClaw

Run in your terminal:

```shell
openclaw mcp add mux-mcp --url https://mcp.mux.com --transport streamable-http
```

If it needs a key or sign-in: For https://mcp.mux.com, add --header NAME=value for each header it needs, or --auth oauth and then run openclaw mcp login mux-mcp.

### OpenCode

Run in your terminal:

```shell
opencode mcp add mux-mcp --url https://mcp.mux.com
```

If it needs a key: For https://mcp.mux.com, add --header 'NAME=value' for each header it needs. Add --global to use it in every project.

### Hermes Agent

Run in your terminal:

```shell
hermes mcp add mux-mcp --url https://mcp.mux.com
```

Add to ~/.hermes/config.yaml:

```json
{
  "mcp_servers": {
    "mux-mcp": {
      "url": "https://mcp.mux.com"
    }
  }
}
```

If it signs in with OAuth: If https://mcp.mux.com asks you to sign in, add --auth oauth to the command, or auth: oauth to its entry.

---
From Pluginboard (https://pluginboard.ai).