MCP Tools Reference
The Templated MCP server provides 25+ tools that cover the full Templated API. This page documents all available tools and their parameters.
Render Tools
Section titled “Render Tools”Tools for creating and managing renders (generated images, videos, and PDFs).
create_render
Section titled “create_render”Creates a new render from a template.
| Parameter | Type | Required | Description |
|---|---|---|---|
template | string | ✓ | Template ID to render |
layers | object | — | Layer modifications (key: layer name, value: properties). Supports animation object for video renders. |
format | string | — | Output format: jpg, png, webp, pdf, mp4 (default: jpg) |
transparent | boolean | — | Make background transparent (PNG only) |
width | number | — | Custom width in pixels |
height | number | — | Custom height in pixels |
name | string | — | Custom name for the render |
webhook_url | string | — | URL to POST render result to |
duration | number | — | Video duration in milliseconds (MP4 only, max 90000) |
fps | number | — | Frames per second (MP4 only, 1-60) |
Example prompt:
“Create a render from template abc123 with the title layer set to ‘Hello World’ and format as PNG”
get_render
Section titled “get_render”Retrieves details of a specific render.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | ✓ | Render ID |
list_renders
Section titled “list_renders”Lists all renders, optionally filtered.
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | — | Maximum number to return (default: 20) |
templateId | string | — | Filter by template ID |
folderId | string | — | Filter by folder ID |
delete_render
Section titled “delete_render”Deletes a render.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | ✓ | Render ID to delete |
merge_renders
Section titled “merge_renders”Merges multiple renders into a single PDF.
| Parameter | Type | Required | Description |
|---|---|---|---|
renderIds | array | ✓ | Array of render IDs to merge |
name | string | — | Name for the merged PDF |
Template Tools
Section titled “Template Tools”Tools for managing templates.
list_templates
Section titled “list_templates”Lists all templates in your account.
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | — | Maximum number to return (default: 20) |
folderId | string | — | Filter by folder ID |
tags | array | — | Filter by tags |
get_template
Section titled “get_template”Retrieves details of a specific template.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | ✓ | Template ID |
get_template_layers
Section titled “get_template_layers”Gets all layers in a template with their properties.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | ✓ | Template ID |
Example prompt:
“Show me all the layers in template abc123”
get_template_pages
Section titled “get_template_pages”Gets all pages in a multi-page template.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | ✓ | Template ID |
create_template
Section titled “create_template”Creates a new template programmatically.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | ✓ | Template name |
width | number | ✓ | Width in pixels |
height | number | ✓ | Height in pixels |
background | string | — | Background color (hex) |
duration | number | — | Default video duration in milliseconds (MP4 renders) |
layers | array | — | Array of layer objects |
folderId | string | — | Folder to create template in |
Layer object properties:
| Property | Type | Description |
|---|---|---|
layer | string | Unique layer name (required) |
type | string | Layer type: text, image, shape (required) |
x | number | X position |
y | number | Y position |
width | number | Layer width |
height | number | Layer height |
text | string | Text content (for text layers) |
color | string | Text color (hex) |
font_family | string | Font family name |
font_size | string | Font size (e.g., “24px”) |
image_url | string | Image URL (for image layers) |
background | string | Background color (hex) |
border_radius | string | Border radius (e.g., “10px”) |
animation | object | Animation config for video renders (see below) |
Animation object properties (MP4 only):
| Property | Type | Description |
|---|---|---|
in | object | Entrance animation: type (slide, fade, zoom, rotate), direction, duration (ms), writingStyle |
loop | object | Looping animation: type (spin, pulse), duration (ms) |
out | object | Exit animation: type (slide, fade, zoom), direction, duration (ms) |
start | integer | Time in milliseconds when layer becomes visible (default: 0) |
end | integer | Time in milliseconds when layer disappears (default: video duration) |
Example prompt:
“Create a new template called ‘Social Post’ that’s 1080x1080 with a blue background and a white text layer for the title”
update_template
Section titled “update_template”Updates an existing template.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | ✓ | Template ID |
name | string | — | New template name |
width | number | — | New width |
height | number | — | New height |
background | string | — | New background color |
duration | number | — | Default video duration in milliseconds |
layers | array | — | Updated layers |
clone_template
Section titled “clone_template”Creates a copy of a template.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | ✓ | Template ID to clone |
name | string | — | Name for the cloned template |
Example prompt:
“Clone my Instagram template and name it ‘TikTok Version‘“
delete_template
Section titled “delete_template”Deletes a template.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | ✓ | Template ID to delete |
list_template_renders
Section titled “list_template_renders”Lists all renders created from a specific template.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | ✓ | Template ID |
limit | number | — | Maximum number to return |
Folder Tools
Section titled “Folder Tools”Tools for organizing templates and renders into folders.
list_folders
Section titled “list_folders”Lists all folders.
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | — | Maximum number to return |
create_folder
Section titled “create_folder”Creates a new folder.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | ✓ | Folder name |
color | string | — | Folder color (hex) |
update_folder
Section titled “update_folder”Updates a folder’s name or color.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | ✓ | Folder ID |
name | string | — | New folder name |
color | string | — | New folder color |
delete_folder
Section titled “delete_folder”Deletes a folder.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | ✓ | Folder ID to delete |
Upload Tools
Section titled “Upload Tools”Tools for managing uploaded images.
list_uploads
Section titled “list_uploads”Lists all uploaded images.
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | — | Maximum number to return |
create_upload
Section titled “create_upload”Uploads an image from a URL.
| Parameter | Type | Required | Description |
|---|---|---|---|
url | string | ✓ | URL of the image to upload |
name | string | — | Name for the upload |
Example prompt:
“Upload this image logo.png to my Templated account”
delete_upload
Section titled “delete_upload”Deletes an uploaded image.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | ✓ | Upload ID to delete |
Font Tools
Section titled “Font Tools”Tools for managing custom fonts.
list_fonts
Section titled “list_fonts”Lists all uploaded custom fonts.
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | — | Maximum number to return |
upload_font
Section titled “upload_font”Uploads a custom font from a URL.
| Parameter | Type | Required | Description |
|---|---|---|---|
url | string | ✓ | URL of the font file (.ttf, .otf, .woff, .woff2) |
name | string | — | Name for the font |
delete_font
Section titled “delete_font”Deletes a custom font.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | ✓ | Font ID to delete |
Account Tools
Section titled “Account Tools”get_account
Section titled “get_account”Retrieves account information including usage statistics.
No parameters required.
Returns:
- Account name and email
- Current plan
- API usage statistics
- Remaining credits
Example prompt:
“Show me my Templated account information and usage”
Tool Categories Summary
Section titled “Tool Categories Summary”| Category | Tools | Description |
|---|---|---|
| Renders | 5 | Create, view, list, delete, and merge renders |
| Templates | 9 | Full template lifecycle management |
| Folders | 4 | Organize content into folders |
| Uploads | 3 | Manage uploaded images |
| Fonts | 3 | Manage custom fonts |
| Account | 1 | View account information |