Mux
FreeNot checkedEnables AI agents to interact with Mux video infrastructure, providing tools for fetching video assets, clipping videos into shorts, monitoring live streams, pu
About
Enables AI agents to interact with Mux video infrastructure, providing tools for fetching video assets, clipping videos into shorts, monitoring live streams, pulling viewer analytics, and generating auto-captions.
README
MCP server for Mux, the video infrastructure platform. 5 tools for fetching assets, clipping videos into shorts, monitoring live streams, pulling viewer analytics, and triggering auto-captions. Built for AI agents working with video content.
As of May 2026, Mux has an official Node SDK MCP and there are a few small community attempts, but no production-ready Python MCP server lives at this address. This is the community-built rail to fill that gap on the Python side.
The 5 tools
| Tool | Purpose |
|---|---|
get_asset |
Fetch a video asset's metadata, duration, status, and playback URLs |
create_clip |
Clip a long video at start and end timestamps to make a short |
list_live_streams |
List live streams with their current state (active, idle, disconnected) |
get_video_metrics |
Pull engagement and quality metrics from Mux Data (views, error rate, rebuffer percentage) |
trigger_transcription |
Generate auto-captions for a video asset in a target language |
Install
pip install mux-mcp
Configure
export MUX_TOKEN_ID="your-mux-token-id"
export MUX_TOKEN_SECRET="your-mux-token-secret"
Get a Mux Token ID + Secret at dashboard.mux.com. Tokens scope to Video, Data, or both. The MCP server uses HTTP Basic Auth: it base64-encodes MUX_TOKEN_ID:MUX_TOKEN_SECRET and sends it as the Authorization header on every request.
Use with Claude Desktop
{
"mcpServers": {
"mux": {
"command": "mux-mcp",
"env": {
"MUX_TOKEN_ID": "your-mux-token-id",
"MUX_TOKEN_SECRET": "your-mux-token-secret"
}
}
}
}
Restart Claude Desktop. The 5 Mux tools are now available.
Use case: AI video editor + analytics assistant
Typical agent flow:
- Call
get_asset(asset_id)to pull a long-form video's metadata + duration - Call
create_clip(source_asset_id, start_time, end_time)to cut a short from the source at specific timestamps - Call
trigger_transcription(asset_id, language_code)to auto-generate captions on the new clip - For live operations:
list_live_streams(status="active")to find active broadcasts - For analytics:
get_video_metrics(metric_id="video_views", video_id=...)to pull engagement on a specific video
Architecture
- Public MIT-licensed wrapper around the Mux REST API
- Async HTTP via
httpx - pydantic v2 input validation
- HTTP Basic Auth (base64-encoded token ID + secret), server-side only
- Separates Mux Video endpoints (assets, live streams, tracks) from Mux Data endpoints (metrics)
- Rate-limit aware (429 returns a clean error, agent retries upstream)
Security note
Mux API endpoints do not support CORS. Requests must run server-side. This MCP keeps the token secret vaulted in environment variables and never exposes them to client code or agent context.
Development
git clone https://github.com/NoBanks/mux-mcp.git
cd mux-mcp
pip install -e ".[dev]"
pytest
License
MIT. See LICENSE.
Author
Ryan Hammer (NoBanks). Solo founder + engineer. Built this and 7 other MCP servers as part of a sprint to expose AI agent rails for the products and platforms shipping daily.
- GitHub: @NoBanks
- X/Twitter: @livingagentic
- Site: livingagentic.me, nohumannearby.com
Open to AI engineering roles, contract or full-time, remote-only.
Install Mux in Claude Desktop, Claude Code & Cursor
unyly install mux-mcpInstalls into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.
First time? Get the CLI: curl -fsSL https://unyly.org/install | sh
Or configure manually
Run in your terminal:
claude mcp add mux-mcp -- uvx --from git+https://github.com/NoBanks/mux-mcp mux-mcpFAQ
Is Mux MCP free?
Yes, Mux MCP is free — one-click install via Unyly at no cost.
Does Mux need an API key?
No, Mux runs without API keys or environment variables.
Is Mux hosted or self-hosted?
A hosted option is available: Unyly runs the server in the cloud, no local setup required.
How do I install Mux in Claude Desktop, Claude Code or Cursor?
Open Mux on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
Omni Video
An MCP server that transforms LLM-enabled IDEs into professional video editors by pre-processing footage into text proxies, generating motion graphics via HTML/
by buildwithtazaARA
Generate images, video and audio from any AI agent — one connector.
by ARAYouTube
Transcripts, channel stats, search
by YouTubeEverArt
AI image generation using various models.
by modelcontextprotocolCompare Mux with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All media MCPs
