How to Use the Frame.io MCP in Windsurf

Q: How do I connect the Frame.io MCP Server to Windsurf?

Open your /.codeium/windsurf/mcpconfig.json file and add the server under the mcpServers key. Cascade will automatically discover the tools like listprojects and addcomment once you reload the MCP panel.

Q: Can Cascade post comments to Frame.io assets in Windsurf?

Yes, Cascade uses addcomment to post feedback directly to specific video timestamps. You just tell the agent what to write, and it executes the API call in the background.

Q: Can I list active review links from Windsurf?

Yes, the agent calls listreviewlinks to fetch all active URLs for a project. It displays them directly in your chat interface so you can share them instantly.

Let Cascade chain your Frame.io review loops, pull asset data, and post timestamped comments autonomously inside Windsurf.

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 Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Cascade chains asset inspection and feedback loops

`get_asset_details` gives Cascade direct access to your Frame.io video files and metadata. Tell the agent to grab a specific asset, and it will read the frame rate, file size, and upload status without you clicking through the web app. Once it has the details, Cascade can immediately call `list_asset_comments` to scan for unresolved feedback. It looks at the timeline, finds where the editor left off, and prepares the next steps in your workspace.

Autonomous review link generation

`list_review_links` lets your Cascade agent track active review URLs and compile progress reports for clients. You don't have to open a browser to see who has access to the latest cut. The agent chains this with `list_collaborators` to verify which team members are assigned to the review. It runs the entire audit trail in one go, updating your local project files with the current reviewer list.

Direct project mapping via the Windsurf MCP Server

`list_projects` acts as the entry point for Cascade to map out your entire active Frame.io team workspace. The agent pulls the project list and matches it against your local git branches or directories. It then uses `list_folders` and `list_assets` to sync your local video exports with remote folders. Cascade handles the mapping sequence from team selection to folder verification autonomously.

Setup guide

Set up Frame.io 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 Frame.io 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 Frame.io payment history." If connected, Cascade will call the Frame.io tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "frameio-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 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 Windsurf

Open your `~/.codeium/windsurf/mcp_config.json` file and add the server under the `mcpServers` key. Cascade will automatically discover the tools like `list_projects` and `add_comment` once you reload the MCP panel.

Yes, Cascade uses `add_comment` to post feedback directly to specific video timestamps. You just tell the agent what to write, and it executes the API call in the background.

Windsurf manages tool execution sequentially, meaning Cascade won't spam `list_assets` or `get_asset_details` simultaneously. It executes each call in a controlled chain to respect API limits.

Yes, the agent calls `list_review_links` to fetch all active URLs for a project. It displays them directly in your chat interface so you can share them instantly.

Your developer token is stored locally on your machine and never leaves your environment. When Windsurf calls tools like `get_my_profile` to verify your identity, the MCP server passes the token securely to the endpoint via an isolated V8 sandbox.

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