print-blocks

Appearance

PrintBlocksLet your agents print things

Let agents compose beautiful thermal prints from reusable blocks via MCP, or let apps and services print via a conventional API.

Get started
Browse blocks
View on GitHub
Three example print templates showing goal progress, a budget, and a habit review

Compose with blocks

Combine text, rows, images, codes, charts, timelines, and other blocks in one print job. Strictly validated to prevent mistakes before printing.

Use HTTP or MCP

Print directly from an application or connect an MCP-capable coding agent to compose layouts and print autonomously.

Built for ESC/POS

Render documents to printer-ready bytes and submit them to an existing CUPS queue. Works with most thermal printers that support ESC/POS.

Build a document by placing blocks in the order they should appear on paper:

sh
curl -X POST "http://localhost:3000/print" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_TOKEN" \
  --data '{
    "blocks": [
      {
        "type": "text",
        "content": "Daily progress",
        "align": "center",
        "bold": true
      },
      { "type": "line", "character": "-" },
      {
        "type": "row",
        "left": { "content": "Tasks completed" },
        "right": { "content": "4 / 5", "bold": true }
      },
      {
        "type": "progress",
        "variant": "bar",
        "value": 4,
        "max": 5
      }
    ]
  }'

Explore all available blocks →