Placid.app

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
```\n\n### Manual Configuration
If you prefer to configure manually, add this to your Claude Desktop or Cline settings:
```json
{
  "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

npm run dev\n\n# 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.\n\n#### 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\n\n#### 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.\n\n#### Parameters

• template_id (required): UUID of the template to use
• layers (required): Object containing dynamic content for template layers
• audio (optional): URL to an mp3 audio file
• audio_duration (optional): Set to 'auto' to trim audio to video length\n\n#### 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)

placid_generate_image

Generate static images by combining Placid templates with dynamic content like text and images.\n\n#### Parameters

• template_id (required): UUID of the template to use
• layers (required): Object containing dynamic content for template layers\n\n#### Response Returns an object containing:
• status: "finished" when complete
• image_url: URL to download the generated image

Documentation

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