Skip to main content

get_animation_primitives

Browse and filter animation primitives from the design system.

Reference

Parameters

  • Name
    design_system_id
    Type
    string · optional
    Description

    Filter by design system UUID (uuid)

  • Name
    category
    Type
    enum · optional
    Description

    Filter by animation category (entrance · exit · emphasis · attention · text · stagger · scroll · continuous · data)

  • Name
    composable_only
    Type
    boolean · optional
    Description

    Only return composable primitives (default: false)

  • Name
    stagger_only
    Type
    boolean · optional
    Description

    Only return stagger-compatible primitives (default: false)

  • Name
    search
    Type
    string · optional
    Description

    Fuzzy name search

  • Name
    layerId
    Type
    string · optional
    Description

    Layer UUID for layer-specific primitive resolution (uuid)

Returns

{
  primitives  Array of matching animation primitives with name, category, timing, CSS class, and guidance
  count       Total number of matches
}

Description

Browse and filter animation primitives from the design system.

Animation primitives are named animation effects (focus-stagger, typewriter, content-cycle, blur-reveal, etc.) that can be composed into sequences.

Parameters:

  • design_system_id (optional): Filter by design system
  • category (optional): Filter by category (entrance, exit, emphasis, attention, text, stagger, scroll, continuous, data)
  • composable_only (optional): Only return primitives that can be chained
  • stagger_only (optional): Only return stagger-compatible primitives
  • search (optional): Fuzzy name search

Source

Defined in packages/mcp/src/tools.ts. The request handler lives alongside its registration in packages/mcp/src/tools/.

Was this page helpful?

Last reviewed by @jschuyler