How to Use the Mux MCP in Mastra AI

Q: How do I configure the Mux MCP Server in a Mastra AI project?

Install @mastra/mcp. Initialize a new MCPClient() with your Vinkius server URL. Mastra auto-detects the transport layer. Call listTools() and spread them into your agent's tool array.

Q: Can Mastra AI retry a failed Mux asset creation?

Yes. If the API rejects a createasset request, Mastra's workflow engine catches the error and retries the tool call based on your configured backoff schedule.

Q: How do I clean up stale Mux live streams automatically?

Build a workflow that runs listlivestreams to find active broadcasts. You program the agent to check the duration and execute deletelivestream on anything older than 24 hours.

Q: Does Mastra AI require human approval for Mux deletions?

You can use Mastra's requireToolApproval setting for destructive actions. The workflow pauses and waits for a human before executing deleteasset or deletelivestream.

Build resilient video workflows in Mastra AI to handle Mux ingest, processing, and stream teardowns automatically via this 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 Mastra AI

Create your Vinkius account to connect Mux to Mastra AI 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 Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated Video Ingest Workflows

Video processing fails. Networks drop. Files corrupt. Mastra AI handles these realities by wrapping Mux operations in resilient MCP workflows. Your agent runs `list_direct_uploads` to find pending files, then triggers `create_asset` to start transcoding. If the API hits a rate limit, Mastra's built-in exponential backoff kicks in. The agent retries the tool call automatically. You get finished video assets without writing custom error-handling logic.

Conditional Live Stream Management

Live streaming requires strict lifecycle management. You don't want to pay for idle streams. A Mastra workflow can call `create_live_stream` for an event, monitor its status, and conditionally execute `delete_live_stream` when the broadcast ends. You define the logic. If the stream disconnects unexpectedly, the agent checks the state with `get_live_stream` and decides whether to wait or tear down the infrastructure immediately.

Mastra AI MCP Server Analytics Fetching

Pulling metrics across a massive media library takes time. This integration lets you build an async job that iterates through your catalog. The agent runs `list_assets` to grab IDs, then loops through `get_recent_views`. You pipe this data into a reporting database or send a Slack alert. The workflow engine manages the state, so if the job fails halfway through, it resumes exactly where it left off.

Setup guide

Set up Mux MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Mux tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "mux-mcp-client",
  servers: {
    "mux-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Mux Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Mux tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Mux transactions"
);
console.log(result.text);

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 Mastra AI

Install `@mastra/mcp`. Initialize a `new MCPClient()` with your Vinkius server URL. Mastra auto-detects the transport layer. Call `listTools()` and spread them into your agent's tool array.

Yes. If the API rejects a `create_asset` request, Mastra's workflow engine catches the error and retries the tool call based on your configured backoff schedule.

Build a workflow that runs `list_live_streams` to find active broadcasts. You program the agent to check the duration and execute `delete_live_stream` on anything older than 24 hours.

You can use Mastra's `requireToolApproval` setting for destructive actions. The workflow pauses and waits for a human before executing `delete_asset` or `delete_live_stream`.

Your viewer metrics and video playback IDs remain strictly between your Mastra environment and the MCP Server. Vinkius operates a zero-trust sandbox that drops all state the moment the session closes.

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