# Simian MCP > Simian connects your AI client to a full video collaboration stack. It lets your agent manage creative assets by retrieving media metadata, listing active projects, creating reels, and coordinating review feedback directly from chat. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** video-sharing, creative-workflow, media-review, collaboration-tools, viewer-engagement, asset-management ## Description Look, this Simian MCP Server connects your AI agent right into a full-blown video collaboration stack. It lets you manage all your creative assets—from initial discovery through final client approval—without ever leaving the chat window. You're talking about retrieving media metadata, listing active projects, building new reels, and coordinating review feedback with zero hassle. To start, if you need to take a look at what media you’ve got sitting around, you can use `list_media` to pull up a comprehensive list of every single file in your asset library. You also can check out the specific details on any given piece using `get_media`, which pulls detailed metadata for a specific identifier. If you're done with a piece and need to wipe it off the books, `delete_media` permanently removes that selected file from both your media library and any project assets. When it comes to projects and reviews, you wanna know what’s moving? You run `list_projects` to get a roster of every active project currently waiting on review or approval. For deep dives into feedback, you use `get_project_comments`, which pulls all the comments, annotations, and specific feedback tied to a named project file. If you need to add your own thoughts—whether it's just a comment or setting an official 'approved' status—you hit up `add_project_comment`. Finally, if you gotta know how far along a reel is, `get_reel` pulls all the complete details and analytics for that existing presentation. For building out content, generating video presentations (reels) is straightforward. You use `create_reel` to generate a brand-new video presentation within the platform. Once it's done, you can see what other reels exist using `list_reels`, or grab all the specifics on an existing one with `get_reel`. If that reel needs to go out? You run `share_reel`; this sends the reel directly to specific people via email or spits out a shareable short link. When you modify the basic info on a file—like changing the description or adding new tags to media—you use `update_media`. To keep your system running smoothly, you've got tools for managing operations. You pull up current usage limits and billing stats by calling `get_account_info`. These core functions mean your agent can handle everything from checking asset status and modifying metadata, to coordinating project reviews and generating finished content. ## Tools ### add_project_comment Adds a new comment or sets the approval status for an existing file in a project. ### create_reel Generates a brand-new video presentation (reel) within the platform. ### delete_media Permanently removes a selected file from your media library and project assets. ### get_account_info Retrieves current account details, including usage limits and billing statistics. ### get_media Fetches detailed metadata for a specific media file using its identifier. ### get_project_comments Pulls all comments, annotations, and feedback associated with a named project file. ### get_reel Retrieves the complete details and analytics for an existing reel or presentation. ### list_media Returns a comprehensive list of every media file currently held in your asset library. ### list_projects Lists all active projects that are currently undergoing review or approval cycles. ### list_reels Shows a list of every created video presentation (reel) saved in the account. ### share_reel Sends an existing reel to specific recipients via email or generates a shareable short link. ### update_media Modifies the metadata (e.g., description, tags) for an already existing media file. ## Prompt Examples **Prompt:** ``` Get the review link for project 'Summer Campaign'. ``` **Response:** ``` Here is the secure review link for 'Summer Campaign': simian.com/review/1234 ``` **Prompt:** ``` Summarize the analytics for my latest reel. ``` **Response:** ``` Your latest reel has 45 views, an average watch time of 1m 20s, and 5 new comments from the client. ``` **Prompt:** ``` Invite 'client@brand.com' to review project 104. ``` **Response:** ``` An invitation has been successfully sent to 'client@brand.com' for project 104. ``` ## Capabilities ### View Asset Status List all available media files in the library using `list_media` or check specific file data with `get_media`. ### Manage Projects & Reviews Retrieve project lists (`list_projects`) and pull specific feedback, annotations, and comments using `get_project_comments`. ### Create and Share Reels Generate new video presentations with `create_reel`, retrieve existing reel details with `get_reel`, or share them out via email/link using `share_reel`. ### Collaborate on Files Add specific feedback or approval status to a file using the `add_project_comment` tool. ### System Operations Access basic system data, including account usage stats (`get_account_info`) and updating asset metadata (`update_media`). ## Use Cases ### The Client Review Cycle is Stuck A project stalled because no one knows who needs to sign off. The agent first runs `list_projects` to identify the specific campaign ID, then uses `get_project_comments` to see the last recorded feedback. Finally, it sends a reminder email via the chat interface. ### Audit and Clean Up Assets You need to know what files are old and unused. The agent calls `list_media`, filters out assets older than 90 days, and reports them back to you. You then use `delete_media` on the confirmed list. ### Analyze a Campaign Performance A new video dropped last week. The agent calls `get_reel` to fetch its analytics (views, watch time). It summarizes this data and then automatically shares the performance summary with the client contact via `share_reel`. ### Updating an Asset's Story A video was shot last year but needs new tags. Instead of manually finding the file in three different folders, you tell your agent to use `get_media` first for verification, then call `update_media` with the correct descriptive metadata. ## Benefits - Stop juggling tabs. Instead of logging into the MAM, then the project tracker, and finally opening a comment thread, you can ask your agent to `get_project_comments` immediately. All feedback surfaces in one place. - Streamline asset cleanup. Use `list_media` to audit every file in your library before calling `delete_media`. You'll know exactly what you're permanently removing. - Speed up presentations. Instead of manually exporting and emailing a draft, call `create_reel` or use `get_reel` to analyze performance data right after launch. - Keep track of approvals. Use `list_projects` to see which campaigns are stuck in review limbo. Then, invite the necessary parties using the chat interface. - Avoid stale metadata. If a client re-uploads an asset but forgets to update the tags, use `update_media` so your internal search always points to the right version. ## How It Works The bottom line is, your agent runs video ops and asset management commands directly against Simian's backend using plain conversation. 1. You prompt your agent with a specific request (e.g., 'Get all comments on project XYZ'). 2. The agent identifies the necessary tool—for example, `get_project_comments`—and sends it to the Simian MCP Server. 3. The server executes the function and returns structured data (like comment lists or media links) back through the chat interface. ## Frequently Asked Questions **How do I check if a project is active using list_projects?** You run the `list_projects` tool. This returns a comprehensive list of all projects currently marked as 'active' or needing review, so you know exactly where your team needs to focus. **Can I get metadata for a file using get_media?** Yes, `get_media` pulls deep details on any media file. You can retrieve everything from the creation date and original resolution to custom tags and usage counts. **What is the best way to share a finished reel? Should I use share_reel?** Yes, `share_reel` is the dedicated tool. It handles generating secure links or sending direct emails with the correct file attachment and tracking metadata. **How do I add comments to an asset using add_project_comment?** You call `add_project_comment` and specify the project ID. This lets you log your specific feedback or mark an item as 'approved' directly against that asset record. **What should I expect when using the `get_reel` tool with an expired or non-existent Reel ID?** The system will return a 404 error status code. This means you must verify that the provided Reel ID is current and belongs to an active asset before calling the function. **Does the `list_media` tool support pagination so I can retrieve every file in the library?** Yes, it supports pagination. You must pass the appropriate cursor or page number parameter when listing files to cycle through all available results. **Is the action performed by `delete_media` permanent, or is there a soft-delete option?** The operation is irreversible. When you execute `delete_media`, the file is permanently removed from the library and cannot be recovered. **Where can I check my API usage and potential rate limits using `get_account_info`?** The tool returns your current usage statistics and remaining quota in the account details. This lets you track consumption and avoid hitting service limits proactively. **Can I get the review link for a specific video project?** Yes, just ask the agent for the presentation link of your project and it will fetch it securely. **How do I check engagement analytics on my shared reel?** You can query the AI to summarize view counts, average watch times, and comments left by clients on your reel. **Is it possible to invite a reviewer via the chat?** Yes! Provide the reviewer's email and the project ID, and the agent will dispatch a secure invite link.