API & MCP
Everything a person can do on Storyboard Camera Move Planner, a program or AI agent can do with the same inputs and get the identical result.
HTTP API
POST https://fliplinecameramove.usefulweb.app/api/v1/calculate– run Storyboard Camera Move PlannerGET https://fliplinecameramove.usefulweb.app/api/v1/tool– inputs, output schema, examples- OpenAPI 3.1: /openapi.json · /openapi.yaml
- Errors:
application/problem+json;422includes per-fielderrors.
Storyboard Camera Move Planner
Describe a 2-D camera move over a storyboard or animation canvas: start and end view centre, zoom and rotation, timing within the shot and a CSS easing. Get the view rectangle for every frame as a table and CSV, a plan drawing and an editable Story Desk board that plays the move in Flipline.
| Field | Type | Default | Description |
|---|---|---|---|
width | integer | 960 | Canvas width (px) |
height | integer | 540 | Canvas height (px) |
fps | integer | 24 | Frame rate (FPS) |
seconds | number | 3 | Shot length (seconds) |
preset | select (custom, pan-left, pan-right, tilt-up, tilt-down, push-in, pull-out, handheld) | "custom" | Camera preset |
fromX | number | 50 | Start centre X (%) |
fromY | number | 50 | Start centre Y (%) |
fromZoom | number | 100 | Start zoom (%) |
fromRotation | number | 0 | Start rotation (degrees) |
toX | number | 58 | End centre X (%) |
toY | number | 45 | End centre Y (%) |
toZoom | number | 160 | End zoom (%) |
toRotation | number | 0 | End rotation (degrees) |
easing | text | "ease-in-out" | Easing (CSS timing function) |
start | number | 0 | Move starts at (% of shot) |
end | number | 100 | Move ends at (% of shot) |
Example request
Push in on a detail at 24 FPS
curl -X POST https://fliplinecameramove.usefulweb.app/api/v1/calculate -H 'content-type: application/json' -d '{}'
Every result contains
inputs (normalised, defaults applied), summary, result (validated against the published schema), units, assumptions, sources, warnings, computedAt and links.
MCP (Model Context Protocol)
- Streamable HTTP endpoint:
https://fliplinecameramove.usefulweb.app/mcp– protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake). - Tools:
flipline_camera_move - Local stdio connector:
node src/mcp-stdio.ts --tool=flipline-camera-move
{
"mcpServers": {
"flipline-camera-move": { "type": "http", "url": "https://fliplinecameramove.usefulweb.app/mcp" }
}
}