API & MCP

Everything a person can do on Autotile Generator (blob 47 and Wang 16 rules), a program or AI agent can do with the same inputs and get the identical result.

HTTP API

POST https://fliplineautotilegenerator.usefulweb.app/api/v1/calculate – run Autotile Generator (blob 47 and Wang 16 rules)
GET https://fliplineautotilegenerator.usefulweb.app/api/v1/tool – inputs, output schema, examples
OpenAPI 3.1: /openapi.json · /openapi.yaml
Errors: application/problem+json; 422 includes per-field errors.

Autotile Generator (blob 47 and Wang 16 rules)

Draw terrain as # and . rows and choose the 47-tile blob set or the 16-tile Wang edge or corner set. The rule engine picks each tile variant from its neighbours and returns tile indices, a Tiled TMX map, a rendered PNG and merged collision rectangles.

Inputs of Autotile Generator (blob 47 and Wang 16 rules)
Field	Type	Default	Description
`terrain`	textarea	"....................\n..######......###...\n.########....#####..\n.###..###....	Terrain rows (# = terrain, . = empty)
`mode`	select (blob47, edge16, corner16)	"blob47"	Rule set
`tileSize`	integer	16	Tile size (px)
`outside`	select (empty, terrain)	"empty"	Cells beyond the grid
`orientation`	select (orthogonal, isometric)	"orthogonal"	Map orientation
`encoding`	select (csv, base64, base64-zlib, base64-gzip)	"csv"	TMX layer encoding
`tileset`	file	—	Own tileset PNG (optional; tiles in slot order unless mapped)
`mapping`	text	—	Slot → tile mapping (optional; 47 or 16 numbers, −1 = missing)

Example request

Two islands with a lake (blob 47)

curl -X POST https://fliplineautotilegenerator.usefulweb.app/api/v1/calculate -H 'content-type: application/json' -d '{"terrain":"....................\n..######......###...\n.########....#####..\n.###..###....##.##..\n.########.....###...\n..######............\n....##.....#######..\n....##.....#######..\n..........##.....#..\n.#####.....#######..\n.#####..............\n....................","mode":"blob47","tileSize":16,"outside":"empty","orientation":"orthogonal","encoding":"csv","mapping":""}'

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://fliplineautotilegenerator.usefulweb.app/mcp – protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake).
Tools: flipline_autotile_generator
Local stdio connector: node src/mcp-stdio.ts --tool=flipline-autotile-generator

{
  "mcpServers": {
    "flipline-autotile-generator": { "type": "http", "url": "https://fliplineautotilegenerator.usefulweb.app/mcp" }
  }
}