Placid.app

Provides a MCP server to list Placid templates and generate creatives via Placid.app API with secure token handling.

typescript

0

GitHub Stars

typescript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can run Placid.app's creative generation MCP server locally or via a manager, enabling you to list Placid templates and generate creatives through dynamic content while securely handling your API token.

How to use

Set up an MCP client to communicate with the Placid MCP server. You can list available templates, filter them by collection or tags, and generate creatives by providing template IDs and layer data. Supply your Placid API token to authorize requests. The server will return the generated creative URL and usage details when a process finishes.

How to install

Prerequisites: ensure you have Node.js (and npm) installed on your machine.

Option 1: Install via Smithery (recommended for Claude Desktop users)

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

Option 2: NPX installation (quick start)

npx @felores/placid-mcp-server

After starting, configure the MCP server in your client settings with the example below. Replace your-api-token with your actual Placid API token.

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

Additional installation notes

Option 3: Manual installation (build from source) if you prefer to run from a local build. Follow these steps to build and run the server locally, then configure your client to point at the local runtime.

git clone https://github.com/felores/placid-mcp-server.git
cd placid-mcp-server
npm install
npm run build

Then configure the client to run the local build through the runtime path shown here.


Configure the local runtime in your client with the following example. Replace path/to/placid-mcp-server with the absolute path to your built index.js.

{ "mcpServers": { "placid": { "command": "node", "args": ["path/to/placid-mcp-server/build/index.js"], "env": { "PLACID_API_TOKEN": "your-api-token" } } } }


## Available tools

### placid\_list\_templates

Lists available Placid templates with optional filters like collection\_id, custom\_data, and tags. Returns template metadata including uuid, title, thumbnail, layers, and tags.

### placid\_generate\_creative

Generates a creative by applying a template to dynamic content. Accepts template\_id, layers for text and image data, and optional modifications such as width, height, and filename. Returns status, image\_url, and credits\_used.