Placid Image Generator

by felores

14 stars

1.1k downloads

Not rated

GitHub

About

Integrates with Placid's API to generate dynamic images from templates for tasks like social media posts and marketing materials.

Details

Author: felores
Repository: felores/placid-mcp-server
GitHub stars: 14
Downloads: 1,117
License: MIT License
Categories: Developer Tools, Other, Design, Media, API, Productivity, AI, Community, Infrastructure, Project Management, Knowledge Base

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Placid Image Generator

Command (node, npx, python, etc.) npx
Arguments
- Argument 1 @felores/placid-mcp-server
Environment
- PLACID_API_TOKEN your-api-token
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

The easiest way to get started is using Smithery, which will automatically configure everything for you:

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

If you prefer to configure manually, add this to your Claude Desktop or Cline settings:

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

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 (e.g., "MCP Server")
5. Copy the generated token
6. Add the token to your configuration as shown above

{
  "template_id": "template-uuid",
  "layers": {
    "headline": { "text": "Welcome to My App" },
    "background": { "image": "https://example.com/bg.jpg" }
  }
}

`placid_list_templates`

Lists available Placid templates with filtering options. Parameters: collection_id (optional), custom_data (optional), tags (optional).

`placid_generate_video`

Generate videos by combining Placid templates with dynamic content like videos, images, and text. Parameters: template_id (required), layers (required), audio (optional), audio_duration (optional), audio_trim_start (optional), audio_trim_end (optional).

`placid_generate_image`

Generate static images by combining Placid templates with dynamic content like text and images. Parameters: template_id (required), layers (required).

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

Linux

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

Macos

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

Windows

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

Placid.app 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

Requirements: Node.js

1. Install Node.js (version 18 or higher) and npm from nodejs.org
2. Verify installation:

   node --version

   npm --version

Installation

Quick Start (Recommended)

The easiest way to get started is using Smithery, which will automatically configure everything for you:

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:

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

Getting Your Placid API Token

Development

# 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

{
  "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

{
  "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.

License

MIT

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

placid_list_templates

placid_generate_video

placid_generate_image

Claude Desktop / Cursor

Linux

Macos

Windows

Placid.app MCP Server

Features

Requirements: Node.js

Installation

Quick Start (Recommended)

Manual Configuration

Getting Your Placid API Token

Development

Run tests

Tools

placid_list_templates

Parameters

Response

placid_generate_video

Parameters

Response

Example Usage for LLM models

placid_generate_image

Parameters

Response

Example Usage for LLM models

Documentation

License

Install

More like this

Sequential Thinking

Sentry

Github

Filesystem

EverArt

Google Drive

`placid_list_templates`

`placid_generate_video`

`placid_generate_image`