SyntheticSynthetic/Docs
ProductsChangelog
Dashboard →

Architecture

How it works

The AE MCP bridges Claude and After Effects using a lightweight server that translates AI intent into ExtendScript commands.

The MCP architecture

MCP (Model Context Protocol) is an open standard that lets AI assistants call external tools. Synthetic implements an MCP server that exposes 270+ After Effects operations as callable tools — Claude picks the right ones automatically based on your instructions.

Data flow
Claude (or MCP client)
──── MCP call ────▶
AE MCP Server
▼ generates JSX script
──── ExtendScript ────▶
Adobe After Effects
▼ returns JSON result
Claude (or MCP client)
◀─── JSON result ────
AE MCP Server

The full round-trip — from Claude calling a tool to After Effects executing it and returning data — typically takes under 1 second for simple operations.

What is ExtendScript?

ExtendScript is Adobe's scripting language for Creative Cloud applications. It's a JavaScript dialect (ES3-level) that has direct access to the After Effects object model — compositions, layers, properties, render queues and everything else.

Adobe has supported ExtendScript in After Effects since CS3 (2007). Every version from After Effects 2021 (CC 2021) through the latest 2026 release ships with the ExtendScript engine built in, which is why the AE MCP works across all of those versions with zero extra installs.

Why ExtendScript and not CEP or UXP?

ApproachVersionsRequires install
ExtendScript (used by Synthetic)2021 – 2026+No — built in
CEP panelCC 2015 – 2024Yes — panel must be installed
UXP plugin2022+Yes — plugin must be installed
Because ExtendScript is built into After Effects, Standalone mode needs nothing installed inside AE. Panel mode (the default on macOS) uses a small panel that Synthetic Setup installs for you.

How the MCP server sends scripts to AE

When Claude calls a tool (for example create_comp), the MCP server:

  1. Validates the input parameters against the tool's schema.
  2. Generates a JSX script string containing the corresponding ExtendScript logic.
  3. Hands the script to After Effects as a temporary .jsx file: in Standalone mode it launches After Effects to run it; in Panel mode the panel inside the open After Effects runs it.
  4. Reads the JSON response that AE writes back to a temp file.
  5. Returns the parsed result to Claude as the tool's output.
In Panel mode After Effects must be open, and in any mode a modal dialog blocks it. If AE shows a "save changes?" prompt or any blocking dialog, tool calls will time out.

Security model

The MCP server runs locally on your machine. Your project files, layer names, and composition data never leave your computer. Synthetic only validates your license against api.synthetic.com.ar.