placid

The Placid MCP Server integrates Placid.app's API to list available templates and generate images or videos using Placid templates and dynamic content. It exposes tools such as placid_list_templates to fetch and filter templates, placid_generate_video to render videos by supplying a template and dynamic layer content, and placid_generate_image to produce static images from templates. You can manage your API token securely via the token in your configuration, enabling authenticated access to templates and rendering operations. To use the tools, start the MCP server with your configured command, then call the available endpoints with the required parameters (template IDs, layers, and optional audio for videos). The server returns structured responses including template metadata, generated media URLs, or job IDs for longer video processing.

Prerequisites:

• Node.js 18+ and npm
• Access token from Placid.app (API token)

Installation options:

1. Quick Start (recommended) – use Smithery to auto-configure:

npx -y @smithery/cli install @felores/placid-mcp-server --client claude

2. Manual Configuration – install dependencies locally and run via npx:

# Ensure Node.js and npm are installed
node --version
npm --version

# Start the MCP server (example using npx as configured in mcp_config):
npx @felores/placid-mcp-server

3. Configure your client (Claude Desktop or Cline) with the following mcpServers entry (example):

{
  "mcpServers": {
    "placid": {
      "command": "npx",
      "args": ["@felores/placid-mcp-server"],
      "env": {
        "PLACID_API_TOKEN": "your-api-token"
      }
    }
  }
}

4. Obtain a Placid API token and add it to your environment configuration as shown above.

Tips and notes:

• Ensure you provide a valid PLACID_API_TOKEN in your environment to access templates and render content.
• For long videos, placid_generate_video may return a job_id; poll Placid dashboard using that ID to track status.
• The server supports filtering templates by collection_id, tags, and custom_data when listing templates.
• If you encounter authentication or token errors, double-check that the token is correctly set in the mcp_config and that the token has the necessary permissions.
• The npm package name for this server is @felores/placid-mcp-server; you can reference it directly in your deployment scripts or Smithery configurations.