This server has 24 tools with significant definition gaps. Most tools lack detailed descriptions (many under 50 chars), parameter descriptions are minimal or absent, and output schemas are not documented. Tool names follow verb_noun convention (good), but descriptions are too terse to guide LLM selection. No tool annotations (readOnlyHint/destructiveHint) despite clear risk classifications. Error handling and recovery guidance are absent. The server reads like an internal API wrapper rather than an LLM-optimized tool interface.

• Expand tool descriptions to 80 - 150 chars. For each tool, answer: What does it do? When should the LLM call it instead of similar tools? Example: 'snapshot_comp: Capture the current state of a composition (layers, properties, effects) for later comparison. Use before making changes to enable diff_comp to show what changed.' vs current 'Take a snapshot of a composition state'.
• Add tool annotations to all tools. Mark all WRITE tools with destructiveHint=true, all READ_ONLY tools with readOnlyHint=true, and idempotent tools (get_*, list_*, check_*) with idempotentHint=true. This signals to LLMs which tools are safe to retry.
• Document output schemas for all tools. For list_comps, specify: returns {comps: [{id: number, name: string, width: number, height: number, frameRate: number, duration: number}], total: number}. For get_job, specify: {jobId: string, status: 'pending'|'running'|'completed'|'failed', progress?: number, result?: any, error?: string}.
• Add detailed parameter descriptions. For compId, write: 'Composition ID (number). Obtain from list_comps() or create_comp().' For propertyPath in add_keyframe, write: 'Array of property names forming the path, e.g. ["Transform", "Position"] for layer position or ["Effects", "Gaussian Blur", "Blur Values"] for effect parameters.'
• Add error handling and recovery guidance to destructive/complex tools. For run_jsx: 'Returns {success: boolean, output?: string, error?: string, line?: number}. If error is returned, the LLM should inspect the error message and line number, correct the code, and retry. Common errors: ReferenceError (undefined variable), SyntaxError (malformed code), or timeout (operation took >30s).' For setup_panel: 'Returns {installed: boolean, version: string, message: string}. If installed=false, the LLM should guide the user to manually install the CEP panel or check After Effects permissions.'

Inferred effective spec: <=2025-11-25.

• Relies on Logging (deprecated) - log to stderr or use OpenTelemetry