https://github.com/felores/placid-mcp-server
Generate image and video creatives using Placid.app templates in MCP compatible hosts
https://github.com/felores/placid-mcp-server
Last synced: 3 months ago
JSON representation
Generate image and video creatives using Placid.app templates in MCP compatible hosts
- Host: GitHub
- URL: https://github.com/felores/placid-mcp-server
- Owner: felores
- License: mit
- Created: 2025-01-13T00:48:59.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-03-28T21:58:56.000Z (3 months ago)
- Last Synced: 2025-03-28T22:32:25.519Z (3 months ago)
- Language: TypeScript
- Homepage:
- Size: 88.9 KB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - Placid.app - Generate image and video creatives using Placid.app templates in MCP compatible hosts (Table of Contents / Art and Culture)
- awesome-mcp-servers - Placid.app - Generate image and video creatives using Placid.app templates in MCP compatible hosts (Table of Contents / Art and Culture)
- mcp-index - Placid - Integrates with Placid.app to list available templates and generate images and videos using dynamic content. Provides secure API token management and robust error handling. (Image and Video Generation)
README
# Placid.app MCP Server
[](https://smithery.ai/server/@felores/placid-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](https://nodejs.org/)
2. Verify installation:
```bash
node --version
npm --version
```
## Installation
### Quick Start (Recommended)
The easiest way to get started is using Smithery, which will automatically configure everything for you:
```bash
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:
```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](https://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
```bash
# 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
```json
{
"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
```json
{
"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](https://placid.app/docs/api/).
## License
MIT