suggest_animation
Suggest animation primitives for a given intent or context.
Reference
Parameters
- Name
intent- Type
- string · required
- Description
What should be animated (e.g., "hero entrance", "loading state")
- Name
design_system_id- Type
- string · optional
- Description
Scope to a specific design system (uuid)
- Name
personality- Type
- string · optional
- Description
Motion personality slug to apply
- Name
count- Type
- number · optional
- Description
Number of suggestions to return (default:
3)
- Name
layerId- Type
- string · optional
- Description
Layer UUID for layer-specific primitive and personality resolution (uuid)
Returns
{
suggestions Array of { primitive, confidence, rationale, timing, alternatives }
personality_applied Whether personality token overrides were applied
}
Description
Suggest animation primitives for a given intent or context.
Takes a natural language description of what should be animated and suggests the most appropriate primitive(s) from the design system.
Parameters:
- intent: What should be animated (e.g., "hero entrance", "loading state", "content reveal")
- design_system_id (optional): Scope to a specific design system
- personality (optional): Motion personality slug to apply
- count (optional): Number of suggestions (default 3)
Decision tree:
- Parse intent for keywords → map to categories
- If embedding available, semantic search against primitive descriptions
- Filter by personality affinity if personality specified
- Rank by relevance and return top matches
Source
Defined in packages/mcp/src/tools.ts.
The request handler lives alongside its registration in packages/mcp/src/tools/.
Last reviewed by @jschuyler