Connect your AI Agents to Frame.io in minutes
Available tools
list_accounts
List all Frame.io accounts the authenticated user has access to. Returns account IDs needed for other operations.
list_account_users
List users in a Frame.io account with their roles. Use to find team members and their permissions.
list_comments
List comments on a file. Includes timecoded video comments with timestamp positions. Supports pagination.
create_comment
Add a comment to a file. Set timestamp (frame number) to anchor the comment on the video timeline.
get_comment
Get details of a specific comment by ID.
update_comment
Update a comment's text or completion status.
delete_comment
Delete a comment permanently.
list_files
List files in a folder. Use list_projects to find root folder IDs, then list_folders to navigate. Supports pagination.
get_file
Get details of a specific file by ID, including download URLs (temporary, expire within 24h).
update_file
Update a file's name or properties.
delete_file
Delete a file permanently.
import_file
Import a file into a folder from a publicly accessible URL. The file is downloaded by Frame.io asynchronously; status starts as 'created' and progresses through 'processing' to 'ready'.
copy_file
Copy a file to a different folder.
move_file
Move a file to a different folder.
list_folders
List subfolders in a folder. Use list_projects to find root folder IDs, then browse deeper with this tool. Supports pagination.
create_folder
Create a new folder inside a parent folder.
get_folder
Get details of a specific folder by ID.
update_folder
Update a folder's name.
delete_folder
Delete a folder and all its contents permanently.
list_folder_children
List all children (files, folders, version stacks) in a folder. Returns mixed types. Use list_files or list_folders for type-specific listing.
copy_folder
Copy a folder and its contents to a destination folder.
move_folder
Move a folder to a different parent folder.
get_file_metadata
Get custom metadata values for a file. Use list_metadata_fields to see available field definitions.
list_metadata_fields
List custom metadata field definitions for an account. Shows available fields that can be set on files.
update_metadata_values
Apply metadata field values to one or more files in a project. The same set of values is applied to every listed file. Requires custom (mutable) metadata field definitions; system fields cannot be edited.
list_projects
List projects in a workspace. Returns project IDs and root_folder_id needed to browse files. Use list_workspaces to find workspace IDs.
create_project
Create a new project in a workspace. Use list_workspaces to find workspace IDs.
get_project
Get details of a specific project by ID, including its root_folder_id for browsing files.
update_project
Update a project's name or settings.
delete_project
Delete a project permanently. This removes all files and folders within it.
list_shares
List share links for a project. Share links allow external reviewers to view and comment on files.
create_share
Create a share link for a project. Optionally set expiration, password, and download permissions. Add assets with add_assets_to_share.
get_share
Get details of a specific share link by ID, including its public URL.
update_share
Update a share link's name, expiration, password, or download settings.
delete_share
Delete a share link permanently. External reviewers will lose access.
add_asset_to_share
Add a file or folder to an existing share link so reviewers can see it.
remove_asset_from_share
Remove a file or folder from a share link.
get_current_user
Get the currently authenticated user's profile including name, email, and avatar URL.
validate_credential
Validate Frame.io credentials by fetching the current user profile. Returns success status and message.
list_version_stacks
List version stacks in a folder. Version stacks group multiple versions of a file together.
create_version_stack
Create a version stack from a list of file IDs. Groups file versions together for comparison and review.
get_version_stack
Get details of a specific version stack by ID.
list_version_stack_children
List file versions within a version stack. Returns individual file versions ordered by version number.
list_workspaces
List workspaces in a Frame.io account. Workspaces contain projects. Use cursor from page_info for pagination.
create_workspace
Create a new workspace in a Frame.io account. Workspaces organize projects.
get_workspace
Get details of a specific workspace by ID.
update_workspace
Update a workspace's name or settings.
delete_workspace
Delete a workspace permanently. This removes all projects and files within it.
How to set up Merge Agent Handler
In an mcp.json file, add the configuration below, and restart Cursor.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5 "headers": {
6 "Authorization": "Bearer yMt*****"
7 }
8 }
9 }
10}
11Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.
Make sure Claude is using the Node v20+.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "yMt*****"
14 }
15 }
16 }
17}Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "<ah-production-access-key>"
14 }
15 }
16 }
17 }In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".
You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.
Learn more in the official documentation ↗
1{
2 "inputs": [
3 {
4 "type": "promptString",
5 "id": "agent-handler-auth",
6 "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7 "password": true
8 }
9 ],
10 "servers": {
11 "agent-handler": {
12 "type": "stdio",
13 "command": "npx",
14 "args": [
15 "-y",
16 "mcp-remote@latest",
17 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18 "--header",
19 "Authorization: Bearer ${input:agent-handler-auth}"
20 ]
21 }
22 }
23}FAQs on using Merge's Frame.io MCP server
FAQs on using Merge's Frame.io MCP server
What is a Frame.io MCP?
A Frame.io MCP is a server that gives your agents access to data and functionality from Frame.io through a set of callable tools. Your agents can use these tools to list and organize projects, retrieve files and version stacks, pull timecoded review comments, create share links, and more.
Frame.io doesn't offer an MCP server purpose built for Frame.io, but you can use one from a third-party platform, like Merge Agent Handler.
How can I use the Frame.io MCP server?
The use cases naturally depend on the agent you've built, but here are a few common ones:
- Review feedback aggregation: When an editor uploads a new cut to Frame.io, an agent can pull all timecoded comments from the asset and compile them into a structured summary, then post that summary to a Slack channel or project management tool so the team can act on feedback without logging into Frame.io
- Asset delivery tracking: An agent can monitor a Frame.io project for files that have reached a final approval state and automatically generate share links for client delivery, eliminating the manual step of creating and distributing links after sign-off
- Cross-tool project sync: When a new project is created in a tool like Asana or Jira, an agent can automatically create a corresponding Frame.io project and folder structure, keeping production assets organized alongside task tracking from day one
- Post-production reporting: An agent can scan active Frame.io projects for assets with open comments, group them by project and assignee, and generate a weekly status report for production leads without anyone manually checking review queues
What are popular tools for Frame.io's MCP server?
Here are some of the most commonly used tools:
list_projects: retrieves all projects within a workspace, including metadata like creation date and owner. Useful for agents that need to scan active productions or build a cross-project status view
get_file: fetches a single file record including its review status, version information, and associated metadata. Call this when an agent needs full context on an asset before taking a downstream action
list_comments: returns all comments on a file, including timecode positions and commenter details. Good for workflows that aggregate review feedback or detect unresolved notes on a delivery
create_comment: adds a comment to a file at a specified timecode, which agents can use to annotate assets programmatically based on output from another system or analysis step
create_share: generates a share link for a file or project with configurable permissions. Helpful when an agent needs to deliver assets to an external reviewer or client after an approval event is detected
move_file: moves a file to a different folder or project. Use this when an agent needs to reorganize assets based on status changes, such as moving approved files into a delivery folder automatically
What makes Merge Agent Handler's Frame.io MCP server better than alternative Frame.io MCP servers?
Here are just a few reasons to use Merge Agent Handler's Frame.io MCP server over building your own or using another:
- Enterprise-grade security and DLP: Merge Agent Handler includes data loss prevention controls that let you block or redact sensitive fields before they reach an agent. For Frame.io, this means you can prevent client asset URLs, share links, and confidential review notes from being exposed even when the agent has broad read access
- Managed authentication and credentials: Merge stores and refreshes Frame.io credentials on your behalf. You never hand raw OAuth tokens to an agent or deal with token expiry breaking a production workflow
- Real-time observability and audit trail: Every tool call made against Frame.io is logged with a timestamp, tool name, input parameters, and response metadata. You can trace exactly what an agent read, moved, or commented on without building any custom instrumentation
- Tool Packs and controlled access: Tool Packs let you bundle specific Frame.io tools with tools from other connectors into a single scoped MCP endpoint. An agent built for client delivery gets share link creation and file retrieval, but not delete or workspace management tools
How can I start using Merge Agent Handler's Frame.io MCP server?
You can take the following steps:
1. Create or log into your Merge Agent Handler account.
2. Install the Merge CLI by running pipx install merge-api, then run merge configure to link the CLI to your Merge account and merge login to authenticate your session.
3. Register the Agent Handler MCP server with Claude Code by running claude mcp add --transport http agent-handler https://ah-api.merge.dev/mcp. Then open Claude Code and run /mcp to confirm agent-handler appears with a connected status.
4. Select agent-handler from the MCP list. This opens a browser window where you select which integrations to authenticate. Choose Frame.io and complete the auth flow. Merge stores and manages the credentials going forward.
5. Open a Claude Code session and start querying Frame.io data directly. The first time you use a Frame.io tool, a Magic Link may appear to complete connector authentication.
Note: If you want to connect Merge Agent Handler's Frame.io MCP with internal or customer-facing agentic products, you can follow the steps in our docs.
Can employees use Merge Agent Handler to connect their AI tools to Frame.io?
Yes, Agent Handler for Employees lets your employees connect Claude, ChatGPT, Microsoft Copilot, Cursor, and other MCP-compatible AI tools to Frame.io without bypassing IT governance.
Instead of setting up direct connections with personal credentials that IT can't monitor or revoke, each employee authenticates through Agent Handler and gets individual credentials tied to their identity.
IT also provisions access by role or group via SCIM. A video editor, for example, gets Frame.io access to review and annotate cuts, Slack to share feedback with the team, and Google Drive to pull source assets; while a creative director gets Frame.io access to track project approvals, Asana to manage production timelines, and Slack to align stakeholders on delivery milestones.
Every tool call an employee's AI makes to Frame.io is also inspected against your DLP rules and logged to a searchable audit trail, giving security teams full visibility into what data was accessed and by whom.
Ready to try it out?
Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now
