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