# Cincopa MCP > Cincopa lets you manage your entire video and media library through chat commands. You can list galleries, check asset metadata for videos, images, or audio files, get temporary upload URLs, create new gallery structures, or permanently delete old content—all without opening the dashboard. ## Overview - **Category:** image-video - **Price:** Free - **Tags:** media-hosting, video-management, digital-asset-management, media-galleries, content-distribution, audio-hosting ## Description Managing a large media collection used to mean clicking through dozens of tabs and dashboards just to find an ID number or verify if an asset was ready. Now, you connect your Cincopa account directly to any AI agent. You treat it like talking to a skilled content librarian who already knows the system inside out. Ask it to list all your existing galleries, get detailed stats on a specific video file, or pull together a bunch of assets for a new course module. It handles the complexity so you don't have to. Need to add something? The agent grabs a temporary upload URL right in the chat window. This makes coordinating media much faster and keeps all your workflow data centralized inside the Vinkius catalog, accessible through your preferred AI client. ## Tools ### create_new_gallery Creates an empty media gallery structure based on a chosen template. ### delete_media_asset Removes a specific video, image, or audio file from the account permanently. ### get_asset_metadata Pulls detailed technical information about any single media asset. ### get_gallery_details Retrieves all the specific details for a named gallery. ### get_media_upload_url Generates a temporary web address needed to upload new media files into Cincopa. ### list_cincopa_assets Lists every single video, image, and audio asset currently stored in the platform. ### list_cincopa_galleries Provides a list of all media galleries available to you. ### list_cincopa_templates Shows the names and types of gallery templates that can be used for new projects. ## Prompt Examples **Prompt:** ``` List all my video galleries in Cincopa. ``` **Response:** ``` Retrieving your galleries... I found 5 items: 'Product Demos', 'Marketing Assets', 'Internal Training', and 2 others. Which one would you like to see the contents of? ``` **Prompt:** ``` Show me the metadata for asset RID 'AAAAtAURG'. ``` **Response:** ``` Checking asset AAAAtAURG... This is a MP4 video titled 'Feature Update'. It is 45MB, has a 1080p resolution, and was last modified yesterday. ``` **Prompt:** ``` Create a new gallery called 'Customer Interviews' using the 'Video Portal' template. ``` **Response:** ``` Creating gallery 'Customer Interviews'... The gallery has been successfully created. You can now use its FID (A4KANh__rQ_m) to add media assets to it. ``` ## Capabilities ### List All Galleries Retrieve a list of every media gallery and folder you have set up. ### Check Asset Details Get detailed metadata—like file size, resolution, or creation date—for any specific video, image, or audio asset. ### Upload Media Files Generate a temporary upload URL so you can push new content to Cincopa securely from your client's environment. ### Build New Galleries Create brand-new media galleries using predefined templates with simple commands. ### Organize Content Access and list available gallery templates to keep your content branding consistent across all projects. ### Clean Up Assets Permanently remove unwanted media assets or entire galleries directly through the chat interface. ## Use Cases ### Auditing Campaign Assets A marketing manager needs to know if all 50 assets for Q3 are correctly tagged and sized. They ask their agent to run `list_cincopa_assets` first, then use `get_asset_metadata` on the top five files to check resolutions. This saves hours of manual spot-checking. ### Launching a New Product Line The e-learning team needs a dedicated space for new tutorials. They ask the agent to list available templates with `list_cincopa_templates`, pick one, and then create a whole new gallery using `create_new_gallery` in minutes. ### Cleaning Up Old Drafts A content editor finds 30 obsolete videos scattered across old galleries. They ask the agent to list all assets, identify the junk, and then use `delete_media_asset` on everything that needs clearing out. ## Benefits - Stop jumping between tabs. You can list all your galleries using `list_cincopa_galleries` and immediately get the content details for any one of them with `get_gallery_details`, all in one conversation thread. - Speed up content ingestion. Instead of manually finding a secure endpoint, use `get_media_upload_url` to grab a temporary address you can use instantly when pushing new assets. - Maintain organization without manual effort. If your team needs a whole new folder, the agent lets you list available templates with `list_cincopa_templates` and then build it using `create_new_gallery`. - Audit media performance quickly. You can use `get_asset_metadata` to check file sizes or resolutions for assets that need updating, without logging into the full dashboard. - Keep things clean. Need to remove old drafts? Use `delete_media_asset`. It’s a single command to take unwanted content off the platform. ## How It Works The bottom line is you manage your entire media library through natural conversation instead of clicking buttons in a web UI. 1. Subscribe to this MCP and provide your Cincopa API Token, which you get from your account settings. 2. Connect this MCP to your AI client (like Cursor or Claude) via the Vinkius Marketplace. 3. Start talking to the agent. You ask it for a list of assets, details on metadata, or an upload URL—it runs the command and gives you the result. ## Frequently Asked Questions **How do I list all my video galleries using the `list_cincopa_galleries` tool?** You just tell your agent to run `list_cincopa_galleries`. It pulls a comprehensive list of every gallery you have, letting you see exactly what structures exist without opening the main web app. **What is the best way to check video metadata with `get_asset_metadata`?** You pass the unique ID of the asset. The agent then returns technical data like resolution, size, and file type instantly, so you don't have to guess or hunt through menus. **Can I create new galleries using `create_new_gallery`?** Yes, absolutely. You tell the agent which template to use, and it handles the creation of a brand-new gallery structure for you right from the chat interface. **If I need to upload new content, what tool should I use? Should I use `get_media_upload_url`?** Yes, that's exactly right. You must call `get_media_upload_url`. This gives your agent the secure temporary link you need before you can push any files to Cincopa. **What's the safety concern when I use the `delete_media_asset` tool?** The deletion is permanent and irreversible. Before running `delete_media_asset`, always verify you have the correct asset ID. The tool confirms successful removal, but you should treat it like a final action. **How do I make sure my new gallery has consistent branding when I use `list_cincopa_templates`?** You first run `list_cincopa_templates` to see what's available. Then, you select a specific template ID when calling `create_new_gallery`. This ensures all assets start with the right structure. **Does `list_cincopa_assets` show me every type of media, or just videos?** It shows everything. This tool lists videos, images, and audio files together. You get a single overview of your whole media library without needing separate calls for different file types. **When I use `get_gallery_details`, can it tell me exactly which assets belong to that gallery?** Yes, the response includes associated asset IDs. This lets your agent track precisely what media is housed in a specific collection, mapping out all its contents. **Can I get a direct link to upload a video through the agent?** Yes! Use the `get_media_upload_url` tool. The agent will return a temporary URL that you can use to POST your video file directly to Cincopa's servers. **How do I see the metadata for a specific image or video?** Use the `get_asset_metadata` tool with the unique Resource ID (rid). Your agent will fetch detailed info like resolution, format, and size. **Where do I find my Cincopa API Token?** Log in to your Cincopa account and navigate to **Settings > API & Developers**. You can generate and copy your personal API token from there.