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
- Install Node.js (version 18 or higher) and npm from nodejs.org
- 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
- 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 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 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
{
"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 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
{
"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