# Alai MCP MCP

> Alai MCP connects your AI client to professional headshot and marketing asset generation at scale. It transforms simple selfies into studio-quality portraits, giving you full programmatic control over generating, monitoring, and managing high-fidelity content portfolios for campaigns.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** content-generation, ai-portraits, asset-management, marketing-assets, cloud-orchestration, high-fidelity-media

## Description

This connector lets you run your entire marketing content pipeline without lifting a finger. Instead of manually submitting images or jumping between creation tools to check status, your agent handles the whole process through natural conversation. You can ask it to list every asset in your portfolio or trigger an entirely new campaign based on existing metadata. It acts like a dedicated content coordinator for high-fidelity media. When you connect this MCP via Vinkius, your AI client gains access to deep operational data—you check generation status, manage the underlying templates, and even delete old assets if they aren't needed anymore. The whole point is simple: generate professional marketing collateral and keep track of every single piece using only simple commands.

## Tools

### check_getalai_status
Verifies that your API connection to Alai is currently active and functioning.

### create_asset
Creates a new marketing asset record within the system for later retrieval or management.

### create_campaign
Initiates a new, structured marketing campaign designed to use multiple assets together.

### delete_asset
Removes specific assets from your portfolio when they are no longer needed or relevant.

### generate_content
Runs the core AI function to create new marketing images or text based on defined parameters.

### get_asset
Retrieves full, detailed information about a specific asset by its ID.

### get_campaign
Fetches all details and status updates for a previously created campaign.

### get_generation
Gets detailed information about a specific content generation job run.

### list_assets
Lists all existing assets in your portfolio, providing basic metadata for quick review.

### list_campaigns
Retrieves a list of all defined marketing campaigns and their current status.

### list_generations
Lists all historical content generation jobs run through the system.

### list_templates
Retrieves a list of available content templates that can be used for new assets.

## Prompt Examples

**Prompt:** 
```
List all active marketing campaigns in my Alai account.
```

**Response:** 
```
I've retrieved your campaigns. You currently have 5 active high-fidelity profiles, including 'Social Media Push' and 'Email Blast B'. Would you like the detailed platform metadata for any of them?
```

**Prompt:** 
```
Show the last 5 assets generated for 'Social Media Push'.
```

**Response:** 
```
Asset directory orchestrated! For 'Social Media Push', I've identified 5 recent high-fidelity assets, including 3 images and 2 text posts. I've retrieved the technical creation metadata for your review. Need help retrieving the final hosted URLs?
```

**Prompt:** 
```
Check for any content generation jobs in 'Processing' status.
```

**Response:** 
```
Operational monitoring orchestrated! I've identified 2 high-fidelity jobs currently in 'Processing' status, including 'Banner A' and 'Blog Post B'. Your API connection is healthy. Shall I notify you once these assets are ready for distribution?
```

## Capabilities

### Track asset availability
Check the real-time status of generated content, knowing immediately if assets are ready for distribution.

### Build and manage campaigns
Define structured marketing efforts and initiate entire campaigns programmatically to deploy multiple types of creative assets.

### Generate new content batches
Trigger the creation of entirely new AI-generated images or text based on defined prompts and templates.

### View asset inventory
Retrieve a complete, detailed list of all existing marketing assets in your portfolio for auditing or selection.

### Manage generation jobs
Monitor the progress of ongoing content creation tasks and retrieve detailed reports on job metadata.

## Use Cases

### Launching a new product line
The Growth Lead needs 50 variations of a hero image by end-of-day. Instead of creating 50 separate prompts, they ask their agent to use `generate_content` with the defined templates and then uses `list_assets` to confirm all 50 pieces are successfully created.

### Quarterly audit cleanup
The Content Operations Lead needs to prune old, unused marketing materials. They query the system to find assets that haven't been touched in six months and then use `delete_asset` on batches of files.

### Monitoring campaign rollout
A Marketing Manager asks their agent, 'What is the status of the Q3 launch?' The agent checks `list_campaigns`, sees the details for 'Q3 Launch,' and reports that all required assets are either ready or in 'Processing' status.

## Benefits

- Stop guessing if content is ready. Using `list_assets` gives you an immediate, programmatically retrieved inventory of every piece in your portfolio.
- Don't build campaigns manually. You can use `create_campaign` to structure and deploy coordinated marketing efforts that rely on multiple assets.
- Skip the manual generation queues. Simply call `generate_content` via your agent to trigger new, high-fidelity content jobs instantly.
- Need an audit trail? Use `list_generations` or check details with `get_generation` to track exactly when and how every piece of content was created.
- Maintain clean data by using `delete_asset` to remove obsolete files. This ensures your asset records stay accurate for future campaigns.

## How It Works

The bottom line is you get programmatic access to Alai's entire content management system through simple conversations with your AI client.

1. Subscribe to this MCP and grab your API Key from the Alai dashboard.
2. Connect your AI client (like Cursor or Claude) using the Vinkius catalog.
3. Ask your agent to perform an action, like listing all campaigns or generating a new asset. It handles the rest.

## Frequently Asked Questions

**How do I find my Alai API Key?**
Log in to your account, navigate to **Settings** > **API**, and copy your unique access token from the credentials section.

**Can I retrieve generated assets via AI?**
Yes! The `list_alai_assets` tool allows your agent to retrieve high-fidelity metadata and hosted URLs for all your AI-generated content.

**How do I list my active campaigns?**
Use the `list_alai_campaigns` tool to retrieve your complete high-fidelity directory along with the unique identifiers for all managed marketing workstreams.

**How do I check my API connection status using the `check_getalai_status` tool?**
It verifies your live connectivity to Alai. If the tool returns an error, it means there's a problem with your credentials or permissions; double-check your API key and account settings.

**What is the proper way to start tracking a new marketing effort using `create_campaign`?**
You initiate it by calling `create_campaign`. This action establishes the campaign structure in Alai, which then prepares your dedicated content pipeline for future assets.

**If I need to remove old or unused media, should I use the `delete_asset` tool?**
Yes, you can programmatically delete specific assets. Using this tool ensures your overall media record stays clean by permanently removing assets based on their unique content IDs.

**How do I generate a large batch of images using `generate_content`?**
You provide the parameters for all desired content in one query. The agent handles the job queue, ensuring all items are processed and tracking each individual generation's progress.

**If I only know an asset's ID, how do I get its full technical history using `get_asset`?**
Use `get_asset` with the specific content ID. This pulls comprehensive platform metadata, including creation status and historical records, allowing for precise review.