API & MCP
Everything a person can do on Booklet Maker (Saddle-Stitch Imposition), a program or AI agent can do with the same inputs and get the identical result.
HTTP API
POST https://printshopbooklet.usefulweb.app/api/v1/calculate– run Booklet Maker (Saddle-Stitch Imposition)GET https://printshopbooklet.usefulweb.app/api/v1/tool– inputs, output schema, examples- OpenAPI 3.1: /openapi.json · /openapi.yaml
- Errors:
application/problem+json;422includes per-fielderrors.
Booklet Maker (Saddle-Stitch Imposition)
Make a saddle-stitched booklet: pages of grid, dot or lined paper (a notebook) or a month-per-page calendar are padded to a multiple of four and printed two per sheet side in booklet order, with optional creep compensation, page numbers and fold marks. Prints double-sided, flip on the short edge.
| Field | Type | Default | Description |
|---|---|---|---|
source | select (ruled, calendar) | "ruled" | Booklet pages |
pages | integer | 16 | Notebook pages |
kind | select (grid, dots, isometric, hex, music, lined) | "dots" | Notebook paper type |
spacing | number | 5 | Notebook spacing (mm) |
year | integer | 2027 | Calendar year |
startMonth | integer | 1 | Calendar first month |
lang | select (en, de, fr, es, it, pt, nl, pl, tr, ru, uk, ar, hi, zh, ja, ko, id) | "en" | Calendar language |
paper | select (a3, a4, a5, a6, b5, letter, legal, tabloid, halfletter) | "a4" | Sheet size (folded in half) |
reading | select (ltr, rtl) | "ltr" | Binding |
creep | number | 0 | Creep compensation (mm per sheet). About the paper thickness (0.1 mm for 80 g/m²) for thick booklets. |
pageNumbers | boolean | true | Page numbers |
Example request
16-page dot-grid pocket notebook
curl -X POST https://printshopbooklet.usefulweb.app/api/v1/calculate -H 'content-type: application/json' -d '{"source":"ruled","pages":16,"kind":"dots"}'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://printshopbooklet.usefulweb.app/mcp– protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake). - Tools:
printshop_booklet - Local stdio connector:
node src/mcp-stdio.ts --tool=printshop-booklet
{
"mcpServers": {
"printshop-booklet": { "type": "http", "url": "https://printshopbooklet.usefulweb.app/mcp" }
}
}