# Tavus Video Replicas MCP > Tavus Video Replicas manages personalized AI video content. This server lets your agent list, inspect, and delete trained video clones (replicas). You can then generate new videos by providing a script and selecting a replica, all from natural language commands. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** video-generation, ai-replicas, personalized-video, sales-automation, content-creation, api-integration ## Description This server connects your agent directly to Tavus, letting you manage and generate personalized AI video content. You're running trained virtual clones—replicas—to create high-quality talking-head videos on demand. **Managing Your Replicas.** `list_replicas` gives you a complete rundown of every single trained video replica available to your agent. If you need specifics, `get_replica_details` pulls up all the data for one particular clone’s settings. You can also permanently delete unused clones using `delete_replica`, which cleans out that storage space. **Generating Content.** Need a new video? Just use `generate_replica_video`. You feed it a script and tell your agent exactly which replica to use; it handles the rest. When you’re ready, your agent can check the status of any job with `get_video_details` or get general details about the content using `list_generated_videos`. The system also lets you list every video asset that's been created on the platform via `list_generated_videos`. **Viewing and Cleaning Up.** To see everything you’ve built, your agent runs `list_generated_videos`, giving you a complete view of all generated videos along with their direct download links. If you only need to know about one specific video, use `get_video_details` for the granular info. When you're done with a piece or a clone, you can hit delete using `delete_video` to remove a finished video file, or `delete_replica` again if that trained replica isn't needed anymore. This setup lets your agent manage every part of the process—from listing what clones you have (`list_replicas`) and checking their settings (`get_replica_details`), right through generating the talking-head video (`generate_replica_video`). It also tracks progress by providing detailed status checks on any given job, confirming when it's good to download. You can verify every piece of content with `list_generated_videos`, which returns a comprehensive list and associated links for all your finished work. Cleaning up is simple: use `delete_video` if you want to wipe out a specific asset, or call `delete_replica` when a trained model is obsolete. You don't have to juggle multiple systems to keep track of everything. Your agent keeps the content library clean by allowing you to list every existing video (`list_generated_videos`) and get granular details on any single piece (`get_video_details`). The workflow runs entirely through natural language commands, making it fast. If you change your mind about a specific replica's parameters or need to confirm its existence, `get_replica_details` gives you the definitive data. This whole operation lets you treat your personalized video content like a managed asset vault. You get the list (`list_replicas`), check the specifics (`get_replica_details`), generate new stuff using those tools (`generate_replica_video`), track its readiness status, and then either keep it forever or delete it with `delete_video` or `delete_replica`. It's a closed loop of creation, monitoring, and cleanup. ## Tools ### delete_replica Permanently deletes a specific, trained AI video replica. ### delete_video Removes a generated video file from the content library. ### generate_replica_video Creates a new talking-head video by using a specified replica and input script. ### get_replica_details Retrieves comprehensive data about a single, specific AI video replica. ### get_video_details Gets detailed information for one generated video asset. ### list_replicas Retrieves a full list of all trained AI video replicas available to use. ### list_generated_videos Returns a list of all videos that have been created via the platform. ## Prompt Examples **Prompt:** ``` List my Tavus replicas. ``` **Response:** ``` Fetching replicas... I found 2 replicas: 'Sales Persona' (ID: rep_123) and 'Founder Clone' (ID: rep_456). Both are ready for use. ``` **Prompt:** ``` Generate a video with replica 'rep_123' saying 'Hello, welcome to our platform!'. ``` **Response:** ``` Generation task started! Video ID is 'vid_789'. You can check the status in a few minutes to get the download link. ``` ## Capabilities ### Generate Video Assets Create new personalized talking-head videos by inputting a script and specifying which AI replica to use. ### Manage AI Replicas List all trained video replicas or retrieve detailed information about a specific clone's settings. ### Track Video Status Check the live progress of any video generation task to confirm when the content is ready for download. ### View Content Library Get a list of all your generated videos and their associated download links in one call. ### Delete Assets Permanently delete specific video files or trained replicas to clean up unused storage. ## Use Cases ### The Cold Outreach Blitz An SDR needs 50 unique videos for a cold list. Instead of recording, they tell their agent: 'Generate videos using replica 'Founder Clone' with the script about our new API.' The agent runs `generate_replica_video` multiple times and tracks all resulting video IDs. ### Cleaning Up Old Content A marketing manager finishes a campaign. They run `list_generated_videos` to see everything, find the old videos marked 'Q3 Campaign', and use `delete_video` on each one so they don't clutter the library. ### Pre-Flight Check Before generating anything, a user needs confirmation that their new clone is ready. They ask the agent to run `list_replicas`, confirm the ID, and then use `get_replica_details` to validate its status. ### Auditing Assets A team lead needs a full inventory of all video assets. They ask the agent to run `list_generated_videos`, which provides the list, and then they can use `get_video_details` on specific IDs for final review. ## Benefits - **Scale Personalized Content:** Don't manually record outreach. Use `generate_replica_video` to create custom, personalized video campaigns for hundreds of prospects instantly. - **Full Asset Lifecycle Control:** Keep your workflow clean. You can use `list_generated_videos`, inspect them with `get_video_details`, and then trash the old ones with `delete_video` when they're done. - **Instant Replica Audit:** Need to know if a clone is set up right? Use `list_replicas` or `get_replica_details` to check all your training assets without clicking through menus. - **Workflow Automation:** Your agent handles the status checks. Instead of waiting, it monitors generation tasks and alerts you when the video ID (like `vid_789`) is ready for download links. - **Predictable Output:** The clear separation between listing (`list_replicas`) and generating (`generate_replica_video`) means your agent always knows exactly which source clone to use. ## How It Works The bottom line is: You talk to your AI client, and it handles all the calls to Tavus for video operations. 1. Subscribe to this server and input your Tavus API Key (v2). 2. Instruct your agent using natural language, for example: 'List my available replicas.' 3. The agent executes the necessary tool call (e.g., `list_replicas`) and returns the data you need. ## Frequently Asked Questions **How do I list all my video clones using list_replicas?** Just tell your agent to 'List my replicas.' The `list_replicas` tool will run and show you every trained clone ID available in the system. **What is the difference between list_generated_videos and get_video_details?** `list_generated_videos` gives you a quick directory of all videos. Use `get_video_details` when you need deep info on one specific video, like its exact generation metadata. **Can I delete an old replica using delete_replica?** Yes. If a clone is retired and you won't use it again, run `delete_replica` to permanently remove it from your asset list. This keeps things clean. **What do I provide for generate_replica_video?** You must give the agent three things: the script content, and a specific replica ID (e.g., 'rep_123'). The tool needs these inputs to start. **How do I track if my video generation is finished?** After running `generate_replica_video`, ask the agent to check the status. It manages that background task and tells you when the content moves from 'pending' to 'ready'. **What key information do I need to use any tool, like `generate_replica_video`?** You must provide a valid Tavus API Key. The server needs this credential in your connection settings before it will execute any function calls or manage resources. **When I run `get_video_details`, what metadata fields should my agent expect to receive?** The tool returns comprehensive asset data, including the video's current status (e.g., processing, ready), its unique ID, and a link to the final generated file. **How does my agent handle rate limits when calling tools like `list_replicas`?** Your agent must check for HTTP 429 status codes. If it hits a limit, your client needs logic to pause and retry the request after a specified delay. **How do I create a replica?** Replicas currently must be initiated via the Tavus Dashboard or their specific training endpoints which require a source video. This agent allows you to manage and use existing replicas. **How long does video generation take?** Personalized video generation typically takes a few minutes depending on the length of the script. You can use the `get_video_details` tool to check if the status is 'completed'.