# Codesign

> Local design engine for AI agents. Create, edit and export real, editable designs from Claude Code, Codex, Cursor and more, then fix anything by hand in the built-in editor. Powered by CE.SDK.

- **Type:** MCP server
- **Install:** `agentstack add mcp-imgly-codesign`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [imgly](https://agentstack.voostack.com/s/imgly)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [imgly](https://github.com/imgly)
- **Source:** https://github.com/imgly/codesign
- **Website:** https://img.ly/codesign

## Install

```sh
agentstack add mcp-imgly-codesign
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# CoDesign

**The design layer for the agent era.**

CoDesign gives your coding agent a real design engine. Generate, edit, and
automate _fully editable_ designs — print, social, and video — straight from
the chat, then export print-ready PDFs, images, and more. You steer, the agent
edits the same scene, and you keep control of the outcome.

It ships as an MCP server (plus a Claude Code plugin) that hands your agent
IMG.LY's CE.SDK CreativeEngine — the same production engine behind IMG.LY's
commercial SDKs. Every recipe below spawns the published npm package
`@imgly/codesign-mcp` over stdio; no separate install step — `npx` fetches it on first
use.

## What you can make

Ask your agent, in plain language:

- _"Design a 3-panel Instagram carousel announcing our launch, on-brand."_
- _"Resize this poster to A4 with print bleed and export a print-ready PDF."_
- _"Localize this flyer into German and re-fit the layout to the new text."_
- _"Generate five color variants of this template so I can pick one."_

## How it works

Three layers, one product:

- **The plugin** — skills, slash commands, and an embedded design handbook your
  agent draws on to design _well_ (brand, localize, resize, and quality-check
  its own output). This is the piece you install.
- **The MCP server** (`@imgly/codesign-mcp`) — exposes the design tools (`edit`,
  `preview`, `export`, `list`, `history`, …) over MCP, driven by tool calls
  from any agent host.
- **The CE.SDK CreativeEngine** — IMG.LY's real, headless design engine that
  does the actual layout, rendering, and export.

## Licensing

This repository — the Claude Code and Codex plugins, marketplace manifests,
skills and documentation — is released under the [MIT License](./LICENSE).
The CoDesign engine itself, distributed as the npm package `@imgly/codesign-mcp`, is
proprietary software from IMG.LY and free to use locally. The full terms ship
inside the package as `LICENSE.md`.

## Why a real engine matters

Every other design agent draws on a web canvas — a quick fix that breaks on the
hard problems. CoDesign commands a production engine matured over years across
print, video, and social:

- **True print & color fidelity** — CMYK, bleed, and ICC profiles, not just
  RGB screen output.
- **Deterministic output** — renders identically everywhere, independent of
  browser or config.
- **Native performance** — a purpose-built engine that stays fast at scale and
  under heavy assets.
- **Full compatibility** — imports InDesign, PSD, PDF, and Lottie; exports
  print-ready PDF, image, video, and HTML.

## Requirements & known limitations

> **Read this first — the failure modes below are silent.**

- **Node.js ≥ 22.15 is required and is _not_ provided.** The server runs on your
  system Node. With no Node (or Node .
- **Pin `@latest` — it's in every recipe on purpose.** A bare, unpinned `npx`
  caches the package and goes stale; because each release carries a rolling
  30-day trial license, a stale copy eventually stops working.
- **Windows is not supported under bare `npx`.** Hosts that spawn `npx`
  directly hit `spawn npx ENOENT`
  ([anthropics/claude-code#58510](https://github.com/anthropics/claude-code/issues/58510)).
  Use WSL for now; a native Windows launcher is coming.

## Install

### Claude Code

Install the plugin from the marketplace:

```bash
claude plugin marketplace add imgly/codesign
claude plugin install codesign@imgly-codesign
```

Or add the MCP server directly, without the plugin:

```bash
claude mcp add codesign -- npx -y @imgly/codesign-mcp@latest stdio
```

### Codex

Install the plugin from the marketplace:

```bash
codex plugin marketplace add imgly/codesign
codex plugin add codesign@imgly-codesign
```

Or add the MCP server directly, without the plugin:

```bash
codex mcp add codesign -- npx -y @imgly/codesign-mcp@latest stdio
```

### Antigravity CLI

Clone the repo and install the plugin folder:

```bash
git clone https://github.com/imgly/codesign
agy plugin install ./codesign/plugins/codesign
```

Or add the MCP server directly, without the plugin:

```bash
agy mcp add codesign -- npx -y @imgly/codesign-mcp@latest stdio
```

### Gemini CLI

Gemini CLI now serves Gemini Code Assist Standard/Enterprise and API-key
accounts; on a personal Google account, use Antigravity CLI above.

Install as an extension straight from the public repo:

```bash
gemini extensions install https://github.com/imgly/codesign
```

Or add the server manually to `~/.gemini/settings.json`:

```json
{
  "mcpServers": {
    "codesign": {
      "command": "npx",
      "args": [
        "-y",
        "@imgly/codesign-mcp@latest",
        "stdio"
      ]
    }
  }
}
```

### Other MCP hosts

Every other host spawns the same stdio server — only the config file and
the top-level key differ. Add this block to the host’s MCP config:

```json
{
  "mcpServers": {
    "codesign": {
      "command": "npx",
      "args": [
        "-y",
        "@imgly/codesign-mcp@latest",
        "stdio"
      ]
    }
  }
}
```

| Host | Config file | Note |
| --- | --- | --- |
| Cursor | `.cursor/mcp.json` | as-is |
| Windsurf | `~/.codeium/windsurf/mcp_config.json` | as-is |
| VS Code | `.vscode/mcp.json` | use the key `servers` instead of `mcpServers` |
| Zed | `settings.json` | use the `context_servers` shape below |

VS Code (`servers` key):

```json
{
  "servers": {
    "codesign": {
      "command": "npx",
      "args": [
        "-y",
        "@imgly/codesign-mcp@latest",
        "stdio"
      ]
    }
  }
}
```

Zed (`context_servers`):

```json
{
  "context_servers": {
    "codesign": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@imgly/codesign-mcp@latest",
          "stdio"
        ]
      }
    }
  }
}
```

## Beyond your machine

CoDesign runs free on your machine today. When you need more — always-on
hosting, your own infrastructure (VPC / on-prem), or a fully bundled design
agent that lives in the canvas — the same building block graduates by changing
config, not vendors. No lock-in. Talk to us: .

## Support

Questions or issues: . This distribution is generated from
IMG.LY's source repository.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [imgly](https://github.com/imgly)
- **Source:** [imgly/codesign](https://github.com/imgly/codesign)
- **License:** MIT
- **Homepage:** https://img.ly/codesign

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-imgly-codesign
- Seller: https://agentstack.voostack.com/s/imgly
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.