Placid

You can run and use the Placid MCP Server to list templates and generate images or videos through Placid.app, all controlled by an MCP client. It handles token-based authentication, template querying, and dynamic content rendering in a type-safe, scalable way.

How to use

You use an MCP client to interact with the Placid MCP Server. First, list available templates to understand what you can generate. Then, choose a template and supply dynamic content for the selected layers to render images or videos. You provide your Placid API token to authorize requests, and the server returns either a finished asset URL or a status you can poll if the job is long-running.

How to install

Prerequisites: ensure you have Node.js 18 or higher installed on your machine.

Recommended quick start (automatic configuration) uses a CLI to wire everything up for you.

{
  "mcpServers": {
    "placid": {
      "command": "npx",
      "args": ["-y", "@smithery/cli", "install", "@felores/placid-mcp-server", "--client", "claude"]
    }
  }
}

Manual configuration lets you run the MCP server as a local process and connect via the Claude client. Add the following configuration to your Claude Desktop or Claude CLI settings.

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

Getting Your Placid API Token

Follow these steps to obtain a token you can use with the MCP server.

1. Log in to your Placid.app account.

2. Go to Settings > API.

3. Click on "Create API Token".

4. Give your token a name (for example, "MCP Server").

5. Copy the generated token.

6. Add the token to your MCP client configuration exactly as shown in the manual setup snippet.

Development

Run in development mode with hot reload to iterate on changes.

npm run dev

Run tests to verify behavior.

npm test

Notes on usage and security

Keep your API token secure. Do not share it or expose it in client-side code. Prefer environment variables to configure tokens and access controls for your MCP client.

Available tools

placid_list_templates

Lists available Placid templates with optional filters for collection, custom data, and tags, returning template details such as uuid, title, thumbnail, layers, and tags.

placid_generate_video

Generates a video from a chosen template by supplying dynamic content for layers, including video, image, and text layers, with optional audio, and returns a status and either a video URL or a job ID for long-running tasks.

placid_generate_image

Generates a static image from a chosen template by supplying dynamic content for layers, including text and image layers, returning a finished status and an image URL.