Skip to main content
Glama
ildargiv

printshop-mcp

by ildargiv
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

printshop-mcp

English · Русский · 简体中文 · Español · Português · Deutsch · Français · 日本語 · 한국어 · Italiano · Türkçe · Polski · Українська · العربية · हिन्दी

🌐 ildargiv.github.io/printshop-mcp

The print shop inside your AI agent. Ask for "badges for these 40 guests, business cards and a flyer" and the agent designs them, packs them onto sheets, shows you an exact proof and prints them on your real printer - millimetre-accurate. And it remembers all your print profiles: printer, paper, tray, media type, quality, colour profile, calibration, even vendor-only driver options. Explain your printer once, never again.

A mixed sheet (1 flyer + 3 badges + 4 business cards) as the agent sees it before printing: crop marks only where you cut, long names shrunk to fit, grey border = what your printer can't print.

Status: v0.2, Windows. New: print any PDF (e.g. from other design skills) and automatic layout of many items. Next: self-learning from print defects, macOS/Linux.

Printer compatibility

For paper printers: inkjet, laser, photo, sublimation (souvenir transfer printing) and label printers. Not for 3D printers.

Works with any printer that has a Windows driver, whatever the brand: printing goes through the standard Windows print system, and vendor-only options (paper types, borderless, print quality) are kept in profiles through the driver's own settings window.

Printer type

Brands

Inkjet

Epson · Canon · HP · Brother

Laser and MFP

HP · Brother · Canon · Kyocera · Xerox · Ricoh · Konica Minolta · Sharp · Lexmark · OKI · Pantum · Samsung

Photo (inkjet and dye-sub photo)

Epson · Canon · HP · DNP · Mitsubishi · Citizen · Canon Selphy

Sublimation (souvenirs: mugs, T-shirts, puzzles)

Epson EcoTank / SureColor F (with sublimation ink) · Sawgrass · Ricoh

Label / thermal

Zebra · TSC · Brother QL · Dymo · Xprinter

Verified so far:

Printer

Type

Status

Microsoft Print to PDF

virtual

✅ full test suite

Epson L8050

inkjet, photo

✅ trays, media types, margins detected · test print pending

Printed with another model? Report it and it gets added here. macOS and Linux (CUPS) are planned.

Related MCP server: CorelDRAW Signage MCP

Install

Claude Code (skill + MCP server in one plugin):

/plugin marketplace add ildargiv/printshop-mcp
/plugin install printshop@printshop-mcp

Any MCP client (Claude Desktop, Cursor, Codex, ...):

{ "mcpServers": { "printshop": { "command": "uvx",
    "args": ["--from", "git+https://github.com/ildargiv/printshop-mcp", "printshop-mcp"] } } }

Needs uv and Edge or Chrome (used for rendering).

Why not just Ctrl+P?

Ctrl+P

printshop-mcp

"Fit to page" silently scales: 90 mm becomes 88.7 mm

Rendered straight to device pixels: 1 mm in CSS = 1 mm on paper

Content falls into the unprintable margin

Proof shows the printer's real unprintable zone; preflight warns

The agent can't see the result

Proof images + JSON report: clipped text, low-dpi images, wrong paper

Settings forgotten every time

Named profiles with the full driver state, calibration and ICC

One kind of item per print

Badges, cards and flyers packed on shared sheets with crop marks

What the agent gets

Skill (skills/printshop): the workflow (profiles -> design -> proof -> print -> fix the profile), HTML rules, a layout reference (what fits on A4/Letter) and templates:

Template

badges-a4.html

Event badges 90x55, 10 per A4

business-cards-a4.html

Business cards 90x50, 10 per A4

flyers-a6.html

A6 flyers, 4 per A4

table-tent-a4.html

Folded table tent / name card

event-kit-a4.html

Mixed: flyer + badges + business cards on one sheet

mug-wrap-a4.html

Sublimation mug wraps 200x95 (11 oz), printed mirrored

MCP tools:

Tool

list_printers, describe_printer

Printers, papers, trays, media types, printable area, saved profiles

list_profiles, save_profile, set_default_profile, delete_profile

Remembered print setups; open_driver_dialog=true lets you set vendor options once in the driver window; mirror=true for sublimation transfer paper

layout

Pack many items (HTML designs, PDFs, images) onto sheets, grouped by paper, with crop marks

proof

Render + preflight an HTML file or any PDF: proof images and a job id

print_job

Print a proofed job (warnings need explicit confirmation)

printer_status

Offline / out of paper / jammed, and the queue

HTML conventions: each sheet is <section class="ps-sheet" style="width:210mm;height:297mm">, layout in mm. data-fit="9pt" shrinks text to fit its box; data-cut adds crop marks.

Safety

  • Printing only after proof (the job id is the token); jobs expire after 1 hour and print once.

  • PRINTSHOP_MAX_SHEETS (default 50) caps paper use; PRINTSHOP_DRYRUN=1 never touches the printer.

  • HTML can only load local files from its own folder.

CLI

printshop-mcp printers
printshop-mcp proof badges.html --printer "My Printer"
printshop-mcp print <job_id> [--accept-warnings]

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • proof-print-dialog

    data-mission
    F
    license
    Not graded
    quality
    B
    maintenance
    Enables programmatic document proofing for print, with real ink coverage measurement and waste page detection, letting agents decide what to print before any sheet is produced.
    -

  • CorelDRAW Signage MCP

    Anhfurev
    F
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to drive CorelDRAW via COM API, creating and editing documents, replacing text, manipulating shapes, running preflight checks, and batch-exporting production files from natural language instructions.
    2
    -

  • printagent

    huy97
    A
    license
    Not graded
    quality
    A
    maintenance
    Enables AI agents to submit PDFs or JSON-rendered templates to local printers, check printer status, and manage print jobs through MCP tools.
    11 npm
    MIT

  • printbridge

    starkshtlm
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI assistants to print documents directly on your own printer over a private network, without cloud services or open ports. Supports printing text, URLs, and files with per-person access keys, usage limits, and detailed job control.
    MIT