🎬 Creatify MCP Server

> The ultimate MCP server for AI video generation - Bringing Creatify AI's powerful video creation capabilities to every AI assistant in the MCP ecosystem.

🌟 Overview

The Creatify MCP Server is a comprehensive Model Context Protocol (MCP) server that exposes the full power of Creatify AI's video generation platform to AI assistants, chatbots, and automation tools. Built on top of the robust @tsavo/creatify-api-ts TypeScript client library, this server transforms complex video creation workflows into simple, natural language interactions.

🎨 Advanced MCP Features:

- 📝 Prompts - Reusable video creation templates and workflows - 📊 Logging - Structured logging with multiple severity levels - 🔍 Progress Tracking - Real-time updates during video generation - 🤖 AI Self-Help - how_to_use tool for AI assistants to understand parameters - 📊 Notifications - Real-time status updates and progress notifications

🎯 What This Enables

Imagine telling Claude Desktop: "Create a 16:9 avatar video of Anna saying 'Welcome to our product demo' and wait for it to complete" - and having it actually happen. That's the power of this MCP server.

🏗️ Built With

- Creatify AI API - The world's leading AI video generation platform
- @tsavo/creatify-api-ts - Comprehensive TypeScript client library
- Model Context Protocol - Standardized AI assistant integration
- TypeScript - Full type safety and excellent developer experience

Features

🛠️ MCP Tools (12 powerful actions)

- create_avatar_video - Create AI avatar videos with lip-sync - create_url_to_video - Convert websites into professional videos - generate_text_to_speech - Generate natural-sounding speech from text - create_multi_avatar_conversation - Create videos with multiple avatars having conversations - create_custom_template_video - Generate videos using custom templates - create_ai_edited_video - Automatically edit and enhance videos - create_ai_shorts - Create short-form videos (perfect for TikTok, Instagram Reels) - generate_ai_script - Generate AI-powered scripts for videos - create_custom_avatar - Design and create your own custom avatars (DYOA) - manage_music - Upload, manage, and use background music - create_advanced_lipsync - Advanced lip-sync with emotion and gesture control - how_to_use - Get detailed usage information for any tool - get_video_status - Check the status of video generation tasks

📚 MCP Resources (6 data sources)

- creatify://avatars - List of available AI avatars - creatify://voices - List of available voices for text-to-speech - creatify://templates - Available custom video templates - creatify://music - Available background music library - creatify://credits - Remaining API credits - creatify://avatar/{avatarId} - Detailed information about specific avatars

🏆 Why Choose Creatify MCP Server?

🚀 Complete API Coverage

- ✅ 12 MCP Tools covering 100% of Creatify API functionality - ✅ 6 MCP Resources for comprehensive data access - ✅ 5 Workflow Prompts for common video creation scenarios - ✅ Enterprise-grade logging with 8 severity levels

🤖 AI-First Design

- ✅ Self-documenting with how_to_use tool for AI assistants - ✅ Intelligent parameter validation and error handling - ✅ Real-time progress updates during video generation - ✅ Semantic versioning with automated releases

🎨 Advanced Features

- ✅ Emotion & gesture control in advanced lip-sync - ✅ Custom avatar creation (DYOA - Design Your Own Avatar) - ✅ AI-powered script generation for any video type - ✅ Short-form video optimization for TikTok/Instagram/YouTube - ✅ Background music management and integration

💼 Production Ready

- ✅ TypeScript for type safety and better IDE support - ✅ Comprehensive error handling with detailed context - ✅ Professional logging for monitoring and debugging - ✅ Automated testing and continuous integration - ✅ Semantic versioning for reliable updates

📝 MCP Prompts (5 workflow templates)

- create-product-demo - Professional product demonstration workflow - create-social-content - Engaging social media content creation - create-educational-video - Educational and tutorial video workflow - create-marketing-campaign - Marketing campaign video creation - analyze-video-performance - Video performance analysis and optimization

Prerequisites

- Node.js 18 or higher
- Creatify API credentials (Pro plan or higher)
- Get your API credentials from Creatify account settings

Installation

From npm (recommended)

npm install -g @tsavo/creatify-mcp

From source

git clone https://github.com/TSavo/creatify-mcp.git
cd creatify-mcp
npm install
npm run build
npm link

🎬 Live Demo Examples

Create an AI Avatar Video

User: "Create a professional avatar video with Anna saying 'Welcome to our company!' in 16:9 format"
Claude: I'll create a professional avatar video for you using the Creatify MCP Server.
[Uses create_avatar_video tool with:

- text: "Welcome to our company!"

- avatarId: "anna_costume1_cameraA"

- aspectRatio: "16:9"

- voiceId: "en-US-AriaNeural"]
Your professional avatar video has been created! Anna delivers your message with natural lip-sync and professional presentation.

Generate TikTok-Style Short Video

User: "Make a 30-second TikTok video about coffee brewing tips"
Claude: I'll create an engaging short-form video perfect for TikTok!
[Uses create_ai_shorts tool with:

- prompt: "Quick coffee brewing tips with energetic presentation"

- aspectRatio: "9:16"

- duration: 30

- style: "energetic"]
Your TikTok-ready short video is being generated with optimal 9:16 aspect ratio and engaging content!

Convert Website to Video

User: "Turn my product landing page into a marketing video"
Claude: I'll convert your website into a compelling marketing video.
[Uses create_url_to_video tool with:

- url: "https://yourproduct.com"

- aspectRatio: "16:9"

- style: "marketing"]
Your landing page has been transformed into a professional marketing video showcasing your product!

AI-Powered Script Generation

User: "Generate a script for a 60-second product demo video"
Claude: I'll create a compelling script for your product demo.
[Uses generate_ai_script tool with:

- topic: "Product demonstration video"

- scriptType: "commercial"

- duration: 60

- tone: "professional"]
Your script is ready! It includes engaging hooks, clear value propositions, and a strong call-to-action optimized for 60-second format.

Configuration

Set your Creatify API credentials as environment variables:

export CREATIFY_API_ID="your-api-id"
export CREATIFY_API_KEY="your-api-key"

Or create a .env file:

CREATIFY_API_ID=your-api-id

CREATIFY_API_KEY=your-api-key

Usage

With Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "creatify": {
      "command": "creatify-mcp",
      "env": {
        "CREATIFY_API_ID": "your-api-id",
        "CREATIFY_API_KEY": "your-api-key"
      }
    }
  }
}

🎨 Advanced MCP Features

📝 Using Prompts (Workflow Templates)

AI assistants can now use predefined workflow templates for common video creation scenarios:

Example: Product Demo Workflow

User: "Use the create-product-demo prompt for 'Amazing Widget' with features 'fast, reliable, easy to use' targeting small business owners"

Claude: I'll use the product demo workflow template to create a professional demonstration video.
[Claude automatically follows the complete workflow:

1. Generates an engaging script using generate_ai_script

2. Creates avatar video using create_avatar_video

3. Optimizes for the target audience

4. Includes clear call-to-action]

Available Prompt Templates:
- create-product-demo - Professional product demonstrations
- create-social-content - TikTok/Instagram/YouTube content
- create-educational-video - Tutorials and educational content
- create-marketing-campaign - Marketing and promotional videos
- analyze-video-performance - Video optimization and analysis

📊 Real-time Logging & Progress

The server provides structured logging with multiple severity levels:

[INFO] Creatify MCP Server initialized
[INFO] Creating avatar video {avatarId: "anna_costume1_cameraA", aspectRatio: "16:9"}
[INFO] Waiting for avatar video completion...
[INFO] Avatar video completed {videoId: "video_abc123"}

Log Levels: debug, info, notice, warning, error, critical, alert, emergency

🤖 AI Self-Help System

AI assistants can now understand tool parameters better using the how_to_use tool:

Claude: Let me check how to use the avatar video tool...
[Calls how_to_use tool with toolName: "create_avatar_video"]
[Gets comprehensive documentation with:

- Required parameters with descriptions

- Optional parameters with usage notes

- Real code examples

- Tips and best practices]
Now I understand exactly how to create your avatar video!

With Custom MCP Client

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
const transport = new StdioClientTransport({

  command: "creatify-mcp",

  env: {

    CREATIFY_API_ID: "your-api-id",

    CREATIFY_API_KEY: "your-api-key"

  }

});
const client = new Client({

  name: "my-client",

  version: "1.0.0"

});
await client.connect(transport);
// List available tools

const tools = await client.listTools();

console.log("Available tools:", tools.tools.map(t => t.name));
// Create an avatar video

const result = await client.callTool({

  name: "create_avatar_video",

  arguments: {

    text: "Hello, world! This is an AI-generated video.",

    avatarId: "anna_costume1_cameraA",

    aspectRatio: "16:9",

    waitForCompletion: true

  }

});

Standalone Server

```bash