EtchMotion Studio 1.0

Agent reference

Use this page as the source of truth for safe local automation. Read the live catalog before choosing a recipe. Review sources before creating projects.

Open machine-readable JSONConnection guide

Connection contract

Local, discovered, short-lived.

The bridge finds EtchMotion's runtime discovery file, validates a 127.0.0.1 origin and sends the rotating x-etchmotion-token header. Never expose or persist the token. The desktop app must remain open.

Transportstdio MCP to loopback HTTP
Cloud renderNone
Publish toolsNone

Required workflow

Review first. Prove the look. Then scale.

  1. Call status, catalog and Channel Styles.
  2. Search or batch-preview new external subjects.
  3. Show identity, creator, licence, source page and warnings.
  4. Render one or two proofs for a new recipe.
  5. State engine, preset, layout, music and duration before creation.
  6. Poll jobs and report concrete project IDs or failures.

MCP tools

Fifteen small, inspectable actions.

etchmotion_statusRead

Runtime, queue and library counts

etchmotion_catalogRead

Current engines, recipes, templates and music

etchmotion_projectsRead

Completed projects, masters and exports

etchmotion_compositionsRead

Longer multi-scene productions

etchmotion_channel_stylesRead

Latest immutable styles and version history

etchmotion_save_channel_styleWrite

Save a new immutable style version

etchmotion_plan_channelWrite

Build a reviewed plan and upload-ready CSV

etchmotion_jobsRead

Persistent queue and recovery state

etchmotion_searchPreview

Reusable source candidates

etchmotion_batch_previewPreview

Reviewed candidates for newline subjects

etchmotion_createWrite

One reviewed local project

etchmotion_batch_createWrite

Up to 24 reviewed local projects

etchmotion_composeWrite

A two to twelve scene composition

etchmotion_cancel_jobWrite

Cancel one queue step without deleting files

etchmotion_retry_jobWrite

Retry a recoverable queue step

Generator contract

Six engines with explicit presets.

engraving

Portraits, objects and full scenes drawn with ordered marks

photoreal, atelier, classic

color-regions

A pencilled colouring page followed by a paced colour reveal

atelier-premium-v2, storybook, poster, stained-glass

restoration

Disclosed creative restoration sequence

museum-conservation, family-album, colour-memory

mosaic

Material pieces assembled around important detail

artisan-ceramic, ceramic, paper-cut, pixel-luxe

painted-canvas

Progressive painting, including a hard-surface product route

product-gouache, oil-linen, gouache-board, watercolour-coldpress

story-plate

Structured explanation with semantic callouts and optional local narration

editorial-ink, field-guide, darkboard

Restoration is a creative simulation, not forensic recovery. Story Plate works best with a structured brief and verified callout facts. Engraving Atelier is portrait-only.

Shared settings

Keep important choices explicit.

Presentation

auto, framed, editorial, sketchbook, blueprint, product-stage

Format

vertical, portrait, square, landscape

Subject mode

auto, portrait, full-scene, isolated-object

Detail

standard, dense, ultra

Visible tool

physical, classic

Colour page opening

draw-first or ready-page

Duration

18 to 90 seconds for one render

creation settingsJSON
{
  "generatorMode": "engraving",
  "generatorPreset": "photoreal",
  "detail": "dense",
  "hook": "Can you name this computing pioneer?",
  "brand": "Gallery of Faces",
  "theme": "gallery-gold",
  "subjectMode": "portrait",
  "presentation": "framed",
  "toolStyle": "physical",
  "coloringPageMotion": "ready-page",
  "drawSeconds": 35,
  "outputFormat": "vertical",
  "musicAsset": "quiet-archive",
  "musicVolume": 0.18,
  "pencilSound": true,
  "pencilVolume": 0.55,
  "voiceVolume": 0.9
}

A custom opening question belongs in hook. It must be present when the project is created and again when the video is rendered from saved project settings.

Payload pattern

Pass reviewed data, not a vague prompt.

Batch preview lines

Ada Lovelace | Can you name this computing pioneer?
Monarch butterfly | Why does this traveller cross a continent?

One project

{
  "request": {
    "name": "Ada Lovelace",
    "imageUrl": "REVIEWED_ORIGINAL_URL",
    "source": { "title": "KEEP_FULL_SOURCE_RECORD" },
    "settings": {
      "generatorMode": "engraving",
      "generatorPreset": "photoreal",
      "hook": "Can you name this computing pioneer?",
      "autoRender": true
    },
    "draft": true
  }
}

Longer video

{
  "request": {
    "projectIds": ["ready-project-a", "ready-project-b"],
    "title": "How nature solves difficult problems",
    "templateId": "wide-documentary",
    "draft": true
  }
}

Rights and safety

What an agent must not assume.

  • A search result is a candidate, not legal clearance.
  • Check licence, attribution, identity, likeness, privacy, publicity and trademarks for the planned use.
  • Do not imply historical authenticity for a simulated restoration.
  • Do not publish or delete. Those actions are intentionally outside the API.
  • Use smaller reviewed production batches for a six-month plan instead of hiding all source decisions in one call.