Skip to content
MCP server

AgentFX

Let an AI agent script, lint, preview and render fluid, physics and glitch video effects

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, self-hosted, Linux
Runs
Locally
Version
0.1.1
Listing updated
3 days ago

About AgentFX

AgentFX is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

Most agent video tools screenshot a headless browser. AgentFX has its own Rust renderer on CPU or GPU, so effects that need state across frames, such as fluid ink, rigid-body physics, Voronoi shatter, slit-scan and shutter motion blur, are built in and deterministic. The same script always produces the same frames.

The agent writes a compact text format called Reel Script (.reel), roughly one line per element or event. Before rendering it can lint the script with fix hints, grab single frames, a contact sheet or a hand-drawn style storyboard to check its own work, then render to mp4, gif, webp, mov or webm and in other aspect ratios such as 9:16. The site lists 16 effects and an optional director mode that agrees look, beats and a storyboard with you first.

It is open source under Apache 2.0. The registry package is a Docker image that bundles the CLI, renderer, ffmpeg and the MCP server (a Python standard-library script); GPU effects fall back to the CPU path inside the container. A Claude Code plugin bundles the skill and server and needs Docker.

Install

Run in a terminal

claude mcp add agentfx -- docker run -i --rm ghcr.io/agentfxhq/agentfx:0.1.1

Add to claude_desktop_config.json

{
  "mcpServers": {
    "agentfx": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/agentfxhq/agentfx:0.1.1"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "agentfx": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/agentfxhq/agentfx:0.1.1"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "agentfx": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/agentfxhq/agentfx:0.1.1"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "agentfx": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/agentfxhq/agentfx:0.1.1"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "agentfx": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/agentfxhq/agentfx:0.1.1"
      ]
    }
  }
}

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

agentfx_spec
Returns the Reel Script specification.
agentfx_catalog
Lists what the format can do.
agentfx_lint
Lints a script with fix hints.

What it does

Reel Script format
Compact line-based scripts designed for language models to write.
Built-in simulations
Fluid and ink, physics, shatter and particles solved inside the engine.
Lint and preview
Lint with fix hints, single frames, contact sheets and storyboards before rendering.
Deterministic renders
Seeded effects give identical frames on every render.
Multiple outputs
Renders mp4, gif, webp, mov or webm in several aspect ratios.
Docker packaging
One image with CLI, renderer, ffmpeg and MCP server.

Good for

  • Produce a short logo reveal with ink effects from a prompt
  • Make vertical and landscape versions of the same clip
  • Generate beat-synced motion graphics
  • Iterate on a video by diffing scripts and checking contact sheets
  • Create looping GIF effects for social posts

Pricing

Open source

Apache 2.0

Prices change. Check agentfx.dev before you buy.

AgentFX FAQ

What licence is it under?

Apache 2.0.

Does it need a browser?

No. It uses its own native renderer, not browser capture.

How do I try it quickly?

Run the Docker image on examples/quickstart.reel, or add the image to Claude Code as an MCP server.

Is a GPU required?

No. GPU effects fall back to CPU in the container; Vulkan on Linux or Metal on macOS enable GPU use when building from source.

Is AgentFX free?

Yes. AgentFX is open source, so you can use and self-host it for free.

How do I add AgentFX to Claude Code?

Run this command in your terminal: claude mcp add agentfx -- docker run -i --rm ghcr.io/agentfxhq/agentfx:0.1.1

What are the best alternatives to AgentFX?

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

Alternatives to AgentFX

  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