surehand-mcp
Surehand MCP for Adobe After Effects: Claude, ChatGPT, Codex, Cursor and VS Code work inside After Effects, with a change report on every edit, pixel-proven changes and delivery checks. Free, open source, Mac and Windows.
Install / Use
claude mcp add ConformLabs -- npx -y github:ConformLabs/surehand-mcpIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
AI & Machine LearningSupported Platforms
Our assessment of surehand-mcp
surehand-mcp scores 75/100 on our quality scale, 836th of 950 AI & Machine Learning skills we index.
Its MCP Server is 100 KB long, well organised into 54 sections with 8 code examples: long enough that it reads more like full documentation than a focused instruction file, which agents can find harder to follow.
It has 10 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated 26 days ago, so surehand-mcp is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 97/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
surehand-mcp compared with similar skills
All 4 of these similar skills score higher than surehand-mcp; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| surehand-mcp (this skill)by ConformLabs | 75 | 10 | 26d ago | MCP Server |
| taste-skillby Leonxlnx | 100 | 120.0k | today | CLAUDE.md |
| claude-memby thedotmack | 100 | 119.0k | today | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 114.0k | today | CLAUDE.md |
| Understand-Anythingby Egonex-AI | 100 | 93.7k | today | CLAUDE.md |
Frequently asked questions
- How do I install surehand-mcp?
- Run
claude mcp add ConformLabs -- npx -y github:ConformLabs/surehand-mcp. The install tabs above show the steps for each supported agent. - Which AI agents does surehand-mcp work with?
- It is written for Claude Code, Claude Desktop, Cursor, GitHub Copilot and OpenAI Codex, as a MCP Server file. Other agents that read the same format can often use it too.
- Is surehand-mcp safe to use?
- It is MIT-licensed and scores 97/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is surehand-mcp still maintained?
- The repository was last updated 26 days ago, so surehand-mcp is actively maintained.
Skill content
View source on GitHubSurehand MCP lets the AI app you already use work inside Adobe® After Effects®, and shows you what it did. It is for motion designers, finishing artists and technical directors who can't deliver on "the AI says it's done". Every edit is one undo step and comes back with an exact list of what changed. Structural changes come with pixel proof that the picture didn't change. Deliveries are checked against your own spec, templates are pushed through worst-case inputs, and every version built from data is checked row by row. Verified, not trusted.
- AI apps: Claude (Desktop and Code), ChatGPT (desktop app and web), Codex, Cursor, VS Code (GitHub Copilot), Windsurf / Devin Desktop, LM Studio, or any MCP client. Inside After Effects, the Surehand panel can also chat through Codex, Claude Code or Antigravity on your own sign-in.
- After Effects: 2025 and 2026 on macOS and Windows, in any language, are tested release by release. The extension loads in CC 2019 (16.0) and newer; versions before 2025 are best effort.
- Install: signed and notarized
.pkgfor Mac, signedSetup.exefor Windows. No administrator rights, no account. Free and open source (MIT). - Website and downloads: conformlabs.co/surehand.
It doesn't generate images and ships no presets or canned looks. It works on your project, by your rules, and measures the result.
AI app ──MCP──> surehand-ae server (Node, on your computer) ──localhost──> Surehand panel (CEP, inside After Effects) ──> ExtendScript
See it work
Four short demos, recorded on Surehand 1.4.1 and After Effects 2026. Long waits are cut and marked on screen; nothing is sped up. All four as a playlist, or on conformlabs.co/surehand.
- Precomp surgery: Claude un-precomposes a comp, keeps every expression working and proves the picture didn't change (16 frames, zero difference).
- Preflight: a comp checked against the client's delivery spec finds 5 problems, each with a timecode, then one is fixed and checked again.
- Stress test: a lower-third template with long German names, Arabic, Hebrew and huge numbers; 28 of 33 variants break, and the original comp is confirmed unchanged.
- Farm render: a render split across 4 aerender processes, and every one of the 250 frames verified.
<a name="example-prompts"></a>
What you can ask it
Real requests, in your words. The AI picks the tool; the tool does the measuring.
| You ask | The tool |
|---|---|
| "Check Endcard against our broadcast spec before I send it." | ae_preflight: the comp and the rendered file against your delivery spec, with timecoded findings |
| "Stress-test the lower third with long German names and Arabic." | ae_stress_test: worst-case inputs through every control, each result measured, your comp left untouched |
| "Un-precompose Logo_Lockup and prove nothing changed." | ae_precomp_surgery: rehearsed on a scratch copy, applied only when the pixels match |
| "Why does this render slowly? Speed it up only where the picture stays identical." | ae_render_profile: a timeline cost map, then speed-ups kept only when proven identical |
| "Split the render across 3 processes and prove every frame is there." | ae_farm: chunks, aerender scripts, a local parallel run and a completeness check |
| "Make a version of Score Card for every row of scores.csv, and check each one before you queue them." | ae_versions_from_data: one undo step, every row read back and measured |
| "Export the texts for the Hebrew and French translators. When they come back, fit them: tracking down to -40, never below 36 px." | ae_localize: CSV or XLIFF out, a checked version per language back in |
| "Make a 9:16 of Promo. Logo pinned 80 px from the top, titles inside title-safe." | ae_reformat: your rules, checked on every frame |
| "I inherited this project. What does the render queue actually pull in, and what's fragile?" | ae_project_xray: a read-only explanation, with precise locations |
| "What changed between v11 and v12?" | ae_project_history: snapshots and a readable diff |
Everyday edits work the same way: comps, layers, keyframes at Graph Editor precision, expressions, effects, text, masks, 3D, audio, footage, Essential Graphics and render settings, plus any After Effects script when no tool fits. See the full tool list.
<a name="download"></a><a name="requirements"></a>
Install
| Your setup | Download |
|---|---|
| Mac | Surehand-MCP-<version>.pkg (signed and notarized) |
| Windows | Surehand-MCP-Setup-<version>.exe (signed) |
| Claude Desktop only | Surehand-MCP.mcpb |
| Setups the installers don't cover | Surehand-MCP-<version>.zip (Mac and Windows scripts; open START HERE.txt) |
Nothing else is needed: the .pkg and Setup.exe include Node.js 24, the .mcpb uses Claude Desktop's built-in
Node.js, and the zip's installer downloads Node.js if it is missing.
Step-by-step setup guides for each AI app: Claude, ChatGPT and Codex, Cursor, VS Code, Windsurf, LM Studio.
Mac and Windows installers
- Mac: double-click
Surehand-MCP-<version>.pkgand follow the steps. No administrator password: everything goes into your own home folder. Windows: runSurehand-MCP-Setup-<version>.exe. It installs per user, with no administrator rights. - Restart After Effects once.
- Restart the AI apps that were open during the install.
Both installers put a private Node.js 24, the server and the After Effects extension on your computer, connect the AI apps they find, and write the Surehand skills for them (see The installer).
First run
The bridge starts with After Effects; nothing needs to be opened. To see it, open Window > Extensions > Surehand MCP. A green dot means connected. The panel shows the latest calls, the permission mode and Pause AI.
Then ask your AI app something simple:
"Check After Effects is connected, then make a 1080p comp with an animated title and show me frame 1."
If something is off, the panel's ☰ › Test the connection (or surehand-ae selftest) says what and how to fix it.
Claude Desktop only (.mcpb)
Double-click Surehand-MCP.mcpb and click Install in Claude Desktop, then restart After Effects once. On first
start the server installs its After Effects extension by itself. Use either the .mcpb or an installer for Claude
Desktop, not both.
The zip
The same installer as double-click scripts, for setups the installers don't cover:
Surehand-MCP/
START HERE.txt
1. Claude Desktop (easiest)/ Surehand-MCP.mcpb
2. Mac/ 1. Install, 2. Test Installation, 3. Connect ChatGPT, 4. Uninstall (.command)
3. Windows/ 1. Install, 2. Test Installation, 3. Connect ChatGPT, 4. Uninstall (.bat)
Support files/ run.sh, run.ps1, surehand-ae.mjs, this README
Double-click 1. Install in 2. Mac or 3. Windows, then restart After Effects once. With After Effects open,
2. Test Installation checks everything. START HERE.txt (from installer/START HERE.txt) has the same steps in
plain language, including what to do if macOS Gatekeeper or Windows SmartScreen blocks the files.
The installer
What every installer (.pkg, Setup.exe, or 1. Install from the zip) does:
- uses the private Node.js 24 that the
.pkg/Setup.exeput in~/.surehand/node; the zip's scripts use the Node.js on your PATH, or download a private Node.js 22 LTS into~/.surehand/node(checksum-verified) - copies the MCP server to
~/.surehand/ae/server/surehand-ae.mjs(one self-contained file) - installs the After Effects extension into your user CEP extensions folder. The extension is signed,
so it loads without enabling unsigned extensions (
PlayerDebugMode) - creates
~/.surehand/ae/config.jsonwith a random access token - registers the server, under the name
surehand-ae, with the AI apps it finds: Claude Desktop, Claude Code, ChatGPT desktop / Codex (~/.codex/config.toml, created if the ChatGPT or Codex app is installed), Cursor, VS Code (its usermcp.json, used by GitHub Copilot's Agent mode), Windsurf / Devin Desktop (~/.config/devin/mcp_config.json,%APPDATA%\devinon Windows, and Windsurf's~/.codeium/windsurf/mcp_config.jsonwhile that folder is there) and LM Studio (~/.lmstudio/mcp.json). Before a config file is changed, a timestamped backup is made next to it (*.surehand-<time>.bak, the newest three are kept); the very first original also stays as*.surehand.bak. If Claude Desktop is open it offers to restart it, because a running Claude Desktop overwrites its config file - writes the Surehand skills (see Skills) for the AI apps that read skill files, and the zips to upload in Claude Desktop chat
The server also checks the After Effects extension every time it starts and installs or updates it if needed.
To uninstall: double-click 4. Uninstall from the zip, or run surehand-ae uninstall (and remove the .mcpb in
Claude Desktop > Settings > Extensions if you used it). Checkpoints are kept unless you pass --all.
Skills
Four Agent Skills teach the AI how to work with Surehand well:
surehand-ae: the basics. Check the connection, read before editing, confirm each edit with its change report, look at the result, never work around a refusal, plus the ExtendScript traps seen live.surehand-ae-delivery: preflight against your own delivery spec, stress tests, versions from data checked row by row, the localization round trip, farm renders.surehand-ae-safe-restructure: structural edits and render speed-ups with pixel proof.surehand-ae-timing-layout: exact keyframes, easing, measured alignment and reformats.
The source is skills/ in this repo.
- The installer writes them to
~/.claude/skills/(Claude Code; Cursor and VS Code read it too) and~/.agents/skills/(ChatGPT desktop / Codex, Cursor, VS Code, Windsurf / Devin Desktop);%USERPROFILE%on Windows. A folder is written only when one of those apps is on the computer (or the folder is there already). Only the foursurehand-ae*folders are written, replaced on update and removed on uninstall; other skills are never touched. - For Claude Desktop chat: upload the skills in Customize › Skills › Upload a skill (files in
~/.surehand/ae/skills, one zip per skill). claude.ai takes the s
Truncated for display — read the full file on GitHub.
Related Skills
taste-skill
120.0kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
claude-mem
119.0kPersistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Agent-Reach
114.0kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Understand-Anything
93.7kGraphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

