# MediaSilo (Legacy) MCP > MediaSilo (Legacy) connects your AI client to a secure video workspace for collaborative content review and asset management. Use this server to track annotations, manage projects, list assets across folders, and generate password-protected links without leaving your chat interface. ## Overview - **Category:** collaboration - **Price:** Free - **Tags:** video-review, asset-management, media-collaboration, approval-workflows, secure-sharing, post-production ## Description Listen up. This server plugs your AI client right into MediaSilo, giving you a secure way to handle all that video content review and asset management without leaving your chat window. You're gonna be able to track annotations, manage whole projects, list assets across folders, and even generate password-protected links—all from one spot. When you use this server, you can get detailed info on any single media file by running `get_asset`. If you need a full inventory of everything in the account, just call `list_assets`, which gives you every video, image, and document. You can narrow that down to specific groups using `list_folder_assets` if you know the folder ID. For managing projects, first, you'll use `list_projects` to see a list of all available jobs in your organization. If you want deep details on one particular project, run `get_project`. To manage who has access to that job, call `list_project_users`, which gives you the team roster for a specific project ID. When it comes to people, you can get a full list of every user in your entire organization using `list_users`. If you need specifics on one person, use `get_user` with their unique ID. You'll always know who's running the agent because `get_current_user` pulls up your own details right now. For secure sharing and access control, you can list all QuickLinks that exist in the account using `list_quicklinks`. To check out what a single link is pointing to—say, for review purposes—you run `get_quicklink`. These tools let you manage external viewing rights without needing to leave your chat. You're talking about managing entire pipelines and making sure everyone sees the right thing at the right time. This setup lets your agent interact with MediaSilo’s core features, meaning you don't have to jump between dashboards or manually compile status reports anymore. It’s all handled conversationally. If you need a quick rundown of assets, `list_assets` gets it. If the content is locked in one folder, `list_folder_assets` shows it. For project scope and details, start with `list_projects`, then dive deep using `get_project`. Checking on team membership means calling `list_project_users`. Need to know who's working here? Use `list_users` or `get_user`. And if you gotta share something outside the main platform, managing links starts with `list_quicklinks` and checking details with `get_quicklink`. It’s a complete rundown of your media workspace. ## Tools ### get_asset Gets detailed information for one specific media asset ID. ### get_current_user Retrieves the details of the user who is currently authenticated in MediaSilo. ### get_project Gets detailed information for a specific project ID. ### get_quicklink Retrieves details about a single, specified MediaSilo QuickLink. ### get_user Gets detailed information for one specific user ID. ### list_assets Lists all assets across the entire MediaSilo account space. ### list_folder_assets Lists assets located within a specific folder ID. ### list_project_users Lists all users who are assigned to a particular project ID. ### list_projects Lists all available projects in the MediaSilo account. ### list_quicklinks Lists all QuickLinks that exist in your account. ### list_users Lists every user record within the entire MediaSilo organization. ## Prompt Examples **Prompt:** ``` Search for the latest 'Director's Cut' asset and create a review link. ``` **Response:** ``` Found asset: 'Commercial_v3_Directors_Cut.mp4' (ID: 890, 450MB, Project: 'Summer Campaign'). Review link created ✅. URL: https://links.shift.io/review/abc123xyz. Password: 'Summer2024'. Expires in: 7 days. ``` **Prompt:** ``` Show comments and approvals for the Summer Campaign video. ``` **Response:** ``` Status: 3 pending, 1 approved. Comments: 4. @0:12 (Client): 'Can we make the logo slightly bigger here?'. @0:45 (Director): 'Color grading looks a bit washed out, let's boost contrast.' Approved by: Sarah (Producer) ✅. ``` **Prompt:** ``` Show viewer engagement analytics for the Q1 Pitch link. ``` **Response:** ``` Q1 Pitch Analytics: 45 unique views. Total watch time: 18 hours. Average completion: 78%. Drop-off spike: @1:45 (Pricing slide, 12 viewers stopped watching). Top viewers: Apple Inc. (12 views), Internal (5 views). ``` ## Capabilities ### List all assets Retrieves a complete inventory of every media file (video, image, document) in your MediaSilo account. ### Find assets in folders Searches and lists specific media files contained within a defined folder structure. ### View project details Retrieves comprehensive information about a single, specified MediaSilo project. ### List assigned users Identifies and lists every user who has been given access to a particular project. ### Manage team members Retrieves details for any specific user within your MediaSilo organization. ### Create quick review links Generates secure, password-protected URLs for stakeholders to view assets outside of the main platform. ## Use Cases ### Need an asset inventory before a meeting A Post-Production Manager needs to know every file related to the 'Summer Campaign' project. Instead of navigating through multiple folder views, they ask their agent to use `list_folder_assets` on the main campaign folder and get a comprehensive, immediate list for review. ### Client wants an ad-hoc review link The Agency Account Lead needs to send a client a secure link for one specific pitch video. They prompt their agent: 'Get the quicklink details for Q1 Pitch.' The server runs `get_quicklink` and returns all necessary access info, including URL and password. ### Checking project compliance A Creative Director wants to verify if specific team members have signed off on a cut. They ask the agent to check 'Project X' using `list_project_users` and get details for each person via `get_user`, confirming everyone's role. ### Debugging file access issues A Video Editor can’t find a specific version of a shot. They use the agent to run `list_assets` and filter by date or name, immediately locating the correct asset ID using `get_asset`, saving time searching through messy folders. ## Benefits - Track comments and approvals automatically. Instead of checking a dashboard for status updates, ask your agent to 'Show comments and approvals for the Summer Campaign video' and get a clean summary immediately. - Never lose track of files again. Use `list_folder_assets` or `list_assets` to instantly generate an inventory list of every file in a folder or across the whole account. - Control access with precision. You can use `get_quicklink` or `list_quicklinks` to create and retrieve secure, password-protected review links for clients without sharing raw files. - Keep your team organized. Need to know who is on the project? Use `list_project_users` to see exactly which people are assigned to a specific workflow, eliminating manual check-ins. - Understand viewer performance instantly. Your agent can pull analytics data by running tools that track view counts and drop-offs for any given link. ## How It Works The bottom line is: Your AI client runs the commands against MediaSilo and gives you a clear answer in your chat window. 1. Subscribe to this server and enter your MediaSilo API Key and Secret. 2. Connect your preferred AI client (Claude, Cursor, etc.) to the MCP Server endpoint. 3. Tell your agent what you need—for example, 'List all projects for Q3' or 'Show comments on the final cut.' The agent executes the necessary tool calls. ## Frequently Asked Questions **How do I find out which files are in a specific folder using list_folder_assets?** You run `list_folder_assets` and provide the Folder ID. The tool returns an inventory of every asset contained within that exact folder, letting you see all related content at once. **Can I check user roles using get_user or list_users?** Yes. `list_users` gives you a roster of everyone in the account. If you need specific details on one person, use `get_user` and provide their ID to see their full profile. **What if I need to check project assets for multiple projects?** The best way is to first run `list_projects` to get all the Project IDs you care about. Then, iterate through those IDs and call `get_project` for each one to gather details. **How do I create a secure link using MediaSilo (Legacy) MCP Server?** You use the quicklink tools. First, run `list_quicklinks` to see what you have. Then, if needed, you can use an agent prompt to generate or retrieve details for a new review link. **Do I need to list all assets and then get project details?** No. If you know the Project ID, start with `get_project`. This gives you context (like related users) before you even try to browse individual files via `list_assets`. **When I run a workflow using `get_current_user`, how do I know which identity triggered the API call?** The tool returns the authenticated user's unique profile details. This allows your agent to audit who initiated actions, confirming that the request originated from a specific MediaSilo account. **If I use `list_assets` and there are thousands of files in my account, how do I handle pagination?** The API handles large datasets using paginated results. Your agent needs to iterate through the returned page tokens until all assets have been processed. **How can I find out which users are actually assigned to a specific project using `list_project_users`?** Running `list_project_users` pulls a focused roster for that single project. This tells you exactly who has access and ownership within the scope of the job. **Can I create secure review links?** Yes. Generate password-protected, expiring links for external clients to review video assets. **How does MediaSilo authentication work?** It requires both an **API Key** and **API Secret** sent via custom headers against `api.shift.io/v3`. **Can I track viewer engagement on videos?** Yes. Track playbacks, total watch time, drop-off points, and specific timestamp comments.