Labsco
MCP SERVER

TemplateIO Image Generation

by Lucker631

Fill a Templated.io image template from an assistant — swap two images and one line of text, get a rendered image back.

Image Generation
Summary
One template, three named layers — useful if that shape matches yours.

This is narrower than it first looks: the parameters are bound to specific layer names, so it renders one kind of composition rather than any Templated.io template. Read as a working example of an mcp-framework tool that calls a real API, it is a reasonable place to start; read as a general image service, it will not fit.

What it is

A small stdio server built on mcp-framework that exposes one image-generation tool backed by the Templated.io API. You give it a template ID, two image URLs and a line of text; Templated.io renders the composition and returns the image. The repository doubles as a starting point for writing your own tools — it ships an example tool alongside the image one.

What you get
  • A Templated Image Generator tool that renders one of your Templated.io templates
  • `templateId` picks the template; `buildText` sets the text layer
  • `photoBgImageUrl` and `bgYellowImageUrl` fill the two image layers by URL
  • The layer names are fixed — the tool targets the "photo-bg", "bg-yellow" and "build" layers, so your template needs those
  • A CLI (`mcp add tool`) for adding further tools to the same server
Requirements

A Templated.io API key, passed as `TEMPLATED_API_KEY` in your client config. Build from source with `npm install` then `npm run build`, and point your client at `node` with the path to `dist/index.js`. The package is `mcp-templateio`, version 0.0.1.