Placid MCP Server

🚀 Placid.app MCP Server

An MCP server implementation for integrating with the Placid.app API. This server provides tools to list templates and generate images and videos using templates and dynamic content via the Model Context Protocol.

🚀 Quick Start

This is an MCP server implementation designed for integration with the Placid.app API. It offers tools to list templates and generate images and videos using templates and dynamic content through the Model Context Protocol.

✨ Features

• List available Placid templates with filtering options.
• Generate images and videos using templates and dynamic content.
• Secure API token management.
• Error handling and validation.
• Type-safe implementation.

📦 Installation

Prerequisites: Node.js

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

   node --version
   npm --version
   

Quick Start (Recommended)

The easiest way is to use Smithery, which will automatically configure everything for you:

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

Manual Configuration

If you prefer manual configuration, add the following to your Claude Desktop or Cline settings:

{
  "mcpServers": {
    "placid": {
      "command": "npx",
      "args": ["@felores/placid-mcp-server"],
      "env": {
        "PLACID_API_KEY": "your_api_key_here"
      }
    }
  }
}

📚 Documentation

For more detailed information about the Placid API, visit Placid API Documentation.

💻 Usage Examples

placid-list-templates

List all available templates:

npx @felores/placid-mcp-server list-templates

placid-get-template

Get detailed information about a specific template:

npx @felores/placid-mcp-server get-template --template-id=TEMPLATE_ID

🔧 Technical Details

Install Dependencies

Install the required dependencies using npm:

npm install

Run Tests

Run the test suite:

npm test

Package the Project

Package the project:

npm run build

📄 License

MIT