English Français العربية

Imagor MCP

Official registry Media and design

An MCP server and a skill for imagor, compiling agent-written image layouts into one URL.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

MCPB package https://github.com/cshum/imagor-mcp/releases/download/v0.7.9/imagor-mcp-v0.7.9.mcpb

Environment variables

  • IMAGOR_BASE_URL Where imagor is running, for example http://localhost:8000. Defaults to http://localhost:8000.
  • IMAGOR_UNSAFE Set to 1 when the imagor server runs in unsafe mode, for trying things out. The server will not start without IMAGOR_UNSAFE or IMAGOR_SECRET.
  • IMAGOR_SECRET secret The signing secret, when the imagor server is signed. The alternative to IMAGOR_UNSAFE; the server will not start without one of the two.
  • IMAGOR_SIGNER_TYPE Signature algorithm the imagor server is configured with: sha1 (default), sha256 or sha512. Must match the server or emitted URLs will not validate.
  • IMAGOR_SIGNER_TRUNCATE Signature length in characters, when the imagor server truncates signatures. Must match the server or emitted URLs will not validate.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Imagor MCP
  2. Quick start
  3. Going deeper
  4. Licence

Imagor MCP

An MCP server and a skill that add a template layer 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.

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.

Licence

MIT

Frequently asked questions

What is Imagor MCP?

An MCP server and a skill for imagor, compiling agent-written image layouts into one URL.

How do I install Imagor MCP?

Follow the installation steps in its documentation, shown on this page and in its repository.

Does Imagor MCP need an API key?

Yes. It expects IMAGOR_SECRET, which you set in its configuration.

Is Imagor MCP open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Imagor MCP?

It is published by cshum. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.