API & MCP
Everything a person can do on Halftone & Riso Separation Maker, a program or AI agent can do with the same inputs and get the identical result.
HTTP API
POST https://fliplinehalftoneriso.usefulweb.app/api/v1/calculate– run Halftone & Riso Separation MakerGET https://fliplinehalftoneriso.usefulweb.app/api/v1/tool– inputs, output schema, examples- OpenAPI 3.1: /openapi.json · /openapi.yaml
- Errors:
application/problem+json;422includes per-fielderrors.
Halftone & Riso Separation Maker
Separate a photo into CMYK with black generation, or into one to three spot inks by bounded least squares, then screen every plate with rotated round, diamond or line dots or a blue-noise grain. Preview the overprint on paper with misregistration and download printable grayscale plates.
| Field | Type | Default | Description |
|---|---|---|---|
image (required) | file | — | Image (PNG, JPEG or WebP) |
effect | select (halftone, riso) | "halftone" | Print process |
resolution | select (custom, gb, cga, ega, c64-hires, c64-multicolor, nes, mac) | "custom" | Machine resolution |
width | integer | 480 | Working width (px) |
fit | select (cover, contain, stretch) | "cover" | Image fit for machine resolutions |
scale | integer | 1 | Output scale (whole pixels) |
pitch | number | 8 | Screen cell size (px) |
shape | select (round, diamond, line) | "round" | Dot shape |
angles | select (classic, single) | "classic" | Screen angles |
gcr | integer | 60 | Black generation (GCR, %) |
inks | text | "#2f5aa8, #ff4fa3" | Riso inks (1–3 HEX colours) |
screen | select (halftone, grain) | "halftone" | Riso screen |
misregistration | integer | 2 | Misregistration (px) |
paper | text | "#f6f1e5" | Paper colour (HEX) |
seed | integer | 1977 | Registration seed |
brightness | number | 0 | Brightness |
contrast | number | 0 | Contrast |
gamma | number | 1 | Gamma |
saturation | number | 100 | Saturation (%) |
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://fliplinehalftoneriso.usefulweb.app/mcp– protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake). - Tools:
flipline_halftone_riso - Local stdio connector:
node src/mcp-stdio.ts --tool=flipline-halftone-riso
{
"mcpServers": {
"flipline-halftone-riso": { "type": "http", "url": "https://fliplinehalftoneriso.usefulweb.app/mcp" }
}
}