How to Use the Mux MCP in Windsurf

Q: How do I connect the Mux MCP server to Windsurf?

Open your /.codeium/windsurf/mcpconfig.json file and add the server configuration under the mcpServers key. Alternatively, go to Settings, select Cascade, and use the MCP Servers UI to add the endpoint.

Q: Can Windsurf Cascade chain Mux video uploads automatically?

Yes, Cascade uses createdirectupload to get a signed URL and then monitors the process. It will automatically run listdirectuploads to confirm when the file is ready.

Q: How does Windsurf handle live stream creation with Mux?

Cascade invokes createlivestream to provision the RTMP endpoint. It then grabs the stream key and injects it directly into your project environment variables.

Q: What tool do I use to track video performance?

Use getrecentviews to fetch real-time viewing data. This gives you raw analytics on video performance directly inside your development workspace.

Build video workflows autonomously in Windsurf using the Mux MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Mux MCP to Windsurf

Create your Vinkius account to connect Mux to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Mux with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run live broadcasts via Cascade autonomous chains

`create_live_stream` starts a new broadcast channel instantly without you writing boilerplate API calls. Windsurf's Cascade agent takes your goal, sets up the ingest endpoints, and retrieves the stream keys in one continuous execution loop. Cascade doesn't stop at creation. It automatically chains `get_live_stream` to verify the stream status and pipes the ingestion details straight into your frontend code configuration.

Automate file ingestion and status checks

The `create_direct_upload` tool generates secure upload URLs for user-generated content using this MCP Server. Cascade plans the upload sequence, runs it, and then triggers `list_direct_uploads` to track the state of the transfer. Once the file hits the servers, Cascade calls `list_assets` to confirm the file is ready for playback. You get a fully functional upload pipeline without writing a single line of state-checking logic yourself.

Clean up dead media assets without leaving Windsurf

`delete_asset` removes expired video files directly from your workspace when Cascade identifies unused resources. The agent scans your database, finds orphaned IDs, and purges them from your account. This MCP server connection lets Windsurf also run `delete_live_stream` on old testing endpoints. You keep your active environment clean and your monthly bill predictable without manual dashboard cleanup.

Setup guide

Set up Mux MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Mux MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Mux payment history." If connected, Cascade will call the Mux tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "mux-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Mux. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Mux now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Mux MCP in Windsurf

Open your ~/.codeium/windsurf/mcp_config.json file and add the server configuration under the mcpServers key. Alternatively, go to Settings, select Cascade, and use the MCP Servers UI to add the endpoint.

Yes, Cascade uses `create_direct_upload` to get a signed URL and then monitors the process. It will automatically run `list_direct_uploads` to confirm when the file is ready.

Cascade invokes `create_live_stream` to provision the RTMP endpoint. It then grabs the stream key and injects it directly into your project environment variables.

Use `get_recent_views` to fetch real-time viewing data. This gives you raw analytics on video performance directly inside your development workspace.

Your API tokens stay inside Windsurf's local environment and are never stored on external logging servers. This MCP integration only passes command payloads to manage video assets and live stream metadata, keeping your raw video content and credentials isolated.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript