API & MCP
Everything a person can do on Maze Maker (Rectangle, Hexagon, Round and Shapes), a program or AI agent can do with the same inputs and get the identical result.
HTTP API
POST https://printshopmaze.usefulweb.app/api/v1/calculate– run Maze Maker (Rectangle, Hexagon, Round and Shapes)GET https://printshopmaze.usefulweb.app/api/v1/tool– inputs, output schema, examples- OpenAPI 3.1: /openapi.json · /openapi.yaml
- Errors:
application/problem+json;422includes per-fielderrors.
Maze Maker (Rectangle, Hexagon, Round and Shapes)
Make printable mazes with square or hexagon cells or round “theta” mazes, optionally cut to a heart, star, circle, diamond, triangle or a shape you draw with # signs. Choose the recursive backtracker (long corridors), Kruskal or Wilson (uniform random) algorithm, up to six mazes per page and answer keys with the solution path.
| Field | Type | Default | Description |
|---|---|---|---|
shape | select (rect, hex, circle) | "rect" | Cells |
cols | integer | 16 | Columns |
rows | integer | 20 | Rows (rings for a round maze) |
mask | select (none, heart, star, circle, diamond, triangle, custom) | "none" | Outline |
maskText | textarea | — | Own shape (# = inside). One text line per row; # marks a cell inside the maze. Columns and rows then come from the drawing. |
algorithm | select (backtracker, kruskal, wilson) | "backtracker" | Algorithm |
count | integer | 1 | Number of mazes |
perPage | select (1, 2, 4, 6) | "1" | Mazes per page |
seed | text | "maze-1" | Seed. The same seed and settings always give the same puzzles. Change it for new ones. |
title | text | — | Title on the page (optional) |
answers | boolean | true | Answer-key pages |
header | boolean | true | Name and date line |
paper | select (a3, a4, a5, a6, b5, letter, legal, tabloid, halfletter) | "a4" | Paper size |
orientation | select (portrait, landscape) | "portrait" | Orientation |
Example request
Classic 16 × 20 maze
curl -X POST https://printshopmaze.usefulweb.app/api/v1/calculate -H 'content-type: application/json' -d '{"shape":"rect","cols":16,"rows":20,"algorithm":"backtracker","seed":"maze-1"}'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://printshopmaze.usefulweb.app/mcp– protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake). - Tools:
printshop_maze - Local stdio connector:
node src/mcp-stdio.ts --tool=printshop-maze
{
"mcpServers": {
"printshop-maze": { "type": "http", "url": "https://printshopmaze.usefulweb.app/mcp" }
}
}