mcp-server-templated

Templated MCP Server

MCP (Model Context Protocol) server for Templated - the API for automated image, video, and PDF generation.

This server enables AI assistants like Claude, Cursor, and ChatGPT to interact with your Templated account - generate renders, manage templates, upload assets, and access all API features using natural language.

Features

• Render Generation: Create images (JPG, PNG, WebP), videos (MP4), and PDFs from templates
• Template Management: List, create, update, clone, and delete templates
• Layer Inspection: Get template layers to understand what can be customized
• Asset Management: Upload and manage images, videos, and custom fonts
• Folder Organization: Create and manage folders for templates

Quick Start

Get Your API Key

• Sign up at app.templated.io
• Go to your API Key page
• Copy your API key

Connection Options

Option 1: Remote Server (Recommended)

Use our hosted MCP server - no installation required, always up-to-date.

Endpoint: https://mcp.templated.io/mcp (OAuth login) — or https://mcp.templated.io/mcp?apiKey=YOUR_API_KEY for automation

Claude (web, desktop, mobile)

Templated is listed in the Claude connectors directory: open claude.ai/directory/templatedio (or Customize → Connectors and search for Templated), click Connect and sign in to your Templated account. To add it as a custom connector instead, use Settings → Connectors → Add custom connector with https://mcp.templated.io/mcp.

Claude Code

claude mcp add --transport http templated https://mcp.templated.io/mcp

Then run /mcp inside Claude Code and sign in when prompted.

Cursor IDE

Or add it manually to ~/.cursor/mcp.json. Either way, click Login when Cursor asks and sign in to Templated:

{
  "mcpServers": {
    "templated": {
      "url": "https://mcp.templated.io/mcp"
    }
  }
}

For automations, use https://mcp.templated.io/mcp?apiKey=your-api-key-here as the URL instead.

ChatGPT

• Go to Settings → Connected Apps → Add MCP Server
• Enter URL: https://mcp.templated.io/mcp
• Set Authentication to OAuth and sign in to Templated when prompted
• Click Create

Alternative (automations): enter https://mcp.templated.io/mcp?apiKey=your-api-key-here and set Authentication to No Auth instead.

Option 2: Local Server

Run the MCP server locally on your machine. Requires Node.js 18+.

Claude Desktop

To run the server locally instead of using the remote connector, add to your config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "templated": {
      "command": "npx",
      "args": ["mcp-server-templated"],
      "env": {
        "TEMPLATED_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor IDE (Local)

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "templated": {
      "command": "npx",
      "args": ["mcp-server-templated"],
      "env": {
        "TEMPLATED_API_KEY": "your-api-key-here"
      }
    }
  }
}

Manual Installation

# Using npx (no install needed)
npx mcp-server-templated

# Or install globally
npm install -g mcp-server-templated

Authentication

The remote server supports two ways to authenticate:

• OAuth 2.1 via the Templated authorization server — used automatically by interactive clients (Claude, ChatGPT, Cursor, Claude Code) when you connect to https://mcp.templated.io/mcp without an API key.
• API key via ?apiKey=YOUR_API_KEY on the URL or an Authorization: Bearer YOUR_API_KEY header — used for automations and multi-tenant scoping (folderId/externalId).

Available Tools

Render Operations

Tool	Description
create_render	Create an image, video, or PDF from a template
get_render	Get details of a specific render
list_renders	List all renders in your account
delete_render	Delete a render
merge_renders	Merge multiple PDF renders into one

Template Operations

Tool	Description
list_templates	List all templates (with search/filter)
get_template	Get template details
get_template_layers	Get all layers of a template
get_template_pages	Get pages of a multi-page template
create_template	Create a new template (single-page via layers, multi-page/multi-size via pages)
update_template	Update an existing template (add or edit pages via pages)
clone_template	Clone a template (optional new name)
delete_template	Delete a template
list_template_renders	List renders from a template

Folder Operations

Tool	Description
list_folders	List all folders
create_folder	Create a new folder
update_folder	Rename a folder
delete_folder	Delete a folder

Asset Operations

Tool	Description
list_uploads	List uploaded assets
create_upload	Upload a file from URL
delete_upload	Delete an upload
list_fonts	List custom fonts
upload_font	Upload a custom font
delete_font	Delete a custom font by name

Account

Tool	Description
get_account	Get render usage for the current period

Example Usage

Once configured, you can ask your AI assistant to:

• "List my templates"
• "Create a render from template [ID] with the title set to 'Hello World'"
• "Generate a PDF certificate with the name 'John Doe'"
• "What layers does template [ID] have?"
• "Create a new template called 'Social Post' with a title and image layer"
• "Clone my Instagram template and rename it"
• "Upload this image to my account"
• "Show my API usage and account info"

Creating a Render

"Create a render using template abc-123 with these changes:
- Set the 'title' layer text to 'Welcome!'
- Set the 'photo' layer image to https://example.com/photo.jpg
- Output as PNG with transparent background"

Claude will use the create_render tool with:

{
  "template": "abc-123",
  "format": "png",
  "transparent": true,
  "layers": {
    "title": { "text": "Welcome!" },
    "photo": { "image_url": "https://example.com/photo.jpg" }
  }
}

Development

# Clone the repository
git clone https://github.com/templated-io/mcp-server-templated.git
cd mcp-server-templated

# Install dependencies
npm install

# Build
npm run build

# Run in stdio mode (for local MCP clients)
TEMPLATED_API_KEY=your-key node dist/index.js

# Run in HTTP mode (for remote access)
PORT=3456 node dist/index.js
# Then access: http://localhost:3456/mcp?apiKey=your-key

Testing with MCP Inspector

npx @modelcontextprotocol/inspector npx mcp-server-templated

Resources

• Templated Documentation
• MCP Documentation
• Template Gallery

License

MIT