# Colossyan MCP for AI Agents AI Agent Connect > Colossyan MCP lets you build AI videos using natural language. You can manage avatars, pick voices, and trigger video renders from templates or custom descriptors. It handles the technical heavy lifting of synthetic media production so you can focus on the content. ## Overview - **Category:** marketing-automation - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_NC2pzoljyWwRxypIpd4uPB5HfRpGb1uL8njwdrk0/ai-agent-connect - **Tags:** ai-video, avatar-generation, synthetic-media, video-automation, text-to-video ## Description Connect your Colossyan account to any AI agent to handle your synthetic media production. You can create high-quality videos with AI avatars using natural language commands. List all available studio and instant avatars or create new ones from source links. Explore hundreds of voices across different languages and styles to find the right fit for your project. Trigger video renders using saved templates with dynamic variables or submit full creative descriptors for custom control. Monitor the real-time status of your video generation jobs and retrieve final public URLs and metadata as soon as they're ready. Manage your library by retrieving details of finished videos or deleting jobs and assets when they're no longer needed. Generate video drafts from structured textual summaries to see how a concept might look before you commit. Vinkius lets you plug this into your existing workflow so you can start generating AI videos from Claude, Cursor, or any MCP-compatible client immediately. This removes the technical heavy lifting of video rendering and asset management, letting you focus on the actual content. Manage your entire production pipeline from a single chat window without jumping between multiple tabs or manual entry forms. ## Tools ### create_actor Create an instant avatar from an image or video link. This lets you expand your actor library without manual uploads. ### delete_job Delete a specific video generation job. Use this to clear out your queue quickly. ### generate_draft Generate a draft from structured textual data. It turns your knowledge base into a rough video layout. ### generate_from_template Generate a video using a saved template. This is the fastest way to batch-produce content with variables. ### delete_video Delete a generated video from your library. This helps keep your workspace clean of old assets. ### generate_video Generate a video manually using a full JSON descriptor. Use this for high-control, custom video creations. ### get_job_status Retrieve video generation job status. Check if your video is still rendering or ready to view. ### get_video Retrieve details of a finished video. This gets you the final public URL and metadata. ### list_actors List available avatars/actors for the workspace. See every actor you have access to in one list. ### list_voices List available voices for the workspace. Browse different languages and styles for your projects. ## Prompt Examples **Prompt:** ``` Show me what actors I have in my workspace. ``` **Response:** ``` I've pulled your current actor list from Colossyan. Here is what's available: | Actor Name | Type | Status | | :--- | :--- | :--- | | Sarah | Studio | Active | | Marcus | Instant | Active | | Elena | Scenario | Active | Would you like to see more details on a specific actor or create a new one? ``` **Prompt:** ``` Make a video for 'John' using my standard intro template. ``` **Response:** ``` Starting video generation using your standard intro template. * **Variable Mapping**: Name $ ightarrow$ John * **Job ID**: `vid_conf_992` I'll monitor the status for you and let you know as soon as the public URL is ready. ``` **Prompt:** ``` Is the video from 5 minutes ago ready? ``` **Response:** ``` I checked the status of job `vid_conf_992` for you. ✅ **Status**: Finished 🔗 **Public URL**: [https://colossyan.com/v/992x882] The video is 45 seconds long and ready for download. ``` ## Capabilities ### Create new avatars from links Turn an image or video URL into a new instant avatar for your workspace. ### List your workspace actors See every studio and instant actor available in your account at once. ### Trigger template renders Start a video production using a saved template and dynamic variables. ### Generate custom videos Create a unique video by providing a full creative descriptor. ### Check real-time job status Get instant updates on whether your video is queuing, rendering, or finished. ### Retrieve finished video URLs Grab the final public link and metadata for any completed video. ### Delete old video jobs Remove finished videos or pending jobs from your library to keep it clean. ### Generate drafts from text Turn structured text summaries into rough video drafts for early review. ### Browse available voices Explore hundreds of voice options across different languages and styles. ## Use Cases ### Personalized Ad Scale A marketer wants 50 videos for 50 different names. They ask the agent to run a template for each name using `generate_from_template`. ### Rapid L&D Updates An HR pro needs to change a training video's actor. They use `list_actors` to find a new one and trigger a re-render. ### Drafting from Notes A creator has a script summary and wants a draft. They use `generate_draft` to see the layout first before committing. ### Bulk Asset Cleanup A user needs to clear out old renders. They ask the agent to find and `delete_video` for all items from last month. ## Benefits - Stop manual rendering by using `generate_from_template` to batch-produce videos. - Build a custom library of faces with `create_actor` without leaving your chat. - Track production progress automatically with `get_job_status` updates. - Scale personalized marketing by mapping variables into templates via your agent. - Clean up your workspace faster by using `delete_video` and `delete_job` on the fly. ## How It Works The bottom line is you get a direct line from your chat interface to your entire Colossyan video production pipeline. 1. Subscribe to the Colossyan MCP on Vinkius. 2. Enter your Colossyan API Key into your AI client settings. 3. Ask your agent to create videos, manage actors, or check job statuses. ## Frequently Asked Questions **Can I use Colossyan MCP to create personalized videos for my customers?** Yes. By using templates with dynamic variables, you can have your agent generate unique videos for different names or details automatically. **How does Colossyan MCP help with marketing automation?** It lets your agent trigger video renders in bulk. You can set up a campaign and have the agent handle the heavy lifting of production. **Can I manage my actors through the Colossyan MCP?** Yes. You can list all actors currently in your workspace or create new instant avatars using image and video links. **Does Colossyan MCP support multiple languages?** Yes. It gives your agent access to hundreds of voices across many different languages and styles for your content. **How do I get the final video link?** Your agent will retrieve the final public URL and metadata for you as soon as the video generation job is finished. **Can I delete old videos using Colossyan MCP?** Yes. You can ask your agent to remove finished videos or pending jobs from your library to keep your workspace organized. **How can I check if my video has finished rendering?** You can use the `get_job_status` tool by providing the `videoId`. The agent will return the current status, such as 'finished', 'generating', or 'failed'. **Can I generate videos using my existing Colossyan templates?** Yes! Use the `generate_from_template` tool. You'll need the `templateJobId` and a JSON object for `dynamicVariables` to fill in the placeholders in your template. **How do I see which AI avatars are available in my account?** Simply ask the agent to run the `list_actors` tool. It will retrieve all available avatars, including Studio, Scenario, and Instant types configured for your workspace.