API & MCP
Everything a person can do on Graph, Dot, Isometric, Hex and Music Paper, a program or AI agent can do with the same inputs and get the identical result.
HTTP API
POST https://printshopgraphpaper.usefulweb.app/api/v1/calculate– run Graph, Dot, Isometric, Hex and Music PaperGET https://printshopgraphpaper.usefulweb.app/api/v1/tool– inputs, output schema, examples- OpenAPI 3.1: /openapi.json · /openapi.yaml
- Errors:
application/problem+json;422includes per-fielderrors.
Graph, Dot, Isometric, Hex and Music Paper
Make printable paper with a square grid (with major lines), dot grid, isometric triangles, hexagons, music staves or writing lines. Spacing is exact in millimetres, the grid is centred on the page and a 10 cm scale bar lets you check the printer scale.
| Field | Type | Default | Description |
|---|---|---|---|
kind | select (grid, dots, isometric, hex, music, lined) | "grid" | Paper type |
spacing | number | 0 | Spacing (mm, 0 = usual for the paper type). Grid/dot pitch, triangle or hexagon side, line distance, or the distance between two staff lines. 0 uses 5 mm for grid and dots, 8 mm for isometric, hexagons and lined paper, 2 mm for music staves. |
majorEvery | integer | 5 | Major line every … cells |
lineWidth | number | 0.15 | Line width (mm) |
color | text | "#9db7d5" | Line colour |
majorColor | text | "#5f86b5" | Major line colour |
margin | number | 10 | Margin (mm) |
marginLine | number | 0 | Margin line for lined paper (mm from the left) |
header | boolean | false | Name and date line at the top |
hexOrientation | select (pointy, flat) | "pointy" | Hexagon orientation |
pages | integer | 1 | Pages |
paper | select (a3, a4, a5, a6, b5, letter, legal, tabloid, halfletter) | "a4" | Paper size |
orientation | select (portrait, landscape) | "portrait" | Orientation |
Example request
5 mm grid with centimetre lines
curl -X POST https://printshopgraphpaper.usefulweb.app/api/v1/calculate -H 'content-type: application/json' -d '{"kind":"grid","spacing":5,"majorEvery":2}'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://printshopgraphpaper.usefulweb.app/mcp– protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake). - Tools:
printshop_graph_paper - Local stdio connector:
node src/mcp-stdio.ts --tool=printshop-graph-paper
{
"mcpServers": {
"printshop-graph-paper": { "type": "http", "url": "https://printshopgraphpaper.usefulweb.app/mcp" }
}
}