Back to browse
PrintBlocks – API and MCP server for your thermal printer

PrintBlocks – API and MCP server for your thermal printer

by gian-reto·Jul 17, 2026·1 point·0 comments

AI Analysis

●●●BangerNiche GemShip ItZero to One

Finally, a way for AI agents to output physical receipts instead of just chat bubbles.

Strengths
  • MCP integration allows agents to autonomously design and print layouts without human intervention.
  • Strict schema validation prevents agents from sending malformed commands that waste paper.
  • Block-based composition (charts, rows, QR codes) gives agents creative layout freedom.
Weaknesses
  • Requires specific ESC/POS thermal hardware, limiting the potential user base significantly.
  • Self-hosted nature means users must manage their own CUPS queues and printer drivers.
Category
Target Audience

AI agent developers and home automation enthusiasts with thermal printers

Similar To

CUPS · ESC/POS Command Reference

Post Description

I have been dreaming of a local assistant without a screen or chat window as an interface for a long time. An agent I could just speak to to research a topic or keep me updated. Unfortunately, it turns out audio is not a suitable output medium for every use case, e.g. a news briefing, an email inbox digest, a recipe or many other things. So I built PrintBlocks: a self-hosted service that exposes an API and an (optional) MCP server. Simply hook up your OpenClaw or Hermes agent (or whatever agent harness you're using) via MCP. It can compose the content and layout, then send the finished result to your thermal printer, all by itself!

The surprising part is how good LLMs are at this. Ask for a morning briefing, and a few seconds later you can have a beautifully designed little document sitting next to your coffee. PrintBlocks gives the agent a set of reusable and flexible building blocks, so it can be creative without messing up the formatting or just printing boring text.

The MCP server is entirely optional. If you're not into LLMs or have a different use case, you can also use the HTTP API to send requests directly from your own scripts or cron jobs. PrintBlocks currently supports 15 different blocks from text and images to charts and barcodes.

This is a v0.1, so if you have any ideas, feel free to open an issue on GitHub or post your ideas here. I’d love to hear what you would print with it!

Similar Projects

AI/ML●●Solid

Docker AI Stack, self-hosted LLM/STT/TTS/MCP in one compose file

One-command local AI stack bundling Ollama, Whisper, and MCP Gateway.

Ship ItCozy
hwdsl2
102mo ago