# Frame.io MCP > Frame.io lets your AI agent manage video assets, track project progress, and handle team feedback without you leaving your chat window. Use this MCP to list projects, retrieve metadata, check collaborators, or add time-coded comments directly from Claude, Cursor, or any compatible client. ## Overview - **Category:** collaboration - **Price:** Free - **Tags:** video-review, creative-workflow, asset-management, media-collaboration, time-coded-comments, post-production ## Description Video review used to be a mess of email threads, shared spreadsheets, and scattered comment marks. Now, you can keep all that work centralized by connecting Frame.io via Vinkius. This MCP lets your AI agent read the project status, pull detailed asset metadata, or even add specific feedback directly into the video timeline—all through natural conversation. Instead of clicking between tabs to find who owns an asset or checking a dozen email chains for approval status, you just ask. Your agent can list all projects in your team and instantly give you a summary of what's ready for review. It’ll also pull up the full roster of collaborators involved. Whether you need to fetch specific details about media files or simply want to add a time-stamped comment to flag an issue, it happens conversationally. ## Tools ### add_comment Posts a new, specific comment on an asset at a certain point in the video timeline. ### get_asset_details Retrieves deep metadata and technical details about any media file or folder. ### get_my_profile Gets basic information about the user who is logged into Frame.io. ### get_project_details Fetches detailed metadata and status information for a specific project. ### list_accounts Lists the billing accounts associated with your Frame.io organization. ### list_assets Retrieves a list of files or folder contents within a project library. ### list_collaborators Lists all team members and external users who have access to the current project. ### list_asset_comments Retrieves a list of existing comments made against a specific video asset. ### list_folders Lists all sub-folders contained within a given project directory. ### list_projects Retrieves a list of active projects belonging to your team or organization. ### list_review_links Accesses and lists the specific review links for monitoring external stakeholder viewing. ### list_teams Retrieves a list of all teams within your Frame.io organization structure. ## Prompt Examples **Prompt:** ``` List all my projects in Frame.io team 'team_abc123'. ``` **Response:** ``` Retrieving projects... I found 4 active projects in your team, including 'Spring Campaign' and 'Product Launch Video'. Would you like to see the assets for any of these? ``` **Prompt:** ``` Show me the last 5 comments on video asset 'vid_9876'. ``` **Response:** ``` Fetching comments... I found 5 recent updates for 'vid_9876', including a request to 'fix the color grade at 00:45' and a note about 'audio levels being too low'. ``` **Prompt:** ``` Add a comment to 'vid_9876': 'Great work, let\'s proceed to export' at 120 seconds. ``` **Response:** ``` Comment added! Your feedback has been successfully posted to 'vid_9876' at the 02:00 mark. Your team will see your approval in the project timeline. ``` ## Capabilities ### Check project status and team lists Retrieve comprehensive metadata for all projects in your teams, or list every collaborator involved with a given project. ### Browse and detail media assets List folders or individual files within a project structure, and pull deep metadata about any specific asset. ### Monitor feedback threads See all existing comments on an asset, or add new time-coded feedback directly from your agent chat. ### Coordinate review links List and access the specific external links used for project reviews so you know who's looking at the media. ## Use Cases ### Reviewing a new campaign asset The Creative Director needs to know if the final video is ready for external stakeholders. They ask their agent to `list_review_links` and get an immediate list of links, instantly showing which external parties have access. ### Auditing a complex project The Post-Production Manager needs to compile all feedback for the client report. They ask their agent to `list_assets` and then use `get_asset_details` on key files, gathering necessary metadata and asset lists into one place. ### Updating project status quickly The Video Producer needs to update a client's awareness of the current status. They ask their agent for `get_project_details` on 'Summer Campaign', instantly confirming which phase it’s in and who is assigned. ### Tracking feedback across multiple assets The Editor needs to see all comments left over the last week. They ask their agent to `list_asset_comments` for a specific video, getting a chronological log of notes from everyone. ## Benefits - Stop switching between tabs to check on status updates. You can ask your agent for `list_projects` or `get_project_details` and get a summary immediately. - Never lose track of feedback again. Use the MCP to `list_asset_comments` so you see every single note, including who said it and when. - Build an audit trail in your chat history. You can use `add_comment` to post time-coded approval notes directly into the asset timeline as if you were using Frame.io itself. - Keep all context centralized by listing team members via `list_collaborators`. This single command shows exactly who is involved in which project, no guesswork needed. - Get deep technical data instantly. Instead of manual inspection, use `get_asset_details` to pull metadata on any file or folder right into your chat. ## How It Works The bottom line is that once connected, you talk to your agent like it's already logged into Frame.io and pulling data for you. 1. Subscribe to this MCP through Vinkius Marketplace. 2. Enter your Frame.io Personal Access Token, found in the Developer Portal. 3. Start asking your agent questions about projects or assets using any compatible AI client. ## Frequently Asked Questions **How do I get an Access Token for Frame.io?** You can generate a Personal Access Token in the Frame.io Developer Portal at https://developer.frame.io. **Can I add comments with a specific timecode using the agent?** Yes! The 'add_comment' tool accepts an optional 'timestamp' parameter in seconds, allowing you to pin your feedback to a specific moment in the video. **How do I see the assets inside a specific folder?** Use the 'list_assets' tool and provide the Folder ID as the 'parentId'. The agent will return all files and sub-folders contained within that directory. **Is it possible to list external review links?** Yes! Use the 'list_review_links' tool and provide the Project ID. The agent will retrieve all active shared links for that project.