# AgentFX

> AgentFX is an open-source MCP server for design and media. Let an AI agent script, lint, preview and render fluid, physics and glitch video effects. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Linux, macOS
- **Website:** https://agentfx.dev
- **Repository:** https://github.com/agentfxhq/agentfx
- **MCP Registry name:** io.github.agentfxhq/agentfx
- **Categories:** design and media
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

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

## 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

- [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/agentfx
