Placid.app MCP Server

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)

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

Manual Configuration

{
  "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

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

• 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

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

• 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

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

• 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

License