API & MCP

Everything a person can do on Printable Calendar Maker, a program or AI agent can do with the same inputs and get the identical result.

HTTP API

POST https://printshopcalendar.usefulweb.app/api/v1/calculate – run Printable Calendar Maker
GET https://printshopcalendar.usefulweb.app/api/v1/tool – inputs, output schema, examples
OpenAPI 3.1: /openapi.json · /openapi.yaml
Errors: application/problem+json; 422 includes per-field errors.

Printable Calendar Maker

Make a printable calendar for any year: one month per page or the whole year on one page, in 17 languages including right-to-left Arabic, with ISO 8601 or US week numbers, the first weekday of the region and public holidays for 16 countries (2024–2030).

Inputs of Printable Calendar Maker
Field	Type	Default	Description
`year`	integer	2027	Year
`startMonth`	integer	1	First month
`months`	integer	12	Number of months
`layout`	select (month, year)	"month"	Layout
`lang`	select (en, de, fr, es, it, pt, nl, pl, tr, ru, uk, ar, hi, zh, ja, ko, id)	"en"	Language of month and day names
`country`	select (none, DE, AT, CH, US, GB, FR, NL, BE, ES, IT, PL, SE, DK, IE, CA, AU)	"none"	Public holidays
`subdivision`	text	—	Region (optional). ISO 3166-2 code such as DE-BY, CH-ZH or US-CA for regional holidays.
`localNames`	boolean	true	Holiday names in the local language
`weekStart`	select (auto, mon, sun, sat)	"auto"	First day of the week
`weekNumbers`	select (none, iso, us)	"none"	Week numbers
`paper`	select (a3, a4, a5, a6, b5, letter, legal, tabloid, halfletter)	"a4"	Paper size
`orientation`	select (portrait, landscape)	"portrait"	Orientation
`accent`	text	"#1f6f8b"	Accent colour
`title`	text	—	Title (optional)
`notes`	boolean	true	Notes lines under each month

Example request

German 2027 wall calendar with ISO weeks and Bavarian holidays

curl -X POST https://printshopcalendar.usefulweb.app/api/v1/calculate -H 'content-type: application/json' -d '{"year":2027,"lang":"de","country":"DE","subdivision":"DE-BY","weekNumbers":"iso"}'

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://printshopcalendar.usefulweb.app/mcp – protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake).
Tools: printshop_calendar
Local stdio connector: node src/mcp-stdio.ts --tool=printshop-calendar

{
  "mcpServers": {
    "printshop-calendar": { "type": "http", "url": "https://printshopcalendar.usefulweb.app/mcp" }
  }
}