# zipperHQ MCP > zipperHQ MCP manages your entire video email workflow through natural language conversation. It lets you list, track, and analyze high-fidelity videos—from monitoring specific view durations to checking if recordings are stuck in 'Pending' status. Use it to automate personalized messaging campaigns. ## Overview - **Category:** communication-messaging - **Price:** Free - **Tags:** video-email, personalized-messaging, engagement-tracking, procurement-management, spend-visibility, vendor-relations ## Description This connector gives your AI agent full command over your video content pipeline. Instead of jumping between dashboards just to check engagement metrics, you simply ask your client about your campaign performance. You can get a complete list of all high-fidelity videos, track which contacts have viewed them, and even find out exactly how long they watched the latest message. If your team needs to maintain a tight content schedule, this MCP monitors recording statuses in real time—telling you if a video is ready or stuck. You can search for specific videos by keyword, pull account details, or get detailed analytics on any piece of content. Because every single tool call runs within the secure V8 isolate sandbox provided by Vinkius, your credentials never leave that zero-trust proxy layer; they're only used in transit. Plus, with Vinkius AI Analytics, you see exactly which data points flowed through and how much budget was used—nothing happens in the dark. ## Tools ### check_zipper_status Verifies if your API connection to zipperHQ is working correctly. ### get_contact_views Pulls the specific video view data for one single person or contact. ### get_account Retrieves general information about your entire zipperHQ account. ### get_video_analytics Gathers detailed metrics, like completion percentage and viewing duration, for a given video. ### get_video Retrieves full technical details for one specific video email by its ID. ### list_contacts Provides a list of all recipients who have received videos from your account. ### list_recordings Shows you a comprehensive list of every screen recording file and its current status. ### list_videos Lists all video emails that have been created or sent out through the service. ### get_recent_videos Gets a list of the ten most recently created videos in your account. ### search_videos Finds videos in your library by matching keywords you provide. ## Prompt Examples **Prompt:** ``` List all video emails sent today in my zipperHQ account. ``` **Response:** ``` I've retrieved your video emails. You currently have 5 high-fidelity transmissions today, including 'Welcome Message' for 'John Doe'. Would you like the detailed engagement metadata for any of them? ``` **Prompt:** ``` Show the view duration for the last video sent to 'Acme Corp'. ``` **Response:** ``` Engagement intelligence orchestrated! For Acme Corp, I've verified that the high-fidelity video was watched for 2:30 (90% completion). I've retrieved the technical session metadata for your review. Need help drafting a follow-up email? ``` **Prompt:** ``` Check for any video emails with 'Pending' recording status. ``` **Response:** ``` Recording architecture orchestrated! I've identified 2 high-fidelity video emails currently in 'Pending' status, including 'Contract Update' for 'Jane Client'. I've retrieved the technical session IDs for your review. Shall I notify the team to complete these recordings? ``` ## Capabilities ### Get a complete list of videos Retrieve all video emails associated with your account, allowing you to manage your entire content library programmatically. ### Check contact view history Track specific recipient interactions by pulling details like when and how long a contact viewed a personalized video message. ### Monitor recording status Verify the current state of your content pipeline, confirming if recordings are pending upload, ready to send, or available for review. ### Search videos by topic Find specific video messages across your library using simple text keywords. ### Get account status Verify the API connection and monitor overall usage volume to ensure your service scaling is working correctly. ## Use Cases ### The Sales Follow-Up A sales rep needs to know if a prospect watched the 'Q3 Pricing' video. Instead of checking the dashboard, they ask their agent to use `get_contact_views` for that contact. The agent replies with the exact view duration and completion percentage. ### The Content Audit A marketing manager needs to know how many videos were sent last month related to 'product integration'. They ask their agent to use `search_videos` and then follow up with the `list_videos` tool for a complete, filtered count. ### The Campaign Readiness Check A content creator needs to launch 10 videos by Friday. They ask their agent to use `list_recordings` to find all items currently stuck in 'Pending' status, allowing them to prioritize the team’s efforts. ### The Account Health Check A developer needs to ensure the entire data pipeline is working before a major launch. They ask their agent to run `check_zipper_status` and immediately follow up with `get_account` to validate overall usage volume. ## Benefits - Stop manually checking individual view counts. Use the `get_video_analytics` tool to pull instant metrics like viewing duration for any specific campaign. - Keep your content pipeline moving. The MCP monitors recording statuses (Pending, Uploaded, Ready) so you never send a video that isn't fully ready. - Track exactly who saw what. With `list_contacts` and `get_contact_views`, you know which leads interacted with the latest messaging immediately. - Save time finding content. Use `search_videos` to pinpoint specific campaigns or topics across your entire video library instantly. - Maintain a clean record. The MCP gives you full access to metadata, letting you pull detailed session IDs and video durations for auditing purposes. ## How It Works The bottom line is, your AI agent acts as a dedicated video content coordinator, replacing manual dashboard checks with natural conversation. 1. First, subscribe to this MCP and pull your unique API key from your zipperHQ dashboard. 2. Next, point your AI client to the Vinkius platform using that key. Your agent can now access all video data. 3. Finally, ask your agent a question—like 'Show me all videos sent last week'—and it handles the complex retrieval and reporting for you. ## Frequently Asked Questions **How do I check if my video recording is ready using `list_recordings`?** Run `list_recordings`. The tool will display the status for every item, letting you instantly see which videos are 'Pending' versus those that are fully 'Ready'. **Can I find out how long a specific contact watched using `get_contact_views`?** Yes. You just need to provide the contact ID. The tool returns detailed metrics, including the exact duration and percentage of completion for that video. **What is the difference between `list_videos` and `search_videos`?** `list_videos` gives you a simple roster of everything sent. Use `search_videos` when you need to narrow down that list by specific content keywords or topics. **How do I check the overall health using `check_zipper_status`?** Simply call the `check_zipper_status` tool. This confirms your API connection is active and running, which is a quick safety check before any major workflow run. **What information do I get when I use `get_account`?** This tool provides your general account credentials and operational limits. It’s a quick check to confirm connectivity, usage volume, and overall billing status before running complex reports. **If I need detailed performance metrics for one video, should I use `list_videos` or `get_video_analytics`?** `List_videos` gives you the titles and basic metadata for multiple videos. Use `get_video_analytics` when you need deep reporting on a single video's engagement, including detailed metrics like view counts over time. **When I run `list_contacts`, are there any limits on how many recipient records I can pull at once?** The tool supports bulk data retrieval for your contact list. However, if you have thousands of recipients, remember to handle pagination or chunking in your agent's workflow to prevent API throttling errors. **What is the most efficient way to find a specific video using `search_videos` versus just listing all videos with `list_videos`?** `Search_videos` is much faster because it filters results by keyword immediately. Don't use `list_videos` if you know what you're looking for; searching saves time and tokens. **How do I find my zipperHQ API Key?** Log in to your account, navigate to **Settings** > **API**, and copy your unique access token from the credentials section. **Can I check video recording status via AI?** Yes! The `list_videos` tool allows your agent to retrieve status metadata for all your video emails. **How do I list my sent videos?** Use the `list_videos` tool to retrieve your complete video directory along with the unique identifiers for all managed assets.