Tools & Keyframes Reference

Complete reference for all MCP tools exposed by DevMotion and the keyframe animation system.

Available Tools

create_project

{
  "name": "TikTok Intro",
  "width": 1080,
  "height": 1920
}

Returns the project id and a preview URL. Use the id in every subsequent call.

create_layer

Creates a complete layer in a single call. The layer field is required and carries the type + props.

{
  "projectId": "your_project_id",
  "name": "Title",
  "layer": {
    "type": "text",
    "props": {
      "content": "Hello World",
      "fontSize": 64,
      "color": "#ffffff"
    }
  },
  "transform": {
    "position": { "x": 0, "y": -200 }
  },
  "animation": {
    "keyframes": [
      { "id": "kf1", "time": 0,   "property": "position.x", "value": -400, "easing": "ease-out" },
      { "id": "kf2", "time": 0.5, "property": "position.x", "value": 0 }
    ]
  }
}

{
  "projectId": "your_project_id",
  "name": "Accent Shape",
  "layer": {
    "type": "shape",
    "props": {
      "shapeType": "rectangle",
      "background": { "type": "solid", "color": "#ff4455" }
    }
  },
  "transform": {
    "position": { "x": 0, "y": 300 },
    "scale": { "x": 0.8, "y": 0.1 }
  },
  "animation": {
    "preset": { "id": "fade-in", "startTime": 0.2, "duration": 0.4 }
  }
}

create_layer fields

edit_layer

Patch-style update — only the fields you provide are changed.

{
  "projectId": "your_project_id",
  "layerId": "layer_abc",
  "transform": {
    "position": { "x": 100, "y": -200 }
  },
  "props": {
    "color": "#ffcc00"
  }
}

props are merged with existing props. transform and style replace the entire section if provided.

remove_layer

{
  "projectId": "your_project_id",
  "layerId": "layer_abc"
}

layerId accepts either the layer’s ID or its display name.

configure_project

{
  "projectId": "your_project_id",
  "width": 1920,
  "height": 1080,
  "duration": 10,
  "backgroundColor": "#1a1a2e"
}

All fields are optional. backgroundColor is a hex string.

group_layers / ungroup_layers

{
  "projectId": "your_project_id",
  "layerIds": ["layer_abc", "layer_def"],
  "name": "Background Group"
}

{
  "projectId": "your_project_id",
  "groupId": "group_xyz"
}

Media Actions

These tools run AI-powered operations on media layers (video/audio). Each action creates new layers and/or modifies the source layer automatically.

action_generate_captions

Transcribe a video or audio layer into word-level captions using Whisper AI.

{
  "projectId": "your_project_id",
  "layerId": "video_layer_id",
  "language": "en",
  "prompt": "Optional context for transcription accuracy"
}

Creates a new captions layer linked to the source media.

action_dub_audio

Dub audio into another language using AI voice cloning (ElevenLabs).

{
  "projectId": "your_project_id",
  "layerId": "audio_layer_id",
  "targetLang": "es"
}

Creates a new audio layer with the dubbed track and mutes the original.

action_extract_audio

Extract the audio track from a video layer using FFmpeg.

{
  "projectId": "your_project_id",
  "layerId": "video_layer_id"
}

Creates a new audio layer and mutes the original video. Free — no AI credits required.

Layer Types

Keyframe Animation

Layers are animated by adding keyframes at specific times. DevMotion interpolates between them automatically using the easing curve you specify.

Pass keyframes inside animation.keyframes when calling create_layer, or add them later with edit_layer.

Animatable Properties

Keyframe schema

Each keyframe requires an id (any unique string — DevMotion replaces it internally):

{ "id": "kf1", "time": 0.5, "property": "position.y", "value": -200, "easing": "ease-out" }

Easing Values

Example Prompts

• “Create a 9:16 product showcase with a phone mockup image, a title, and a price tag that bounces in.”
• “Make a lower-third bar with white text on a semi-transparent dark background that slides in from the left.”
• “Build a 5-second countdown animation with a large number that scales up and fades out each second.”
• “Edit the ‘Headline’ layer to use yellow and add a shake animation.”