# Placid — how to use (mcp.ai)

Connect your Placid account and use 11 tools for images and design straight from your AI agent. Connect with your own API key. Placid is a creative automation toolkit that enables users to generate images, PDFs, and videos from custom templates via REST or URL APIs.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_placid?ms=1787293440000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `placid_create_collection`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/placid`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/placid/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/placid/create/collection` — Tool to create a new template collection to group multiple templates. Use when organizing templates into collections with custom metadata.
  - body: { title: string, custom_data?: string, template_uuids?: string[] }
- `POST https://api.mcp.ai/api/placid/create/template` — Tool to create a new Placid template. Use when you need a template with specific dimensions and optional tags or custom metadata. Example: "Create a social-media banner."
  - body: { url?: string, tags?: string[], title: string, width: integer, height: integer, custom_data?: string|object }
- `POST https://api.mcp.ai/api/placid/delete/collection` — Tool to delete a template collection by its ID. Use after confirming the collection is no longer needed. Note: This does not delete the templates within the collection.
  - body: { collection_id: string }
- `POST https://api.mcp.ai/api/placid/delete/template` — Tool to delete a specific template identified by UUID. Use after confirming the template is no longer needed.
  - body: { template_uuid: string }
- `POST https://api.mcp.ai/api/placid/get/collection` — Tool to retrieve a single collection by its ID. Use when you need details about a specific collection including its title, custom data, and associated template UUIDs.
  - body: { collection_id: string }
- `POST https://api.mcp.ai/api/placid/get/collections` — Tool to retrieve a list of all template collections. Use after authentication to paginate through your Placid collections.
  - body: { cursor?: string, per_page?: integer }
- `POST https://api.mcp.ai/api/placid/get/template` — Tool to retrieve a template by UUID. Returns template details including title, thumbnail, tags, and layers.
  - body: { template_uuid: string }
- `POST https://api.mcp.ai/api/placid/list/nl/templates` — Tool to list all available templates via the Natural Language API. Use when you need to discover available templates for generating images.
- `POST https://api.mcp.ai/api/placid/list/templates` — Tool to retrieve a list of templates from your project. Returns 20 items per page with cursor pagination. Use to browse templates, optionally filtered by collection or title.
  - body: { cursor?: string, order_by?: string, title_filter?: string, collection_id?: string }
- `POST https://api.mcp.ai/api/placid/update/collection` — Tool to update an existing template collection. Use to modify title, custom_data, or manage templates (replace all, or incrementally add/remove specific templates).
  - body: { title?: string, custom_data?: string, collection_id: string, template_uuids?: string[], add_template_uuids?: string[], remove_template_uuids?: string[] }
- `POST https://api.mcp.ai/api/placid/update/template` — Tool to update an existing Placid template. Use when you need to modify the title, tags, or custom_data of a template.
  - body: { tags?: string[], title?: string, custom_data?: string, template_uuid: string }

## Example prompts
- "What can I do in Placid?"
- "Show me a summary of my Placid account"

## More
- Page: https://mcp.ai/placid
- Agent spec (llms.txt): https://mcp.ai/placid/llms.txt
- Postman collection: https://mcp.ai/placid/postman.json