Skip to main content

Imagor MCP

Test Status

An MCP server and a skill that add template capability to imagor.

An agent writes a layout: OG cards, product grids, quotes, testimonials. It compiles to one imagor URL, rendered by the imagor you already run.

info

GitHub: github.com/cshum/imagor-mcp
Registry: install as io.github.cshum/imagor-mcp
Releases: macOS, Linux and Windows binaries
Requires: imagor 1.9.10 or above

Cards, each one a single imagor URL

See the recipes »

Quick start​

1. Run an imagor.

docker run --rm -p 8000:8000 shumc/imagor -imagor-unsafe

Leave it running, and use a second terminal for the rest.

Unsafe mode is for trying things out. Production runs on IMAGOR_SECRET. See imagor's security docs.

2. Install the MCP server.

brew trust cshum/tap && brew install imagor-mcp

3. Point a client at it.

your clientwhat to do
VS Codeadd it from here — one click
Claude Desktopopen imagor-mcp.mcpb — one click
Cursor, Claude Code, Windsurfadd the block below to its config file
Codexthe same values in TOML, at ~/.codex/config.toml
{
  "mcpServers": {
    "imagor": {
      "command": "imagor-mcp",
      "env": { "IMAGOR_UNSAFE": "1", "IMAGOR_BASE_URL": "http://localhost:8000" }
    }
  }
}

Those two settings have to match what you started in step 1: IMAGOR_UNSAFE puts this server in the same mode, and IMAGOR_BASE_URL is where imagor is.

VS Code keys its servers under servers and Codex reads TOML, so the block above fits neither. Every client's config file is in Setup.

4. Ask it for something. See the recipes — each one carries a prompt to paste, or describe the image you want. The agent composes through the tools: it writes the layout, renders it, looks at the result, and hands you back the url. Neither of you needs imagor's path syntax: the tools build the path, and refuse one that cannot work.

That is the whole install. It is also in the official MCP Registry as io.github.cshum/imagor-mcp, which some clients install by name, and as ghcr.io/cshum/imagor-mcp in a container, which needs a different base URL, in Setup. Windows binaries are on the releases page.

Before anything is public, read Security: what this server is trusted with, and what it refuses.

Going deeper​

  • Setup — every setting, the config file each client reads, and what to do before it is public.
  • Reference — every tool the server serves, the layout format, and the skill.
  • Cookbook — the ready-made layouts, and the url each one resolves to.
  • Contributing — building, testing, and the CLI.