API & MCP
Everything a person can do on Particle Effect Frame Generator, a program or AI agent can do with the same inputs and get the identical result.
HTTP API
POST https://fliplineparticleframes.usefulweb.app/api/v1/calculate– run Particle Effect Frame GeneratorGET https://fliplineparticleframes.usefulweb.app/api/v1/tool– inputs, output schema, examples- OpenAPI 3.1: /openapi.json · /openapi.yaml
- Errors:
application/problem+json;422includes per-fielderrors.
Particle Effect Frame Generator
Set up a seeded particle emitter — shape, rate, burst, lifetime, direction, speed, gravity, wind and drag — and choose how size, color and opacity change over each particle’s life with CSS easing curves. Get a transparent PNG sequence, a contact strip, per-frame particle counts and, for up to 24 drawings, an editable Flipline drawing whose particle layer you can open and draw over.
| Field | Type | Default | Description |
|---|---|---|---|
preset | select (custom, embers, snow, burst, smoke, fountain) | "embers" | Particle preset |
width | integer | 960 | Canvas width (px) |
height | integer | 540 | Canvas height (px) |
fps | integer | 12 | Frame rate (FPS) |
frames | integer | 24 | Frames |
background | text | — | PNG background HEX (empty = transparent) |
shape | select (point, line, rect, ellipse, ring) | "line" | Emitter shape |
x | number | 50 | Emitter centre X (%) |
y | number | 92 | Emitter centre Y (%) |
emitterWidth | number | 420 | Emitter width (px) |
emitterHeight | number | 0 | Emitter height (px) |
angle | number | 0 | Emitter rotation (degrees) |
rate | number | 30 | Emission rate (particles per second) |
burst | integer | 0 | Start burst (particles) |
life | number | 1.6 | Lifetime (seconds) |
lifeVar | number | 30 | Lifetime variation (%) |
direction | number | 90 | Direction (degrees, 0 = right, 90 = up) |
spread | number | 24 | Spread (degrees) |
outward | boolean | false | Throw particles away from the shape centre |
speed | number | 260 | Speed (px per second) |
speedVar | number | 35 | Speed variation (%) |
gravity | number | -60 | Gravity (px/s², positive = down) |
wind | number | 20 | Wind (px/s², positive = right) |
drag | number | 0.6 | Drag (per second) |
sizeStart | number | 20 | Start size (px) |
sizeEnd | number | 4 | End size (px) |
sizeVar | number | 30 | Size variation (%) |
sizeEase | text | "ease-out" | Size easing over life |
colorStart | text | "#FFD27A" | Start color HEX |
colorEnd | text | "#C6452B" | End color HEX |
colorEase | text | "ease-in" | Color easing over life |
opacityStart | number | 95 | Start opacity (%) |
opacityEnd | number | 0 | End opacity (%) |
opacityEase | text | "ease-in" | Opacity easing over life |
style | select (dot, glow) | "glow" | Particle look |
seed | integer | 7 | Random seed |
loop | boolean | true | Seamless loop |
prewarm | number | 0 | Pre-roll before frame 1 (seconds, no loop) |
Example request
Rising embers that loop over 24 drawings
curl -X POST https://fliplineparticleframes.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://fliplineparticleframes.usefulweb.app/mcp– protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake). - Tools:
flipline_particle_frames - Local stdio connector:
node src/mcp-stdio.ts --tool=flipline-particle-frames
{
"mcpServers": {
"flipline-particle-frames": { "type": "http", "url": "https://fliplineparticleframes.usefulweb.app/mcp" }
}
}