Plainly's Official MCP Server

Implementation of MCP server for Plainly in NodeJS. Enables LLM clients to connect and interact with Plainly APIs.

🎥 Demo

📋 Prerequisites

• Node.js ≥ 18 (required)

• NPM

• Plainly Account

▶️ How to Run

Install via npm

1. Get your Plainly API key

• Go to Settings page

• Create a new API key

• Copy the new API key

2. Add config to your editor

   { "servers": { "plainly": { "command": "npx", "args": ["-y", "@plainly-videos/mcp-server@latest"], "env": { "PLAINLY_API_KEY": "<PLAINLY_API_KEY>" } } } }

   🔑 Replace <PLAINLY_API_KEY> with your actual API key.

Install via Smithery

Go to Smithery Plainly MCP page, select your LLM client, and copy the generated command.

For example, with Claude as the client:

🔑 Replace <YOUR_SMITHERY_KEY> with your Smithery API key.

🛠️ Available Tools

• list_renderable_items - returns a list of all criteria matching designs and custom projects for authenticated user

• get_renderable_items_details - returns details of a single design or custom project, such as: required and optional parameters, preview links, aspect ratios, etc.

• render_item - submits a render with all needed parameters

• check_render_status - checks the render status and report error or preview links

🗣️ Prompts & Resources

This implementation does not include prompts or resources from the MCP specification. However, this may change in the future when there is broader support across popular MCP clients.

🚧 Development Mode

If you want to run the server in development mode, you can install dependencies and run the server using the following command:

1. Clone, install, and build:

2. Add your API key in .vscode/mcp.json

3. Start MCP server from .vscode/mcp.json

📄 Plainly Developer Resources

• Help center

• API reference