How to Use the Frame.io MCP in Mastra AI

Automate video production pipelines in Mastra AI. Handle asset tracking and review loops with resilient, agentic workflows.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Frame.io MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Resilient asset workflows in Mastra AI

Build agentic steps that check for new footage using `list_assets`. If the agent hits a rate limit, the framework handles the retry logic for you automatically. This keeps your production pipeline moving. You define the logic, and the agent executes `get_project_details` to ensure every file is placed in the correct folder.

Automated comment loops for Mastra AI

Trigger `add_comment` based on your own internal QA logic. It’s perfect for flagging technical issues like audio levels or color shifts without human intervention. Your agents can pull existing feedback using `list_asset_comments` to avoid duplicate work. It creates a closed loop that keeps the creative team focused on the edit.

Multi-step project management in Mastra AI

Chain `list_teams`, `list_projects`, and `list_folders` to map out your entire studio hierarchy. The framework tracks state across these calls, ensuring your agent never loses its place. It makes complex task delegation simple. You can branch your workflow if a project is missing assets, ensuring no production stage goes unmonitored.

Setup guide

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

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

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

Install the MCP client package and define your server URL in the Mastra configuration. The framework auto-detects the tools and makes them available to your agents.

Yes, by using the human-in-the-loop setting. You can require approval before the agent executes `add_comment` on an asset.

It is. The framework includes built-in retries and exponential backoff, which prevents failures when polling for data across large projects.

Define which tools your agent needs in the agent config. You don't have to expose the entire API surface if you only need a few specific actions.

We isolate your project and asset data in a V8-powered sandbox. No external process can touch your Frame.io login information or session details.

Use it with your favorite AI tools

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