Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@labelixa-mcp Validate this ZPL label and show any errors"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP (Model Context Protocol) server for the Labelixa API. Lets AI assistants that speak MCP (Claude Desktop, Claude Code and other MCP clients) work with Zebra ZPL label code directly.
This npm package ships the core tool subset below. The hosted remote MCP server carries the full tool set — everything here plus label templates, bulk generation, image-to-ZPL conversion, barcode reading from photos and EPL/TSPL/CPCL previews. See labelixa.com/mcp for the remote endpoint and the live tool list.
Tool | What it does |
| Renders ZPL to a PNG image for inspection. Server-side render — not a guarantee of how a specific physical printer will output the label. |
| Lints ZPL and returns the structured diagnostics report (unknown commands, parameter ranges, layout overflow) as JSON. Pass the real label size — checks depend on it. |
| Generates a standalone barcode (SVG or PNG): code128, code39, ean13, upca, upce, itf14, msi, qrcode, datamatrix, pdf417. |
| Detects the printer language of raw label code (ZPL/EPL/TSPL/CPCL). Heuristic — returns a confidence tier, not a probability. |
| Lints EPL/EPL2 code; positioned findings with severity, as JSON. |
| Lints TSPL/TSPL2 code; positioned findings with severity, as JSON. |
| Lints CPCL code; positioned findings with severity, as JSON. |
| Compatibility RISK analysis of ZPL against a printer model. Not an emulator — reports language posture with evidence level; never says "it works". |
| Looks up one ZPL command in the maintained catalog: name, syntax, parameters and whether the preview engine actually renders it — printer-side commands are marked as not rendered. |
| Rescales ZPL coordinates between printer resolutions (203/300/600 dpi). Embedded |
| Full sectioned health report (syntax, size/DPI, orientation, barcodes, fonts, memory) with an honest score — sections it cannot assess say "not assessed" instead of counting. |
npm install -g labelixa-mcpOr skip installing and run it with npx straight from your MCP client
config (below).
Also available as a remote server on
Smithery (labelixa/zpl) —
no local install at all; the gateway connects to our hosted MCP
endpoint. Listed in the official
MCP Registry as
com.labelixa/zpl (remote server + this npm package).
Related MCP server: OpenPrints MCP
Environment variables:
LABELIXA_API_KEY — optional lbx_ API key. Without it the anonymous
quota applies. Get a key at
labelixa.com.
LABELIXA_BASE_URL — optional; defaults to https://api.labelixa.com.
Example MCP client entry:
{
"mcpServers": {
"labelixa": {
"command": "npx",
"args": ["-y", "labelixa-mcp"],
"env": {"LABELIXA_API_KEY": "lbx_..."}
}
}
}Errors carry the server's own message verbatim; quota exhaustion is
reported with the server's Retry-After rather than a made-up delay.
zpl_preview is a render, not a print: physical output depends on the
printer, media and darkness settings.
License: MIT.
This server cannot be deployed
Render, validate and convert Zebra ZPL label code from AI assistants: PNG preview, lint, barcodes.
AI tools for MyPost A4 labels, 4x6 thermal printers and LabelChop resources.
Generate QR codes for URLs, PIX, Wi-Fi, vCards, WhatsApp and more. For AI agents.
Multi-carrier shipping for AI agents: compare rates, buy labels, track packages, validate addresses
