# Creatomate — how to use (mcp.ai)

Connect your Creatomate account and use 7 tools for video and audio straight from your AI agent. Connect with your own API key. Creatomate is an API for generating and managing automated videos, images, GIFs, and reusable media templates.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_creatomate?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. `creatomate_create_render`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/creatomate`
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/creatomate/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/creatomate/create/render` — Start one asynchronous image, video, or GIF render from either a template or a direct RenderScript. The call consumes render credits and returns the initial status; use Get Render to check completion.
  - body: { metadata?: string, max_width?: number, max_height?: number, template_id?: string, webhook_url?: string, render_scale?: number, modifications?: object, output_format?: string, render_script?: object }
- `POST https://api.mcp.ai/api/creatomate/create/template` — Create a reusable project template from a RenderScript without starting a render, returning the saved template and any non-fatal warnings.
  - body: { name: string, tags?: string[], source: object }
- `POST https://api.mcp.ai/api/creatomate/delete/template` — Permanently delete one project template. Existing renders created from the template are unaffected.
  - body: { template_id: string }
- `POST https://api.mcp.ai/api/creatomate/get/render` — Return the current status and available output metadata for one asynchronous render; terminal statuses are succeeded and failed.
  - body: { render_id: string }
- `POST https://api.mcp.ai/api/creatomate/get/template` — Return one project template including its complete RenderScript source.
  - body: { template_id: string }
- `POST https://api.mcp.ai/api/creatomate/list/templates` — Return metadata for every template in the connected project, optionally filtered by any of the supplied comma-separated tags; RenderScript source is not included.
  - body: { tags?: string }
- `POST https://api.mcp.ai/api/creatomate/update/template` — Partially update a template's name, replacement tag list, or complete replacement RenderScript source; omitted fields remain unchanged.
  - body: { name?: string, tags?: string[], source?: object, template_id: string }

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

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