Placid MCP Server
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.
<a href="https://glama.ai/mcp/servers/xeklsydon0"> <img width="380" height="200" src="https://glama.ai/mcp/servers/xeklsydon0/badge" /> </a>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
- Install Node.js (version 18 or higher) and npm from nodejs.org
- Verify installation:Copy
Installation Options
NPX Installation
The quickest way to get started is using npx, justadd the server configuration to your Claude Desktop or Cline settings:
Installing via Smithery
To install @felores/placid-mcp-server for Claude Desktop automatically via Smithery:
Manual Installation
If you want to contribute to the project or modify the server.
- Clone the repository:
- Install dependencies:
- Build the project:
- Add the server configuration to your Claude Desktop or Cline settings:
Replace path/to/placid-mcp-server
with the absolute path to your cloned repository.
Getting Your Placid API Token
- Log in to your Placid.app account
- Go to Settings > API
- Click on "Create API Token"
- Give your token a name (e.g., "MCP Server")
- Copy the generated token
- Add the token to your Claude Desktop or Cline configuration as shown in the installation steps above
Development
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 IDcustom_data
(optional): Filter by custom reference datatags
(optional): Array of tags to filter templates by
Response
Returns an array of templates, each containing:
uuid
: Unique identifier for the templatetitle
: Template namethumbnail
: Preview image URL (if available)layers
: Array of available layers with their names and typestags
: 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 uselayers
(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" } }
- For video layers:
audio
(optional): URL to an mp3 audio fileaudio_duration
(optional): Set to 'auto' to trim audio to video lengthaudio_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
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 uselayers
(required): Object containing dynamic content for template layers- For text layers:
{ "layerName": { "text": "Your content" } }
- For image layers:
{ "layerName": { "image": "https://image-url.com" } }
- For text layers:
Response
Returns an object containing:
status
: "finished" when completeimage_url
: URL to download the generated image
Example Usage for LLM models
Documentation
For more detailed information about the Placid API, visit the Placid API Documentation.
License
MIT
You must be authenticated.
A server for integrating with Placid.app's API, enabling listing templates and generating creatives using the Model Context Protocol with secure API token management.