# Foldline

> Foldline is a free MCP server for design and media. Render HTML canvas animations to MP4 on a Mac, with 66 code-made film styles. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** macOS, CLI
- **Website:** https://alireza12t.github.io/foldline/
- **Repository:** https://github.com/alireza12t/foldline
- **MCP Registry name:** io.github.alireza12t/foldline
- **Categories:** design and media
- **Listing updated:** 2026-11-14

## About

Foldline starts from a plain HTML page with a canvas and a render(t) function. It opens the page in headless Chrome, draws each frame and encodes the video inside the page using WebCodecs on the Mac's hardware encoder, so frames stay on the GPU. Pages that do not fit the single-canvas fast path still render through screenshots with VideoToolbox or x264.

The author's tests on an M1 Pro show an 8.4-minute 1080p 60 fps video rendering in 161 seconds versus 426 for the older route. It is built and tested on Apple Silicon Macs; Windows and Linux are untested.

The MCP server lets an agent pick one of 66 film styles, read the directing guide a section at a time, write the page, check stills, render, then add a voiceover and mix sound. Results are kept short to save tokens. It needs Node 20+, ffmpeg and Chrome's headless shell.

## Features

- **Hardware-encoded render:** Encodes in-page with WebCodecs on Mac hardware.
- **66 film styles:** Each style ships with a prompt and demo.
- **Fallback paths:** Screenshot capture with VideoToolbox or x264.
- **Audio mixing:** Mux a mix file into the MP4 as AAC.
- **Agent workflow:** Pick a style, check stills, render and add voice.
- **Compact replies:** Tool results are short to save tokens.

## Good for

- Produce an explainer video from code
- Render stills to review before a full render
- Add synthesized voice and music to a film
- Speed up long canvas renders on a Mac

## Install

### Claude Code (Terminal)

```sh
claude mcp add foldline -- npx -y foldline-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "foldline": {
      "command": "npx",
      "args": [
        "-y",
        "foldline-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "foldline": {
      "command": "npx",
      "args": [
        "-y",
        "foldline-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "foldline": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "foldline-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "foldline": {
      "command": "npx",
      "args": [
        "-y",
        "foldline-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "foldline": {
      "command": "npx",
      "args": [
        "-y",
        "foldline-mcp"
      ]
    }
  }
}
```

## FAQ

### Is it free?

Open source and free for non-commercial use.

### Does it work on Windows or Linux?

Untested; the fast path is for Apple Silicon Macs.

### What must be installed?

Node 20+, ffmpeg and Chrome's headless shell.

### Must the page be a single canvas?

For the fast path, yes; other pages use the slower route.

### Is Foldline free?

Yes. Foldline is free to use.

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

Run this command in your terminal: claude mcp add foldline -- npx -y foldline-mcp

### What are the best alternatives to Foldline?

The closest alternatives to Foldline 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/foldline
