Overview
Plainly's MCP server is a NodeJS implementation of the MCP protocol for Plainly. It enables LLM clients to connect to Plainly APIs and to browse and render design work via a small set of MCP tools. The server exposes four core actions: list_renderable_items, get_renderable_items_details, render_item, and check_render_status, allowing authentication, discovery, parameter handling, rendering submissions, and render progress checks for designs and custom projects. It is designed to integrate with a variety of LLM clients and can be run via npm or Smithery; client integrations are demonstrated with Claude in examples. The README notes that prompts and resources from the MCP specification are not currently included, but may be added in the future. Prerequisites include Node.js ≥ 18, NPM, and a Plainly account.
Features
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 reports error or preview links.
Integration options
Provides npm-based usage and Smithery CLI deployment, enabling LLM client connections to Plainly APIs.
Development and configuration
Includes development mode commands (clone, yarn install, yarn build) and configuration via environment variable PLAINLY_API_KEY and .vscode/mcp.json.
Who Is This For?
- LLM clients:Connect to Plainly APIs via the MCP server to render designs and projects using LLMs.
