API & MCP
Everything a person can do on Spot Healing & Clone Stamp, a program or AI agent can do with the same inputs and get the identical result.
HTTP API
POST https://luminaspotheal.usefulweb.app/api/v1/calculate– run Spot Healing & Clone StampGET https://luminaspotheal.usefulweb.app/api/v1/tool– inputs, output schema, examples- OpenAPI 3.1: /openapi.json · /openapi.yaml
- Errors:
application/problem+json;422includes per-fielderrors.
Spot Healing & Clone Stamp
Upload a photo and a list of brush strokes. Heal strokes replace a spot with texture from a nearby area and blend it seamlessly into the surrounding colour and brightness (Poisson-style seamless cloning); clone strokes copy pixels exactly from a source area. Leave out the source of a heal stroke and the tool picks the best-matching nearby area. Download a PNG plus the resolved strokes as JSON for the Lumina photo editor, where they stay editable.
| Field | Type | Default | Description |
|---|---|---|---|
image (required) | file | — | Image (PNG, JPEG or WebP; up to 8 MB and 16 MP) |
strokes (required) | textarea | "[{\"mode\":\"heal\",\"points\":[[0.325,0.333]],\"radius\":0.03},{\"mode\":\"hea | Strokes (JSON list, or a Lumina project with "retouch"). Each stroke: {"mode":"heal"|"clone","points":[[x,y],…],"radius":0.03,"hardness":0.5,"opacity":1,"source":[dx,dy]}. x, y, dx and dy are fractions of width and height (0.5 = middle); radius is a fraction of the longer side (0.002–0.15). Heal strokes may omit "source". Up to 200 strokes, 400 points each, 8000 in total. |
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://luminaspotheal.usefulweb.app/mcp– protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake). - Tools:
lumina_spot_heal - Local stdio connector:
node src/mcp-stdio.ts --tool=lumina-spot-heal
{
"mcpServers": {
"lumina-spot-heal": { "type": "http", "url": "https://luminaspotheal.usefulweb.app/mcp" }
}
}