Templated

Generate images, videos and PDFs from templates. Manage templates, folders, uploads and fonts.
Open source Repository Open in the app JSON README (API)
About

Generate images, videos and PDFs from templates. Manage templates, folders, uploads and fonts.
Details

Kind: MCP servers
Topic: No topic detected
Publisher: templated-io
Origin: official
Category: ferramentas
Transport: http
Version: 1.6.0
Stars: 3
Last push: 2026-09-04T19:40:46Z
Repository state: ativo
Language: TypeScript
License: MIT
Added: 2026-09-04 20:00:53
Updated: 2026-09-04 20:00:53
Origin id: io.github.templated-io/mcp-server-templated
README

# Templated MCP Server

MCP (Model Context Protocol) server for [Templated](https://templated.io) - 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

1. Sign up at [app.templated.io](https://app.templated.io)
2. Go to your [API Key page](https://app.templated.io/api-key)
3. 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](https://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

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

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

#### Cursor IDE

[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=templated&config=eyJ1cmwiOiJodHRwczovL21jcC50ZW1wbGF0ZWQuaW8vbWNwIn0=)

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

```json
{
  "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

1. Go to **Settings → Connected Apps → Add MCP Server**
2. Enter URL: `https://mcp.templated.io/mcp`
3. Set Authentication to **OAuth** and sign in to Templated when prompted
4. 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`

```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`:

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

#### Manual Installation

```bash
# 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 |
| `update_template` | Update an existing template |
| `clone_template` | Clone a template |
| `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 font |

### Account

| Tool | Description |
|------|-------------|
| `get_account` | Get account info and API usage |

## 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:
```json
{
  "template": "abc-123",
  "format": "png",
  "transparent": true,
  "layers": {
    "title": { "text": "Welcome!" },
    "photo": { "image_url": "https://example.com/photo.jpg" }
  }
}
```

## Development

```bash
# 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

```bash
npx @modelcontextprotocol/inspector npx mcp-server-templated
```

## Resources

- [Templated Documentation](https://templated.io/docs)
- [MCP Documentation](https://modelcontextprotocol.io)
- [Template Gallery](https://templated.io/templates)

## License

MIT
Templated

About

Details

README

More
