Skip to content
MCP server

Foldline

Render HTML canvas animations to MP4 on a Mac, with 66 code-made film styles

Runs locallyStatus and history
Pricing
Free
Platforms
macOS, CLI
Runs
Locally
Version
1.2.0
Listing updated
3 days ago

About Foldline

Foldline is a free MCP server for design and media. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add foldline -- npx -y foldline-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "foldline": {
      "command": "npx",
      "args": [
        "-y",
        "foldline-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "foldline": {
      "command": "npx",
      "args": [
        "-y",
        "foldline-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • FOLDLINE_PYTHONPython for the voice, music and sheet tools (default: the library .venv, then ~/lemo-opuscar/.venv)
  • PLAYWRIGHT_CHROMEA chrome-headless-shell to use instead of the one Playwright installs

What it does

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

Pricing

Free

Free for non-commercial use

Prices change. Check alireza12t.github.io before you buy.

Foldline 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 to Foldline

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media