{"report":{"v":1,"package":"@kumoproductions/mcp-aftereffects","version":"0.3.2","ranAt":"2026-11-16T11:30:58.512Z","install":{"ok":true,"integrity":"sha512-Fr0n6+xvP0auDANSD7j+f5XIiKjKwkDT/1wWI2KdX8z/w7r4xX53LgvC/q8spcvwkj08hxuj2P8cUcEKqPrYxg==","deps":95,"scripts":[],"bins":["mcp-aftereffects"],"license":"MIT","engines":"node >=24.0.0","repository":"git+https://github.com/kumoproductions/mcp-aftereffects.git","bin":"mcp-aftereffects"},"start":{"ok":true,"ms":192,"serverName":"mcp-aftereffects","serverVersion":"0.3.2","protocol":"2025-06-18","stderr":"[mcp-aftereffects] policy: readonly=off, categories=all, eval.run=disabled\n[mcp-aftereffects] mailbox: /tmp/mcp-aftereffects/runtime\n[mcp-aftereffects] instance: none registered yet — calls launch AfterFX.exe -r into the running After Effects (instances started with -m need the agent: `mcp-aftereffects install-agent`)\n[mcp-aftereffects] WRITE ACCESS IS ON — tools can create, mutate and delete project content. Set AE_MCP_READONLY=1 for inspection-only sessions.\n"},"tools":[{"name":"ae_project_info","description":"Project-level info: file path, dirty flag, all items with type/summary, active item. Start here.","params":["instance"]},{"name":"ae_comp_info","description":"Detailed comp info: size, fps, duration, work area, motion blur, layer summaries. Pass a comp name or item id — or an ARRAY of them to fetch several comps in one call.","params":["nameOrId","instance"]},{"name":"ae_layer_info","description":"Full layer info: transform, effects, masks, text, shape contents, keyframes (incl. interpolation names and bezier ease speed/influence). layerIndex accepts one index, an ARRAY of indices, or 'all' — auditing a whole comp is one call. detail:'summary' drops properties still at their default value (unkeyed, no expression) — start there for audits; the full tree is often 100KB+ per comp. Set includeProperties=false to skip the property tree walk entirely.","params":["compNameOrId","layerIndex","includeProperties","detail","instance"]},{"name":"ae_render_frame","description":"Render one or more frames to PNG. Use to visually verify edits. The agent's 'eyes' — pair with mutations for a visual feedback loop. Headless and deterministic. Pass `time` for one frame, or `times` for several in ONE call (motion checks): files land at <outPath stem>_<index>.png and are listed in `frames`. `contactSheet` tiles every frame into one labelled PNG (<stem>_sheet.png) so a motion check is one image; `analyze` measures each capture (uniform edge bands = black bars / transparent margins, content bounds, coverage) so off-frame elements and letterboxing are caught numerically. In color-managed projects (workingSpace != None) the capture applies AE's own display transform via a transient OCIO Display Transform adjustment layer, and the PNG comes back viewer-accurate and sRGB-tagged. Where that layer cannot be used — read-only mode, an AE without the OCIO effect, or a failed capture calibration — the result falls back to a pure-math ACES conversion or to raw values with an explicit colorWarning; check colorPipeline / colorWarning on the response.","params":["compNameOrId","time","times","outPath","useDisplayStartTime","colorManaged","analyze","contactSheet","instance"]},{"name":"ae_save_project","description":"Save the project. Pass `path` for Save As.","params":["path","instance"]},{"name":"ae_project_export_json","description":"Serialize the entire project to JSON (folders, comps, layers, keyframes, effects, shapes, markers, time remap, solids, file refs). Write to `outPath` or return inline.","params":["outPath","pretty","instance"]},{"name":"ae_project_import_json","description":"Rebuild the project from JSON (produced by ae_project_export_json). Supports `clearFirst`, `dryRun` (validate-only), `skipValidation`.","params":["inPath","json","clearFirst","dryRun","skipValidation","instance"]},{"name":"ae_version_info","description":"AE version, build, capabilities (saveFrameToPng, app.effects, Socket). Call at session start to know what APIs are available.","params":["instance"]},{"name":"ae_catalog","description":"Discover available atomic operations for ae_do. Without args: all categories with their operation names. With a category: detailed params per operation. Only operations this server will actually execute are listed.","params":["category"]},{"name":"ae_do","description":"Execute an atomic operation by name (from ae_catalog). Arguments are validated against the operation's declared parameters before anything reaches AE. Have more than one operation to run? Wrap them in ONE batch.run instead of several ae_do calls — read/verify steps (comp.info, layer.info, render.frame) can ride in the same batch. Every call is automatically wrapped in ONE undo group: a single Ctrl+Z (or project.undo) reverts the entire call, and a batch.run counts as one call. Never call app.beginUndoGroup/endUndoGroup in eval.run code — the wrapper already did. The exception is undo/redo itself (project.undo, command.execute id 16/2035): those run outside the group and cannot ride inside a batch.run. Response includes ambient context (active comp, selected layers, project state) at zero extra round trips. Example: ae_do({ operation: 'keyframe.add', args: { comp: 'Main', layer: 1, property: ['Transform','Position'], time: 2, value: [960,540] } })","params":["operation","args","timeoutMs","instance"]},{"name":"ae_context","description":"Ambient context: project state, active comp, selected layers, item list, AE.* helpers, ES3 rules, and the undo contract (every call = one auto undo group). Call at session start; then rely on ae_do response context.","params":["instance"]}],"toolsHash":"c31c82e506bf15639b4c48e15f160335dc95b2edd42ab32989972debb85ad7ca","wrote":[],"callsAt":"2026-11-16T11:31:04.966Z","calls":[{"tool":"ae_project_info","ok":false,"ms":4,"bytes":0,"error":"tool reported an error: [AE_NOT_FOUND] Could not locate AfterFX.exe. Set the AE_MCP_EXE env var to the full path, e.g. \"C:/Program Files/Adobe/Adobe After Effects 2026/Support Files/AfterFX.exe\""},{"tool":"ae_version_info","ok":false,"ms":1,"bytes":0,"error":"tool reported an error: [AE_NOT_FOUND] Could not locate AfterFX.exe. Set the AE_MCP_EXE env var to the full path, e.g. \"C:/Program Files/Adobe/Adobe After Effects 2026/Support Files/AfterFX.exe\""}],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[],"callNames":[],"callConns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[],"tools":11,"wrote":0,"callsTried":2,"callsAnswered":0,"callContacts":[]},"history":[{"package":"@kumoproductions/mcp-aftereffects","version":"0.3.2","ranAt":"2026-11-16T11:30:58.512Z","outcome":"started","tools":11,"contacts":0,"flags":0,"serious":0,"toolsHash":"c31c82e506bf15639b4c48e15f160335dc95b2edd42ab32989972debb85ad7ca"}],"page":"https://bragproof.smaverk.com/r/%40kumoproductions/mcp-aftereffects"}