# Videco MCP > Videco lets you manage personalized video campaigns, from creation to lead capture, using your AI agent. You can generate custom videos from templates, launch targeted marketing campaigns, and pull detailed analytics on views, watch time, and lead engagement scores instantly. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** video-campaigns, personalized-video, lead-tracking, audience-targeting, video-analytics, sales-engagement ## Description Connect your Videco account to any AI client to handle your entire video content lifecycle through natural conversation. Need to know who saw what? You can list all existing assets or drill down into campaign specifics. The system generates personalized videos from templates, letting you quickly scale up prospecting material. Beyond creation, you control the full marketing funnel: launch campaigns with specific audience targeting and monitor every lead captured from video interactions. This setup makes sure nothing falls through the cracks. When you combine this MCP with a CRM or billing MCP, for example, your agent can build an automated workflow that moves data—like a newly engaged lead ID—from the campaign tool directly into another service. Because Vinkius manages all calls inside secure isolated sandboxes, your credentials pass through a zero-trust proxy; they never sit on a disk. You just talk to your agent, and it handles the complexity. ## Tools ### check_videco_status Verifies if the Videco API connection is working correctly. ### create_campaign Sets up a new video campaign targeting specific audiences. ### create_video Generates a brand-new personalized video from an existing template library. ### get_video_analytics Pulls detailed performance metrics for any given video, including watch time and click rates. ### get_campaign Retrieves detailed information about a specific campaign by its ID. ### get_lead Fetches the full details for an individual lead record, including their engagement score. ### get_video Gets specific metadata about a single video asset in your library. ### list_campaigns Retrieves a list of all active or past campaigns you've run. ### list_leads Lists all leads that have interacted with your video content. ### list_videos Retrieves a list of every personalized and template video you own. ## Prompt Examples **Prompt:** ``` List all my personalized videos. ``` **Response:** ``` You have 12 videos. The most viewed is 'Welcome Onboarding' with 3,400 views (4.2% CTR). 3 videos were created this month. Would you like analytics for any video? ``` **Prompt:** ``` Show analytics for video VID-2048. ``` **Response:** ``` Video VID-2048 'Product Demo': 1,200 views, avg watch time 2:34, completion rate 68%, CTA click rate 5.1%. 42 leads captured. Best performing day: Tuesday. Want to see lead details? ``` **Prompt:** ``` Create a campaign called 'Spring Launch' with video VID-2048. ``` **Response:** ``` Campaign 'Spring Launch' created with video VID-2048. Campaign ID: CMP-891. Ready to deploy. Would you like to set a target audience or schedule? ``` ## Capabilities ### View and manage video assets List all videos in your library or retrieve specific details about any single video by its ID. ### Launch and track campaigns Create new, monitored video campaigns and view their overall performance metrics against defined goals. ### Capture and review leads Access a list of all captured leads, including detailed engagement scores tied directly to the content they viewed. ### Analyze video performance Get deep metrics on any video, showing things like total views, average watch time, and drop-off points for optimization. ### Generate new content Instantly create a personalized video asset by selecting an existing template and inputting custom data. ## Use Cases ### The SDR needs to qualify a high-value prospect. Instead of cold calling, the agent uses `get_lead` to check a prospect's history. It then uses `create_video` with their company data, sending it out for review and tracking the engagement score. ### The Marketing team is launching Q3 product education. They use the agent to run `list_campaigns`, check performance via `get_campaign`, and then adjust targeting based on which segments are showing high views. ### Customer Success needs to onboard a new client group. The agent runs a campaign using `create_video` with the client's name. Later, they use `list_videos` to track completion rates and ensure all required training assets were delivered. ### A Campaign Manager needs a performance audit. They ask the agent to run `get_video_analytics` on the top-performing video, immediately seeing average watch time and identifying which specific CTAs drove the most clicks. ## Benefits - Stop guessing about content performance. Use `get_video_analytics` to see detailed metrics like drop-off points and CTA click rates for every asset. - Accelerate outreach with `create_video`. Instead of manually building videos, you pass data through the tool and get a personalized asset instantly. - Close the loop on marketing spend. After running a campaign with `list_campaigns`, your agent can cross-reference results with `get_lead` to see exactly who was interested. - Never miss a contact again. The MCP handles all lead capture; just ask the agent to use `list_leads` and get a clean list of new contacts ready for follow-up. - Streamline your content pipeline by using `create_campaign`. You set parameters, and the tool manages deployment across target audiences. ## How It Works The bottom line is you talk naturally to your agent, and it handles the complex API calls to Videco for you. 1. Subscribe to this MCP on Vinkius and retrieve your API key from your Videco account settings. 2. Connect the MCP to any compatible AI client (like Cursor or Claude) using that single key. 3. Start by asking your agent a question, like 'List all my campaigns,' and watch it execute the calls in real time. ## Frequently Asked Questions **How do I start a new marketing campaign using `create_campaign`?** You first need to tell your agent what the goal is and who the audience is. The tool then uses those parameters to set up the deployment schedule and targeting rules. **`list_leads` gives me names, but how do I find out if they're qualified?** You need to run `get_lead` on a specific lead ID. That tool provides detailed information, including an engagement score that tells you their current status. **Can I see analytics for multiple videos at once using `get_video_analytics`?** The tool retrieves metrics for one video at a time. For a full report, list the relevant assets with `list_videos`, then ask the agent to run `get_video_analytics` sequentially. **Do I need an API key just to use `check_videco_status`?** Yes. The MCP requires an API Key for all calls, even status checks. This ensures the agent can validate connectivity before attempting any write operations. **When using `list_videos`, how can I filter the output by date range or status?** The function accepts filtering parameters in its input payload. You specify criteria like `start_date` or `status=draft`. This lets your agent narrow down results, grabbing only videos that match specific requirements and keeping the data focused. **If I run `get_campaign` and the campaign status is 'failed', what information do I get?** The response includes a dedicated error log section. This log specifies the failure code, the exact step that failed in the process, and often provides an actionable message explaining how to correct it. **After using `get_lead`, how can I find out which video generated that lead?** The detailed lead object contains a field called `source_video_id`. Your agent reads this ID to directly link the captured lead back to its originating personalized video asset, making attribution simple. **How is my data secured when using `create_video` via your agent?** All tool calls execute through Vinkius' zero-trust proxy. This means credentials are used only in transit and never stored on disk, keeping your connection secure regardless of which compatible client you use. **How do I create a personalized video via AI?** Use the `create_video` tool with a name and template ID. The personalized video is generated instantly from your Videco templates. **Can I track video engagement and leads?** Yes. Use `get_video_analytics` for views, watch time, and CTR, and `list_leads` to see all captured lead contacts with engagement scores. **How do I create and manage video campaigns?** Use `create_campaign` with a name and video ID to launch a campaign, then `list_campaigns` and `get_campaign` to track performance.