Skip to content
PenBlitz
← Developers

MCP server: tools and prompts

What an assistant can call, and the ready-made prompts that come with the server.

Tools

ToolWhat it doesInput
printer_statusState of the printer, open jobs, whether prints need approval.–
list_templatesStored templates with placeholders and page size.–
get_templateThe document of a template as JSON. Drawings appear as "@keep".id
save_templateCreates or overwrites a template.id, document, name, description
previewDraws one sheet without printing: picture, warnings, margins, line length, duration.text or template_id or document; records or data_file; row; seed
printCreates a print job, one sheet per record.text or template_id or document; records or data_file; copies; name
jobsState of one job, or the latest 20.id (optional)
cancel_jobCancels a job; a running print stops.id
stop_printerEmergency stop.–
printer_controlFeed or eject a sheet, lift the pen, pen-change position.action: feed, eject, pen_up, pen_change
get_settingsPrinter address, transfer, calibration, API settings.–
update_settingsChanges settings; only the values given.changes

Sources for preview and print

  • text: plain text, written as a letter on A4.
  • template_id: a stored template; the records fill its placeholders.
  • document: a complete document in the format of get_template.
  • data_file: path of a CSV or JSON file on the computer, instead of records.

Prompts

Three prompts guide the assistant through the safe order: look at the templates, preview, show you the result, print only on request. In Claude Code they appear as slash commands such as /mcp__penblitz__write_letter.

PromptForAsks for
write_letterA letter to one person.recipient, about
postcardA postcard with message and address.recipient, address, about
mail_mergeOne sheet per row of a file.file, template (optional)

What to say

  • “Write Anna Schmidt a short handwritten thank-you letter for her order with PenBlitz. Show me the preview first.”
  • “Print the file ~/Desktop/customers.csv as a mail merge with PenBlitz, using the voucher template. Tell me about warnings before you print.”
  • “Make the writing in the PenBlitz template letter a little smaller and save it as letter-small.”