# keyline

> keyline is a free MCP server for design and media. Free design engine that renders social posts, ads and video from one JSON scene. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, macOS, Linux, Windows
- **Website:** https://keyline.dev
- **Repository:** https://github.com/keyline-dev/keyline
- **MCP Registry name:** io.github.keyline-dev/keyline
- **Categories:** design and media
- **Listing updated:** 2026-11-16

## About

keyline gives an agent a small JSON scene format and renders it into images and video at every requested size. A design is written once at a master size, and layouts adapt to a post, banner or skyscraper. No model generates pixels, so the same scene renders the same way on every machine.

Every edit reply lists what does not fit at each size, such as cut text, overflow, low contrast and text under platform buttons, so the agent corrects from measurements rather than screenshots. Output formats include PNG, JPEG, WebP, PDF, animated PNG, GIF, MP4 and WebM, with entrance effects, keyframes and video clips.

It is one native Rust binary on Skia with no headless Chrome. The vendor's benchmark reports about half the tokens of headless Chrome and a sixth of Playwright MCP on two briefs. There are six tools, the site calls it free and fair source, and it ships as an mcpb bundle or a container image.

## Features

- **One layout, many sizes:** Constraints and stacks adapt a design to each size.
- **Checks before rendering:** Reports overflow, contrast and safe areas per size.
- **Motion and video:** Keyframes, staggered text and video clips to GIF, MP4 or WebM.
- **No browser:** Native Rust and Skia, no headless Chrome.
- **Deterministic output:** Scenes render identically on every machine.
- **Token-lean tools:** Six tools with batched edits and short replies.

## Good for

- Create a listing ad in three sizes with a slow photo zoom
- Produce a banner set from one layout
- Generate a speaker card with real fonts
- Render a looping video ad

## Install

### Claude Code (Terminal)

```sh
claude mcp add keyline -- docker run -i --rm ghcr.io/keyline-dev/keyline-mcp:0.8.1
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "keyline": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/keyline-dev/keyline-mcp:0.8.1"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "keyline": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/keyline-dev/keyline-mcp:0.8.1"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "keyline": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/keyline-dev/keyline-mcp:0.8.1"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "keyline": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/keyline-dev/keyline-mcp:0.8.1"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "keyline": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/keyline-dev/keyline-mcp:0.8.1"
      ]
    }
  }
}
```

## Tools

- `scene_create`: Create a scene with target sizes.
- `asset_add`: Add an image asset.
- `layer_add`: Add layers to a scene.
- `layer_update`: Edit a layer.
- `render`: Render the scene to image or video files.

## FAQ

### Does it need a browser?

No, it is a single native binary.

### Which formats can it export?

PNG, JPEG, WebP, PDF, animated PNG, GIF, MP4 and WebM.

### How is it distributed?

As an mcpb bundle and an OCI image, run over stdio.

### Is keyline free?

Yes. keyline is free to use.

### How do I add keyline to Claude Code?

Run this command in your terminal: claude mcp add keyline -- docker run -i --rm ghcr.io/keyline-dev/keyline-mcp:0.8.1

### What are the best alternatives to keyline?

The closest alternatives to keyline are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/keyline
