API & MCP
Everything a person can do on Maths Worksheet Maker (Variants A/B/C with Answers), a program or AI agent can do with the same inputs and get the identical result.
HTTP API
POST https://printshopmathworksheet.usefulweb.app/api/v1/calculate– run Maths Worksheet Maker (Variants A/B/C with Answers)GET https://printshopmathworksheet.usefulweb.app/api/v1/tool– inputs, output schema, examples- OpenAPI 3.1: /openapi.json · /openapi.yaml
- Errors:
application/problem+json;422includes per-fielderrors.
Maths Worksheet Maker (Variants A/B/C with Answers)
Make maths worksheets for the classroom or home: times tables, column addition and subtraction with or without carrying, long multiplication, division with or without remainders, fractions, or a mix of facts. Up to six variants (A to F) give neighbours different problems of the same difficulty, each with its answer key.
| Field | Type | Default | Description |
|---|---|---|---|
kind | select (times, add, sub, mul, div, fractions, mixed) | "times" | Exercises |
count | integer | 30 | Problems per variant |
variants | integer | 3 | Variants (A, B, C …) |
tables | text | "2-10" | Times tables. For times tables and mixed facts, e.g. 2-10 or 3, 4, 7. |
maxFactor | integer | 10 | Largest factor |
digits | integer | 3 | Digits per number (column sums, multiplication) |
regroup | boolean | true | Carrying and borrowing |
digits2 | integer | 1 | Digits of the second number (multiplication, division) |
remainder | boolean | false | Division with remainders |
maxDenominator | integer | 10 | Largest denominator (fractions) |
fractionOps | select (add, sub, both) | "add" | Fraction operations |
sameDenominator | boolean | false | Same denominators only |
seed | text | "class-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
Times tables 2–10, variants A–C
curl -X POST https://printshopmathworksheet.usefulweb.app/api/v1/calculate -H 'content-type: application/json' -d '{"kind":"times","tables":"2-10","count":30,"variants":3,"seed":"class-4b"}'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://printshopmathworksheet.usefulweb.app/mcp– protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake). - Tools:
printshop_math_worksheet - Local stdio connector:
node src/mcp-stdio.ts --tool=printshop-math-worksheet
{
"mcpServers": {
"printshop-math-worksheet": { "type": "http", "url": "https://printshopmathworksheet.usefulweb.app/mcp" }
}
}