API & MCP
Everything a person can do on Poster Tiler (Big Picture on Many Pages), a program or AI agent can do with the same inputs and get the identical result.
HTTP API
POST https://printshoppostertiler.usefulweb.app/api/v1/calculate– run Poster Tiler (Big Picture on Many Pages)GET https://printshoppostertiler.usefulweb.app/api/v1/tool– inputs, output schema, examples- OpenAPI 3.1: /openapi.json · /openapi.yaml
- Errors:
application/problem+json;422includes per-fielderrors.
Poster Tiler (Big Picture on Many Pages)
Enlarge a JPEG or PNG to a poster of any width and split it over A4, Letter or other sheets with overlap, trim lines, crop marks, alignment crosses and tile names, plus a cover page with the assembly map, the effective resolution and a test square. Without an image you get the tiling plan.
| Field | Type | Default | Description |
|---|---|---|---|
image | file | — | Image (JPEG or PNG, optional) |
imageWidth | integer | 4000 | Image width in pixels (when no file) |
imageHeight | integer | 3000 | Image height in pixels (when no file) |
width | number | 600 | Poster width (mm) |
paper | select (a3, a4, a5, a6, b5, letter, legal, tabloid, halfletter) | "a4" | Paper size |
orientation | select (auto, portrait, landscape) | "auto" | Sheet orientation |
margin | number | 8 | Printer margin (mm). Most printers cannot print the outer 3–6 mm. |
overlap | number | 10 | Overlap (mm) |
cropMarks | boolean | true | Crop marks and alignment crosses |
title | text | "Poster" | Title on the cover page |
Example request
60 cm poster plan for a 4000 × 3000 photo
curl -X POST https://printshoppostertiler.usefulweb.app/api/v1/calculate -H 'content-type: application/json' -d '{"imageWidth":4000,"imageHeight":3000,"width":600}'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://printshoppostertiler.usefulweb.app/mcp– protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake). - Tools:
printshop_poster_tiler - Local stdio connector:
node src/mcp-stdio.ts --tool=printshop-poster-tiler
{
"mcpServers": {
"printshop-poster-tiler": { "type": "http", "url": "https://printshoppostertiler.usefulweb.app/mcp" }
}
}