MCP Radar
MCP Server

Labelixa

com.labelixa/zpl
Developer Tools IoT & Hardware Public & reachable MCP 2026-07-28

What this MCP does

Renders, validates, converts, explains, and checks compatibility for ZPL, EPL, TSPL, and CPCL thermal-printer labels.

Capabilities

Tools

21 tools
barcode_png
Generate barcode PNG
Generate a single barcode as a PNG image (Code 128, QR, DataMatrix, EAN-13, UPC-A, PDF417 and more). For a full label with text and layout, write ZPL and use zpl_preview instead.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['data'], 'properties': {'data': {'type': 'string', 'description': 'Data to encode'}, 'type': {'type': 'string', 'default': 'code128', 'description': 'Symbology (code128, qr, datamatrix, ean13, upca, pdf417...)'}}}
barcode_verify
Read back barcodes from an image
Decode barcodes from a photo or scan of a PRINTED label (PNG, JPEG, BMP or GIF) and report what a software decoder reads back. Honest by design: 'read' does not guarantee every handheld scanner will read it, and 'not read' does not condemn the label (photo angle/focus matter) — the response says so.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['image_base64'], 'properties': {'image_base64': {'type': 'string', 'description': 'Base64-encoded image bytes'}}}
bulk_list
List bulk jobs
List your recent bulk jobs (id, state, error class, timestamps), newest first. Useful to recover a lost job id; details via bulk_status.
Read only Idempotent
Input schema 
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'description': 'Max jobs to return (default 50)'}}}
bulk_status
Bulk job status
Status of one bulk job you own: state, attempt count and — when finished — the summary with produced count and per-row failures (row number + reason; failed rows never block the rest). Finished outputs stay downloadable for 7 days via the REST endpoint the response names.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['job_id'], 'properties': {'job_id': {'type': 'string', 'description': 'Job id from bulk_submit'}}}
bulk_submit
Submit bulk label job
Submit a bulk label production job: one ZPL template with {{variable}} placeholders plus data rows (one object per label). Requires an API key whose plan includes bulk jobs. Quota is charged UPFRONT, one operation per row, and failed rows are not refunded; rows per job are capped by plan. Returns the job id — check bulk_status (small jobs usually finish within seconds).
Input schema 
{'type': 'object', 'required': ['zpl', 'rows'], 'properties': {'zpl': {'type': 'string', 'description': 'ZPL template with {{name}} placeholders'}, 'dpmm': {'enum': [6, 8, 12, 24], 'type': 'integer', 'description': 'Print density (default 8)'}, 'rows': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': {'type': 'string'}}, 'description': 'One object per label: placeholder name -> value'}, 'output': {'enum': ['zpl', 'png', 'pdf'], 'type': 'string', 'description': 'Output format (default zpl)'}, 'width_in': {'type': 'number', 'description': 'Label width, inches'}, 'height_in': {'type': 'number', 'description': 'Label height, inches'}}}
convert_zpl_dpi
Convert ZPL DPI
Rescale ZPL between printer resolutions (203/300/600 DPI): coordinates, fonts, barcode module width and label size are scaled. Embedded ^GF/~DG image data is NOT scaled; the response says so instead of silently passing it through.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['zpl', 'source_dpi', 'target_dpi'], 'properties': {'zpl': {'type': 'string', 'description': 'Raw ZPL code'}, 'source_dpi': {'enum': [152, 203, 300, 600], 'type': 'integer', 'description': 'Resolution the ZPL was written for, in DPI (not dpmm: 203 DPI = 8 dpmm).'}, 'target_dpi': {'enum': [152, 203, 300, 600], 'type': 'integer', 'description': 'Resolution to rescale to, in DPI. Equal to source_dpi means no scaling.'}}}
cpcl_preview
Render CPCL label
Render CPCL label code and return a PNG preview. The preview assumes 203 dpi and is an interpretation of the CPCL manual covering a core command subset — no physical printer validation. `labels` in the response is the TOTAL number of labels the stream prints (a stream may contain several, each ended by `PRINT`); pass `index` to render a different one.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['cpcl'], 'properties': {'cpcl': {'type': 'string', 'description': 'Raw CPCL code'}, 'index': {'type': 'integer', 'default': 0, 'description': 'Label index in the stream'}}}
cpcl_validate
Validate CPCL
Lint CPCL label code and return positioned findings with severity as JSON. Checks the command set Labelixa implements from the CPCL manual — a clean result is not a guarantee that a specific printer accepts the job. Run this before cpcl_preview; if you are not sure which language the code is, call language_detect first.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['cpcl'], 'properties': {'cpcl': {'type': 'string', 'description': 'Raw CPCL code'}}}
Output schema 
{'type': 'object', 'required': ['diagnostics', 'ozet'], 'properties': {'ozet': {'type': 'object', 'required': ['toplam', 'error', 'warning', 'info'], 'properties': {'info': {'type': 'integer'}, 'error': {'type': 'integer'}, 'toplam': {'type': 'integer'}, 'warning': {'type': 'integer'}}}, 'diagnostics': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'severity', 'line', 'col'], 'properties': {'col': {'type': 'integer'}, 'code': {'type': 'string', 'description': 'Stable diagnostic code, e.g. ZPL0002'}, 'line': {'type': 'integer'}, 'mesaj': {'type': 'string', 'description': 'Human-readable message in the requested language'}, 'end_col': {'type': 'integer'}, 'end_line': {'type': 'integer'}, 'severity': {'enum': ['error', 'warning', 'info'], 'type': 'string'}, 'message_key': {'type': 'string', 'description': 'i18n key for the message'}}}}}}
epl_preview
Render EPL label
Render EPL/EPL2 label code and return a PNG preview. The preview assumes 203 dpi and is an interpretation of the EPL2 manual covering a core command subset — no physical printer validation. `labels` in the response is the TOTAL number of labels the stream prints (a stream may contain several, each ended by `P`); pass `index` to render a different one.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['epl'], 'properties': {'epl': {'type': 'string', 'description': 'Raw EPL/EPL2 code'}, 'index': {'type': 'integer', 'default': 0, 'description': 'Label index in the stream'}}}
epl_validate
Validate EPL
Lint EPL/EPL2 label code and return positioned findings with severity as JSON. Checks the command set Labelixa implements from the EPL2 manual — a clean result is not a guarantee that a specific printer accepts the job. Run this before epl_preview; if you are not sure which language the code is, call language_detect first.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['epl'], 'properties': {'epl': {'type': 'string', 'description': 'Raw EPL/EPL2 code'}}}
Output schema 
{'type': 'object', 'required': ['diagnostics', 'ozet'], 'properties': {'ozet': {'type': 'object', 'required': ['toplam', 'error', 'warning', 'info'], 'properties': {'info': {'type': 'integer'}, 'error': {'type': 'integer'}, 'toplam': {'type': 'integer'}, 'warning': {'type': 'integer'}}}, 'diagnostics': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'severity', 'line', 'col'], 'properties': {'col': {'type': 'integer'}, 'code': {'type': 'string', 'description': 'Stable diagnostic code, e.g. ZPL0002'}, 'line': {'type': 'integer'}, 'mesaj': {'type': 'string', 'description': 'Human-readable message in the requested language'}, 'end_col': {'type': 'integer'}, 'end_line': {'type': 'integer'}, 'severity': {'enum': ['error', 'warning', 'info'], 'type': 'string'}, 'message_key': {'type': 'string', 'description': 'i18n key for the message'}}}}}}
explain_zpl
Explain ZPL health report
Full health report for a ZPL label: sectioned findings (syntax, size/DPI, orientation, barcodes, fonts, graphics memory, job behaviour) with an honest score — sections that cannot be assessed say so and are excluded from the score.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['zpl'], 'properties': {'zpl': {'type': 'string', 'description': 'Raw ZPL code'}, 'dpmm': {'enum': [6, 8, 12, 24], 'type': 'integer', 'default': 8, 'description': 'Printer density (8 = 203 dpi). The size/DPI section is scored against it — pass the real value.'}, 'width_in': {'type': 'number', 'default': 4, 'description': 'Label width in inches; fields outside it are reported.'}, 'height_in': {'type': 'number', 'default': 6, 'description': 'Label height in inches; same role as width_in.'}}}
image_to_zpl
Convert image to ZPL
Convert an image (PNG, JPEG, BMP or GIF, max 200 KB) to a ZPL ^GF graphic command. Returns the ZPL plus measured dimensions and the physical print size at the chosen density. PDF input is REST-only (/v1/graphics).
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['image_base64'], 'properties': {'dpmm': {'enum': [6, 8, 12, 24], 'type': 'integer', 'default': 8, 'description': 'Target printer density'}, 'wrap': {'type': 'boolean', 'default': False, 'description': 'Wrap the ^GF in a printable ^XA...^XZ label with ^PW/^LL'}, 'dither': {'type': 'boolean', 'default': False, 'description': 'Dither instead of hard threshold (photos)'}, 'image_base64': {'type': 'string', 'description': 'Base64-encoded image bytes'}}}
language_detect
Detect printer language
Detect which printer language raw label code is written in (ZPL, EPL, TSPL or CPCL). Heuristic: returns the language plus a confidence TIER (high/medium/low) and signal codes — not a probability.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string', 'description': 'Raw label code to classify'}}}
Output schema 
{'type': 'object', 'required': ['dil', 'guven', 'puanlar'], 'properties': {'dil': {'type': 'string', 'description': 'Detected printer language'}, 'guven': {'type': 'string', 'description': 'Confidence level'}, 'karma': {'type': 'boolean', 'description': 'True when the input mixes languages'}, 'puanlar': {'type': 'object', 'description': 'Per-language score', 'additionalProperties': {'type': 'integer'}}, 'kanitlar': {'type': 'array', 'items': {'type': 'object', 'properties': {'kod': {'type': 'string'}, 'satir': {'type': 'integer'}}}}}}
template_get
Get label template
Fetch one catalog template: metadata, preview image URL and — for non-premium templates — the ZPL source, ready for zpl_preview. Premium templates return metadata for everyone; their ZPL source requires an API key whose plan includes the premium-template feature (same rule as the website).
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['template_id'], 'properties': {'template_id': {'type': 'string', 'description': 'Template id from template_list'}}}
template_list
List label templates
List Labelixa's first-party label template catalog: id, English name, category, size/density and tags. Read-only product content (no tenant data). Fetch one with template_get; render its ZPL with zpl_preview.
Read only Idempotent
Input schema 
{'type': 'object', 'properties': {'search': {'type': 'string', 'description': 'Substring match on id/tags'}, 'category': {'enum': ['kargo', 'urun', 'raf', 'palet', 'qr'], 'type': 'string', 'description': 'Filter by category'}}}
tspl_preview
Render TSPL label
Render TSPL/TSPL2 label code and return a PNG preview. The preview assumes 203 dpi and is an interpretation of the TSPL manual covering a core command subset — no physical printer validation. `labels` in the response is the TOTAL number of labels the stream prints (a stream may contain several, each ended by `PRINT`); pass `index` to render a different one.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['tspl'], 'properties': {'tspl': {'type': 'string', 'description': 'Raw TSPL/TSPL2 code'}, 'index': {'type': 'integer', 'default': 0, 'description': 'Label index in the stream'}}}
tspl_validate
Validate TSPL
Lint TSPL/TSPL2 label code and return positioned findings with severity as JSON. Checks the command set Labelixa implements from the TSPL2 manual — a clean result is not a guarantee that a specific printer accepts the job. Run this before tspl_preview; if you are not sure which language the code is, call language_detect first.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['tspl'], 'properties': {'tspl': {'type': 'string', 'description': 'Raw TSPL/TSPL2 code'}}}
Output schema 
{'type': 'object', 'required': ['diagnostics', 'ozet'], 'properties': {'ozet': {'type': 'object', 'required': ['toplam', 'error', 'warning', 'info'], 'properties': {'info': {'type': 'integer'}, 'error': {'type': 'integer'}, 'toplam': {'type': 'integer'}, 'warning': {'type': 'integer'}}}, 'diagnostics': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'severity', 'line', 'col'], 'properties': {'col': {'type': 'integer'}, 'code': {'type': 'string', 'description': 'Stable diagnostic code, e.g. ZPL0002'}, 'line': {'type': 'integer'}, 'mesaj': {'type': 'string', 'description': 'Human-readable message in the requested language'}, 'end_col': {'type': 'integer'}, 'end_line': {'type': 'integer'}, 'severity': {'enum': ['error', 'warning', 'info'], 'type': 'string'}, 'message_key': {'type': 'string', 'description': 'i18n key for the message'}}}}}}
zpl_command_help
ZPL command help
Explain a single ZPL command: syntax, parameters with types/ranges/options, a fragment example and whether the Labelixa renderer draws it. Data comes from the same catalog that powers the public command reference pages.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['command'], 'properties': {'locale': {'enum': ['en', 'tr', 'de'], 'type': 'string', 'default': 'en', 'description': 'Language for the human-readable fields (name and descriptions). Command codes, syntax strings, examples and parameter names never change.'}, 'command': {'type': 'string', 'description': 'ZPL command code, e.g. FO, ^BC, ~DG'}}}
zpl_compatibility
Check printer compatibility
Compatibility RISK analysis of ZPL code against a specific printer model, given as manufacturer/model (e.g. 'zebra/zd421'). NOT an emulator and never says 'it works': reports the model's language posture with evidence level and size-rule findings.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['zpl', 'model'], 'properties': {'zpl': {'type': 'string', 'description': 'Raw ZPL code'}, 'model': {'type': 'string', 'description': 'Printer model slug, manufacturer/model, e.g. zebra/zd421'}}}
zpl_preview
Render ZPL label
Render ZPL label code and return the label as a PNG image. Use this to SEE what ZPL output looks like — LLMs can write ZPL but cannot otherwise verify the visual result. One call renders one label (use `index` to pick a label from a multi-label stream). The result also carries an 'Open this label in the Labelixa editor' link the user can click to edit, save or share the label.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['zpl'], 'properties': {'zpl': {'type': 'string', 'description': 'ZPL source (^XA...^XZ)'}, 'dpmm': {'enum': [6, 8, 12, 24], 'type': 'integer', 'default': 8, 'description': 'Printer density (8 = 203 dpi)'}, 'index': {'type': 'integer', 'default': 0, 'description': 'Label index in the stream'}, 'width_in': {'type': 'number', 'default': 4, 'description': 'Label width, inches'}, 'height_in': {'type': 'number', 'default': 6, 'description': 'Label height, inches'}}}
zpl_validate
Validate ZPL
Lint ZPL code and return structured diagnostics: unknown commands, missing ^FS, out-of-range parameters, fields outside the label boundary. Run this before zpl_preview when generating ZPL.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['zpl'], 'properties': {'zpl': {'type': 'string', 'description': 'ZPL source'}, 'dpmm': {'type': 'integer', 'default': 8, 'description': 'Printer density (8 = 203 dpi). The boundary check measures against it — pass the real value.'}, 'width_in': {'type': 'number', 'default': 4, 'description': 'Label width in inches. Fields outside it are reported, so a wrong size makes that finding wrong.'}, 'height_in': {'type': 'number', 'default': 6, 'description': 'Label height in inches. Same as width_in: the boundary check depends on it.'}}}
Output schema 
{'type': 'object', 'required': ['diagnostics', 'ozet'], 'properties': {'ozet': {'type': 'object', 'required': ['toplam', 'error', 'warning', 'info'], 'properties': {'info': {'type': 'integer'}, 'error': {'type': 'integer'}, 'toplam': {'type': 'integer'}, 'warning': {'type': 'integer'}}}, 'rfid': {'type': 'array', 'items': {'type': 'object'}}, 'alanlar': {'type': 'array', 'items': {'type': 'object', 'properties': {'x': {'type': 'integer'}, 'y': {'type': 'integer'}, 'line': {'type': 'integer'}}}}, 'diagnostics': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'severity', 'line', 'col'], 'properties': {'col': {'type': 'integer'}, 'code': {'type': 'string', 'description': 'Stable diagnostic code, e.g. ZPL0002'}, 'line': {'type': 'integer'}, 'mesaj': {'type': 'string', 'description': 'Human-readable message in the requested language'}, 'end_col': {'type': 'integer'}, 'end_line': {'type': 'integer'}, 'severity': {'enum': ['error', 'warning', 'info'], 'type': 'string'}, 'message_key': {'type': 'string', 'description': 'i18n key for the message'}}}}}}
History

Recent tool changes

Changed
zpl_preview
Oct. 1, 2026, 2:53 a.m.
Changed
cpcl_validate
Sept. 21, 2026, 3 a.m.
Changed
tspl_validate
Sept. 21, 2026, 3 a.m.
Changed
epl_validate
Sept. 21, 2026, 3 a.m.
Changed
language_detect
Sept. 21, 2026, 3 a.m.
Changed
zpl_validate
Sept. 21, 2026, 3 a.m.
Changed
zpl_command_help
Sept. 19, 2026, 2:51 a.m.
Added
bulk_list
Sept. 17, 2026, 12:35 p.m.
Added
bulk_status
Sept. 17, 2026, 12:35 p.m.
Added
bulk_submit
Sept. 17, 2026, 12:35 p.m.
Added
zpl_compatibility
Sept. 17, 2026, 12:35 p.m.
Added
barcode_verify
Sept. 17, 2026, 12:35 p.m.
Added
image_to_zpl
Sept. 17, 2026, 12:35 p.m.
Added
cpcl_preview
Sept. 17, 2026, 12:35 p.m.
Added
tspl_preview
Sept. 17, 2026, 12:35 p.m.
Added
epl_preview
Sept. 17, 2026, 12:35 p.m.
Added
template_get
Sept. 17, 2026, 12:35 p.m.
Added
template_list
Sept. 17, 2026, 12:35 p.m.
Added
convert_zpl_dpi
Sept. 17, 2026, 12:35 p.m.
Added
explain_zpl
Sept. 17, 2026, 12:35 p.m.
Added
cpcl_validate
Sept. 17, 2026, 12:35 p.m.
Added
tspl_validate
Sept. 17, 2026, 12:35 p.m.
Added
epl_validate
Sept. 17, 2026, 12:35 p.m.
Added
language_detect
Sept. 17, 2026, 12:35 p.m.
Added
barcode_png
Sept. 17, 2026, 12:35 p.m.
Added
zpl_command_help
Sept. 17, 2026, 12:35 p.m.
Added
zpl_validate
Sept. 17, 2026, 12:35 p.m.
Added
zpl_preview
Sept. 17, 2026, 12:35 p.m.
Discover

Similar MCP servers

Imei

io.github.pipeworx-io/imei

Validates IMEI numbers and computes the Luhn check digit for incomplete IMEI values.

Intel HEX type-00 count, input discarded

io.github.sadri-dridi/ihex-ok

Counts Intel HEX type-00 data records in supplied input.

device-house

house.device/device-house

Designs electronic devices and produces bills of materials, schematics, PCB layouts, firmware templates, manufacturing files, and…

wake-word-training

com.openwakeword/wake-word-training

Estimates, trains, benchmarks, licenses, and provides downloadable custom wake-word detection models for embedded and software ap…

OPC UA Modeler

io.github.node-opcua/node-opcua-modeler-mcp-server

Helps model OPC UA companion-spec types and namespaces, validate YAML models, and generate or reverse-engineer NodeSet2 artifacts.

OPC UA NodeSet Gate

io.github.ChanghuLiu/opc-ua-nodeset-compatibility-gate

Compares OPC UA NodeSet2 XML documents and performs deterministic release-compatibility audits, including chunked uploads.

PartsTable

com.partstable/partstable

Normalizes, validates, searches, and retrieves IT hardware part records and substitute or equivalent part numbers.

Robozukan (ロボ図鑑)

com.robozukan/robozukan

Catalogs physical devices by AI connectivity, autonomy, available APIs or other connection methods, and related connection guides.