Placid.app

What is placid-mcp-server?

placid-mcp-server is an MCP (Model Context Protocol) server implementation designed to integrate with Placid.app's API. It allows users to generate image and video creatives programmatically using Placid.app templates within MCP-compatible environments like Claude Desktop or Cline.

How to use placid-mcp-server?

Requirements: Node.js (version 18 or higher) and npm.

Installation:

• Quick Start (Recommended): Use Smithery CLI:

  npx -y @smithery/cli install @felores/placid-mcp-server --client claude
  

• Manual Configuration: Add the following to your Claude Desktop or Cline settings:

  {
    "mcpServers": {
      "placid": {
        "command": "npx",
        "args": ["@felores/placid-mcp-server"],
        "env": {
          "PLACID_API_TOKEN": "your-api-token"
        }
      }
    }
  }
  

Getting Your Placid API Token:

1. Log in to your Placid.app account.
2. Go to Settings > API.
3. Click "Create API Token," give it a name, and copy the generated token.
4. Add the token to your configuration as shown above.

Development:

• Run in development mode with hot reload: npm run dev
• Run tests: npm test

Tools/Functions:

• placid_list_templates: Lists available Placid templates with filtering options (by collection_id, custom_data, tags). Returns template uuid, title, thumbnail, layers, and tags.
• placid_generate_video: Generates videos using Placid templates and dynamic content (video, image, text layers). Supports optional audio and audio trimming. Returns status, video_url, and job_id.
• placid_generate_image: Generates static images using Placid templates and dynamic content (text, image layers). Returns status and image_url.

Key Features of placid-mcp-server

• Integration with Placid.app API for creative generation.
• Support for Model Context Protocol (MCP).
• Ability to list Placid templates with filtering.
• Generation of both images and videos from templates.
• Dynamic content injection into template layers.
• Secure API token management.
• Error handling and validation.
• Type-safe implementation.

Use Cases of placid-mcp-server

• Automated generation of social media graphics.
• Creating personalized marketing visuals at scale.
• Generating dynamic video ads based on data.
• Integrating creative generation into AI workflows and applications.
• Programmatic creation of visual content for various platforms.

FAQ from placid-mcp-server

Q: What are the requirements to run placid-mcp-server? A: You need Node.js (version 18 or higher) and npm installed.

Q: How do I get my Placid API token? A: Log in to your Placid.app account, go to Settings > API, and create a new API token.

Q: Can I filter templates when listing them? A: Yes, you can filter templates by collection_id, custom_data, and tags using the placid_list_templates function.

Q: What kind of content can I use in my templates? A: You can use dynamic video, image, and text content for your template layers.

Q: How do I handle long video generation times? A: For longer videos, you will receive a job_id which you can use to check the status in your Placid dashboard.

Placid.app MCP Server

An MCP server implementation for integrating with Placid.app's API. This server provides tools for listing templates and generating images and videos through the Model Context Protocol.

Features

• List available Placid templates with filtering options
• Generate images and videos using templates and dynamic content
• Secure API token management
• Error handling and validation
• Type-safe implementation

Requirements: Node.js

1. Install Node.js (version 18 or higher) and npm from nodejs.org
2. Verify installation:

   node --version
   npm --version
   

Installation

Quick Start (Recommended)

The easiest way to get started is using Smithery, which will automatically configure everything for you:

npx -y @smithery/cli install @felores/placid-mcp-server --client claude

Manual Configuration

If you prefer to configure manually, add this to your Claude Desktop or Cline settings:

{
  "mcpServers": {
    "placid": {
      "command": "npx",
      "args": ["@felores/placid-mcp-server"],
      "env": {
        "PLACID_API_TOKEN": "your-api-token"
      }
    }
  }
}

Getting Your Placid API Token

1. Log in to your Placid.app account
2. Go to Settings > API
3. Click on "Create API Token"
4. Give your token a name (e.g., "MCP Server")
5. Copy the generated token
6. Add the token to your configuration as shown above

Development

# Run in development mode with hot reload
npm run dev

# Run tests
npm test

Tools

placid_list_templates

Lists available Placid templates with filtering options. Each template includes its title, ID, preview image URL, available layers, and tags.

Parameters

• collection_id (optional): Filter templates by collection ID
• custom_data (optional): Filter by custom reference data
• tags (optional): Array of tags to filter templates by

Response

Returns an array of templates, each containing:

• uuid: Unique identifier for the template
• title: Template name
• thumbnail: Preview image URL (if available)
• layers: Array of available layers with their names and types
• tags: Array of template tags

placid_generate_video

Generate videos by combining Placid templates with dynamic content like videos, images, and text. For longer videos (>60 seconds processing time), you'll receive a job ID to check status in your Placid dashboard.

Parameters

• template_id (required): UUID of the template to use
• layers (required): Object containing dynamic content for template layers
  • For video layers: { "layerName": { "video": "https://video-url.com" } }
  • For image layers: { "layerName": { "image": "https://image-url.com" } }
  • For text layers: { "layerName": { "text": "Your content" } }
• audio (optional): URL to an mp3 audio file
• audio_duration (optional): Set to 'auto' to trim audio to video length
• audio_trim_start (optional): Timestamp of trim start point (e.g. '00:00:45' or '00:00:45.25')
• audio_trim_end (optional): Timestamp of trim end point (e.g. '00:00:55' or '00:00:55.25')

Response

Returns an object containing:

• status: Current status ("finished", "queued", or "error")
• video_url: URL to download the generated video (when status is "finished")
• job_id: ID for checking status in Placid dashboard (for longer videos)

Example Usage for LLM models

{
  "template_id": "template-uuid",
  "layers": {
    "MEDIA": { "video": "https://example.com/video.mp4" },
    "PHOTO": { "image": "https://example.com/photo.jpg" },
    "LOGO": { "image": "https://example.com/logo.png" },
    "HEADLINE": { "text": "My Video Title" }
  },
  "audio": "https://example.com/background.mp3",
  "audio_duration": "auto"
}

placid_generate_image

Generate static images by combining Placid templates with dynamic content like text and images.

Parameters

• template_id (required): UUID of the template to use
• layers (required): Object containing dynamic content for template layers
  • For text layers: { "layerName": { "text": "Your content" } }
  • For image layers: { "layerName": { "image": "https://image-url.com" } }

Response

Returns an object containing:

• status: "finished" when complete
• image_url: URL to download the generated image

Example Usage for LLM models

{
  "template_id": "template-uuid",
  "layers": {
    "headline": { "text": "Welcome to My App" },
    "background": { "image": "https://example.com/bg.jpg" }
  }
}

Documentation

For more detailed information about the Placid API, visit the Placid API Documentation.

License

MIT