# GAN.ai MCP

> GAN.ai lets you automate personalized video marketing and sales outreach using your agent. Trigger thousands of unique videos at scale, monitor real-time generation status, and retrieve branded landing page links—all through natural conversation.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** generative-ai, personalized-video, video-marketing, sales-outreach, video-generation, campaign-automation

## Description

Stop manually uploading templates and waiting on dashboards. This MCP connects GAN.ai to your AI client so you can manage personalized video campaigns directly from your chat interface. You simply tell your agent who needs a video (e.g., John Doe) and which template to use, triggering the generation instantly. The system handles the complexity; you just get notified when it’s done. You can also pull detailed analytics or list all available video templates to make sure your outreach stays on brand. Because Vinkius hosts this MCP, you don't need a developer to set up complex API calls; you just talk to it naturally and watch your videos go live.

## Tools

### verify_api_connection
Confirms that your AI agent has active API access to the GAN.ai platform.

### generate_personalized_videos
Sends a request to generate large batches of customized videos using defined templates.

### generate_single_video
Creates one specific, personalized video based on given project parameters.

### get_workspace_info
Retrieves general information about your connected GAN.ai workspace.

### get_project_metadata
Fetches the detailed structure and variables for a specific video template.

### get_video_stats
Retrieves view counts and other engagement metrics for a given video ID.

### get_video_metadata
Gets specific details about a single video, such as its intended recipient or project name.

### get_generation_status
Checks the current status (pending, processing, complete) of any video generation job.

### list_landing_templates
Lists all available branded landing page templates associated with your account.

### list_video_projects
Retrieves a list of every video template and project you have set up in GAN.ai.

### list_generated_videos
Shows a history of all videos that have been generated, along with their status.

### list_configured_webhooks
Displays a list of webhooks configured to receive real-time generation notifications for your systems.

## Prompt Examples

**Prompt:** 
```
List all my available video projects in GAN.ai.
```

**Response:** 
```
Retrieving projects... I found 3 active projects: 'Welcome Message v2', 'Product Demo', and 'Follow-up Campaign'. Which template should we use?
```

**Prompt:** 
```
Generate a personalized video for 'John Doe' (johndoe@email.com) using project 'proj_123'.
```

**Response:** 
```
Generation triggered! I've successfully sent the request for John Doe. The Inference ID is 'inf_abc789'. I'll monitor its status for you.
```

**Prompt:** 
```
Check the status of video generation 'inf_abc789'.
```

**Response:** 
```
Checking status... The video for John Doe is 'Completed'! You can access the personalized landing page here: [Permalink].
```

## Capabilities

### Triggering bulk video generation
Send requests to generate thousands of unique, personalized videos based on project templates and data tags.

### Monitoring video processing status
Check if a video is pending, processing, or complete, getting real-time updates without visiting the GAN.ai dashboard.

### Retrieving project definitions
Fetch details on all available video templates and understand what variables (like names or locations) you can personalize.

### Getting campaign analytics
Pull view counts and engagement metrics for specific videos to measure how well your outreach is working.

### Listing video history
See a list of all previously generated videos, along with their current status.

## Use Cases

### A new lead needs a personalized 'welcome' video.
The SDR asks their agent: 'Generate a welcome video for Mark Johnson using the onboarding template.' The agent triggers generate_single_video, and the user gets an immediate Inference ID to track it. When complete, they get the link needed for the first follow-up email.

### The marketing team needs campaign performance data.
The Content Manager asks: 'What are the view counts and engagement stats for the Q2 product demo videos?' The agent calls get_video_stats, delivering a summary report without requiring manual export from the dashboard.

### Preparing for an annual sales summit.
The Growth Marketer asks: 'List all video projects and give me their variable definitions.' The agent uses list_video_projects and get_project_metadata, ensuring they can personalize every video needed before the event starts.

### Debugging webhook failures.
The Ops Engineer asks: 'Show me all active webhooks for GAN.ai.' The agent uses list_configured_webhooks to verify that the necessary real-time notification endpoints are correctly set up.

## Benefits

- Stop guessing if a video is ready. Use get_generation_status to check the live status of any campaign, whether it's pending or complete.
- Never manually update templates again. The list_video_projects tool lets you see every available project and pull its structure using get_project_metadata for easy reference.
- Get immediate ROI data. Run get_video_stats to fetch view counts and engagement metrics, letting you measure campaign success directly in your chat flow.
- Manage outreach without context switching. Trigger personalized videos for multiple leads at once with generate_personalized_videos, keeping everything within your AI client.
- Know exactly where the video lands. Use list_landing_templates to retrieve branded permalinks right away, ensuring your follow-up sequences are always accurate.

## How It Works

The bottom line is you manage complex video campaigns and data retrieval by simply conversing with your AI client.

1. Connect your AI agent to this MCP in the Vinkius Marketplace and enter your GAN Workspace ID and API Token.
2. Tell your agent what you need. For example, ask it to generate a video for 'Jane Smith' using the 'Follow-up Campaign' template.
3. The system processes the request; later, prompt your agent again to get the status or retrieve the final link once generation is complete.

## Frequently Asked Questions

**How do I start a bulk video campaign with GAN.ai MCP?**
You trigger it by asking your agent to use generate_personalized_videos, specifying the project ID and the list of recipients you want to target.

**Can I check the status of a single video generation using GAN.ai MCP?**
Yes, simply ask your agent to run get_generation_status and provide the Inference ID for the job you are tracking.

**What kind of data can I retrieve about my campaigns with GAN.ai MCP?**
You can fetch engagement metrics using get_video_stats, or see which templates exist by calling list_video_projects.

**Do I need to know API tokens to use the GAN.ai MCP?**
Yes, you must provide your Workspace ID and API Token when setting up the connection through Vinkius for the agent to authenticate the requests.

**How does GAN.ai MCP help with landing pages?**
You can list available branded landing page templates using list_landing_templates, ensuring your video outreach always links to the correct destination.