Skip to main content
Glama
NAJEMWEHBE

unreal-ai-connection

sequencer_add_transform_keyframe

Adds a keyframe to a Level Sequence's 3D Transform Track for a bound actor, with optional location, rotation, and scale values.

Instructions

Add a single keyframe on a Level Sequence's 3D Transform Track for a previously-bound actor. SYNTHETIC bridge-side handler. Closes the keyframe-authoring half of the 21st HANDOFF note's Sequencer parked item: create_sequence + bind_actor_to_sequence already exist; this tool wires up MovieSceneSequenceExtensions.find_binding_by_id + MovieSceneBindingProxy.add_track + MovieSceneScriptingDoubleChannel.add_key. Caller passes location/rotation/scale as optional 3-element triples; missing triples skip those channels. Rotation order is [pitch, yaw, roll] (unreal.Rotator convention) — mapped internally to the channel layout (Roll=X, Pitch=Y, Yaw=Z). Movie Render Queue remains parked.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
sequence_pathYesUE asset path of the LevelSequence; must start with /Game/.
binding_idYesGUID string returned by bind_actor_to_sequence. Accepts the bare 32-hex form (no dashes) UE produces by default; dashed/braced forms also parse.
time_secondsYesTime in seconds (display rate) at which to place the keyframe. Must be >= 0; converted internally to a tick-resolution FrameNumber.
locationNoOptional [x, y, z] translation. Omit to skip Location channels.
rotationNoOptional [pitch, yaw, roll] in degrees (unreal.Rotator convention). Omit to skip Rotation channels.
scaleNoOptional [x, y, z] scale. Omit to skip Scale channels.
interpolationNoKey interpolation. One of 'linear' (default), 'constant', 'auto', 'smart_auto', 'cubic'. 'cubic' is an alias for SMART_AUTO.
auto_extend_sectionNoIf true (default), extends the track section's seconds-range to cover time_seconds when needed.
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description carries full burden. Discloses synthetic handler, internal wiring, optional triples skip channels, rotation order, interpolation with alias, auto-extend. Lacks error handling or side effects.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Efficient, front-loaded with core action, each sentence adds unique value. No fluff, appropriate length.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 8 params, no output schema, description covers prerequisites, optional parameters, rotation convention, interpolation options, and auto-extend. References related tools, making it complete for agent usage.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage 100%, baseline 3. Description adds value by explaining rotation order (pitch/yaw/roll), interpolation alias, and time_seconds conversion, beyond schema descriptions.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description clearly states 'Add a single keyframe on a Level Sequence's 3D Transform Track for a previously-bound actor'. It differentiates from siblings like bind_actor_to_sequence and create_sequence by specifying the context of keyframe authoring.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Provides context: it closes the keyframe-authoring half of a prior note and lists prerequisites (sequence_path, binding_id). However, it does not explicitly state when not to use this tool or suggest alternatives.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Install Server

Other Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/NAJEMWEHBE/unreal-ai-connection'

If you have feedback or need assistance with the MCP directory API, please join our Discord server