placid_generate_image
Generate an image using a template and provided assets
LABSCO SUMMARY
Templates stay in Placid where a designer made them; only the content changes from call to call.
List the templates first every time — the layer names a template exposes are exactly the keys you pass in, and guessing them is the usual reason a render comes back wrong. Long video renders return a job ID rather than a URL, so pick it up in the Placid dashboard instead of waiting on the tool call.
What it is
A small server over the Placid.app API for creative automation: list the templates in your account, then render one by supplying content for its layers.
What you get
- placid_list_templates returns your templates with title, UUID, preview thumbnail, the layers each one exposes with their types, and tags — filterable by collection, tags or custom reference data
- placid_generate_image fills a template's text and image layers and returns a URL to the finished image
- placid_generate_video fills video, image and text layers and returns a video URL, or a job ID to follow in the Placid dashboard when the render runs long
- Audio on a video render: an mp3 URL, with audio_duration set to auto to match the video length, or explicit trim timestamps at either end
Requirements
A Placid account and an API token created under Settings > API, supplied as PLACID_API_TOKEN. Node.js 18 or newer; run it with npx @felores/placid-mcp-server. Assets are referenced by URL rather than uploaded, so the images, video and audio you pass have to be reachable over the web. Video renders consume Placid credits — every 10 seconds of video uses 10 credits.
Setup effort
Add the configuration to your client
USE CASES
01
Finding the right template and the names of its layers
List templates, optionally narrowed by collection or tag, and read the layers each one exposes.
02
Producing a social image for the post you just wrote
Pick the template, then fill its headline and background layers with the copy and image you have.
03
Turning a clip and a headline into a short video
Supply the video, logo and text layers by URL and take back the rendered file.
04
Putting a music bed under a video without editing it first
Pass the mp3 URL with auto duration, or trim it with explicit start and end timestamps.
05
Making a batch of on-brand cards from one template
Reuse the same template UUID and vary only the layer content per call.
3 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
placid_generate_video
Generate a video using one or more templates and provided assets. Every 10 seconds of video uses 10 credits.
placid_list_templates
Get a list of available Placid templates with optional filtering. Each template includes its title, ID, preview image URL, available layers, and tags.
BEFORE YOU INSTALL
What to know first
Tools you get
3 tools when we connected.
Requires
- npx on PATH
- PLACID_API_TOKEN in your environment
Where it runs
Both documented clients run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 3 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
MCP Clients
Claude Desktop, Cline
JSON
{
"mcpServers": {
"placid": {
"command": "npx",
"args": [
"@felores/placid-mcp-server"
],
"env": {
"PLACID_API_TOKEN": "<YOUR_PLACID_API_TOKEN>"
}
}
}
}
