API & MCP
Everything a person can do on Pixel Sprite Atlas (Aseprite JSON), a program or AI agent can do with the same inputs and get the identical result.
HTTP API
POST https://fliplinepixelatlas.usefulweb.app/api/v1/calculate– run Pixel Sprite Atlas (Aseprite JSON)GET https://fliplinepixelatlas.usefulweb.app/api/v1/tool– inputs, output schema, examples- OpenAPI 3.1: /openapi.json · /openapi.yaml
- Errors:
application/problem+json;422includes per-fielderrors.
Pixel Sprite Atlas (Aseprite JSON)
Paste a Flipline Pixel Studio project (.flipline-pixels.json). Get one sheet PNG and an atlas in the JSON layout Aseprite exports, which Phaser, Godot and many engine importers read: frame rectangles, durations, tags, layers and slices. Identical frames, such as linked cels, can share one sheet cell.
| Field | Type | Default | Description |
|---|---|---|---|
project | textarea | "{\"format\":\"flipline-pixels\",\"version\":4,\"name\":\"A small sprout\",\"wid | Flipline pixel project (JSON) |
scale | integer | 1 | Scale (whole pixels) |
padding | integer | 0 | Padding (px) |
columns | integer | 0 | Columns (0 = square-ish grid) |
layout | select (hash, array) | "hash" | JSON frames layout |
mergeDuplicates | boolean | true | Identical frames share one cell |
Example request
The sprout with a linked hold frame
curl -X POST https://fliplinepixelatlas.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://fliplinepixelatlas.usefulweb.app/mcp– protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake). - Tools:
flipline_pixel_atlas - Local stdio connector:
node src/mcp-stdio.ts --tool=flipline-pixel-atlas
{
"mcpServers": {
"flipline-pixel-atlas": { "type": "http", "url": "https://fliplinepixelatlas.usefulweb.app/mcp" }
}
}