How to Use the Vidyard MCP in Mastra AI

Q: How do I list all Vidyard players using Mastra AI?

You just call the listvideoplayers tool. The agent takes that comprehensive list and lets you build conditional logic around it—like only updating players marked 'draft'.

Q: Can I use Vidyard with Mastra AI to delete assets?

Absolutely. You can set up a workflow that executes deletevideoasset or deletevideoplayer, ensuring the irreversible actions happen only when all upstream checks pass.

Q: When running Vidyard processes with Mastra AI, are original video sources safe?

Yes. The tools are designed so that deleting a player (deletevideoplayer) doesn't delete the actual source media; it just removes the viewing container.

Build resilient Vidyard automation workflows with Mastra AI's advanced agent framework.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Vidyard MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Orchestrate Asset Management Workflows

Mastra AI can build a workflow that first calls `list_videos` to find the right asset. Then, it uses `get_video_details` to check the metadata before finally calling `attach_video_to_player`. This sequence handles complex dependencies. If the video needs updating, a later step in the workflow can call `update_player_name` on the target player container.

Secure Video Player Lifecycle Management

Need to clean up old containers? A Mastra AI agent can run a sequence: first, it lists players using `list_video_players`. Then, if a player is obsolete, the workflow executes `delete_video_player`. It handles failures gracefully. If the delete command fails due to permissions, the workflow retries with backoff instead of stopping.

Retrieving Media Streams and Details

To get high-quality streams, the agent uses `get_video_source_files` to pull direct URLs for 720p or 480p. This is a key step in any video distribution workflow. For simple checks, it runs `get_player_details` on a specific ID, getting all necessary info before deciding if the asset needs linking via `attach_video_to_player`.

Setup guide

Set up Vidyard 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 Vidyard 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: "vidyard-mcp-client",
  servers: {
    "vidyard-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent Vidyard 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 Vidyard. 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 Vidyard 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 Vidyard MCP in Mastra AI

Yes. The framework's built-in engine automatically handles retries with exponential backoff if an operation fails, making your process resilient.

You just call the `list_video_players` tool. The agent takes that comprehensive list and lets you build conditional logic around it—like only updating players marked 'draft'.

This server touches technical video metadata, asset IDs, player container names, and stream URLs. It's all structured, machine-readable data.

Absolutely. You can set up a workflow that executes `delete_video_asset` or `delete_video_player`, ensuring the irreversible actions happen only when all upstream checks pass.

Yes. The tools are designed so that deleting a player (`delete_video_player`) doesn't delete the actual source media; it just removes the viewing container.

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