Search / com.labelixa/zpl
protogridR0· no sign-inThermal label MCP server: render, validate, debug and convert ZPL, EPL, TSPL and CPCL labels.
v0.4.2 · active · repository · website · descriptor JSON · versions
{
"mcpServers": {
"zpl": {
"type": "http",
"url": "https://api.labelixa.com/mcp"
}
}
}claude mcp add --transport http zpl https://api.labelixa.com/mcp[mcp_servers.zpl]
url = "https://api.labelixa.com/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"zpl": {
"type": "remote",
"url": "https://api.labelixa.com/mcp",
"enabled": true
}
}
}{
"mcpServers": {
"zpl": {
"type": "http",
"url": "https://api.labelixa.com/mcp"
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=zpl&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vYXBpLmxhYmVsaXhhLmNvbS9tY3AifQ%3D%3D"
}{
"servers": {
"zpl": {
"type": "http",
"url": "https://api.labelixa.com/mcp"
}
}
}{
"mcpServers": {
"zpl": {
"httpUrl": "https://api.labelixa.com/mcp"
}
}
}extensions:
"zpl":
enabled: true
name: "zpl"
type: streamable_http
uri: "https://api.labelixa.com/mcp"
timeout: 300
protocol.modernnewest supported version is 2025-06-18; 2026-07-28 not supported, older versions are deprecated until 2027-07-28protocol.statelessonly applies to 2026-07-28 serversprotocol.transportstreamable HTTPprotocol.list_ttlonly applies to 2026-07-28 serversauth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptionsevery tool has a descriptiontools.description_lengthdescriptions are concisetools.schemasevery tool has an object input schematools.annotations22 of 22 tools declare readOnlyHint or destructiveHinttools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHinttools.token_costabout 3,784 tokens to load every tooltools.api_dumptools are not a one-to-one API dumpstability.changes4 tool changes in 30 daysstability.rug_pull1 tools kept their name but changed most of their description in 30 days; review before trusting themsave_labeladdedSave a ZPL label to a Labelixa account so it can be edited, versioned and printed later. With an API key the label is saved immediately and the saved label id is returned. Without a key the label is held for 24 hours and a one-time link is returned: the user opens it, signs in (free account is enough) and the label lands in their account. Nothing else is stored for anonymous calls.
explain_zplchangeddescriptionFull 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.
Human-readable health REPORT for a finished ZPL label, with a 0-100 score: sectioned findings (syntax, size/DPI, orientation, barcodes, fonts, graphics memory, job behaviour); sections that cannot be assessed say so and are excluded from the score. Use it to review or explain a label to a person; for a quick pass/fail check while editing, use zpl_validate instead.
zpl_validatechangeddescriptionmeaning changedLint 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.
Pass/fail lint for ZPL — machine-readable diagnostics with line/column, code and severity: unknown commands, missing ^FS, out-of-range parameters, fields outside the label. Fast; run it before zpl_preview whenever you generate or edit ZPL. For a human-readable report with a score, use explain_zpl instead.
zpl_previewchangeddescriptionRender 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).
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.
Full history: list_changes · trend: quality JSON.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +namespace-matches-repo +dns-namespace +website +reachable +uptime-97% +updated-4d-ago
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
[email protected] npmthis version is not known to the dependency resolver
Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.
| remote | auth | reachable | uptime 30d | p50 | protocol | last ok |
|---|---|---|---|---|---|---|
https://api.labelixa.com/mcp streamable-http | none | yes | 97% | 298 ms | 2025-06-18 | 2026-10-20 |
| package | registry | version | runtime | secrets |
|---|---|---|---|---|
labelixa-mcp | npm | 0.4.2 | – |
barcode_pngread-only | 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. |
barcode_verifyread-only | 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. |
bulk_listread-only | List your recent bulk jobs (id, state, error class, timestamps), newest first. Useful to recover a lost job id; details via bulk_status. |
bulk_statusread-only | 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. |
bulk_submit | 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). |
convert_zpl_dpiread-only | 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. |
cpcl_previewread-only | 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. |
cpcl_validateread-only | 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. |
epl_previewread-only | 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. |
epl_validateread-only | 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. |
explain_zplread-only | Human-readable health REPORT for a finished ZPL label, with a 0-100 score: sectioned findings (syntax, size/DPI, orientation, barcodes, fonts, graphics memory, job behaviour); sections that cannot be assessed say so and are excluded from the score. Use it to review or explain a label to a person; for a quick pass/fail check while editing, use zpl_validate instead. |
image_to_zplread-only | 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). |
language_detectread-only | 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. |
save_label | Save a ZPL label to a Labelixa account so it can be edited, versioned and printed later. With an API key the label is saved immediately and the saved label id is returned. Without a key the label is held for 24 hours and a one-time link is returned: the user opens it, signs in (free account is enough) and the label lands in their account. Nothing else is stored for anonymous calls. |
template_getread-only | 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). |
template_listread-only | 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. |
tspl_previewread-only | 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. |
tspl_validateread-only | 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. |
zpl_command_helpread-only | 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. |
zpl_compatibilityread-only | 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. |
zpl_previewread-only | 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. |
zpl_validateread-only | Pass/fail lint for ZPL — machine-readable diagnostics with line/column, code and severity: unknown commands, missing ^FS, out-of-range parameters, fields outside the label. Fast; run it before zpl_preview whenever you generate or edit ZPL. For a human-readable report with a score, use explain_zpl instead. |
Schemas: list_tools.
{
"name": "com.labelixa/zpl",
"_meta": {
"io.modelcontextprotocol.registry/publisher-provided": {
"keywords": [
"mcp",
"mcp-server",
"model-context-protocol",
"zpl",
"epl",
"tspl",
"cpcl",
"zebra",
"thermal-printer",
"label-printing",
"barcode"
],
"artifacts": {
"local": "npm package labelixa-mcp: local stdio server with a core tool subset that calls the Labelixa REST API.",
"remote": "Hosted server at https://api.labelixa.com/mcp: full tool set, versioned with the Labelixa API."
},
"canonical": {
"docs": "https://labelixa.com/docs/api",
"mcpPage": "https://labelixa.com/mcp",
"product": "Labelixa",
"website": "https://labelixa.com",
"examples": "https://github.com/Labelixa/zpl-examples",
"transport": "Streamable HTTP, stateless JSON-RPC over POST",
"npmPackage": "labelixa-mcp",
"sourceMirror": "https://github.com/Labelixa/labelixa-mcp",
"authentication": "Optional. Authorization: Bearer <lbx_ API key> (or X-API-Key). Anonymous use is rate-limited per IP.",
"remoteEndpoint": "https://api.labelixa.com/mcp"
},
"languages": [
"ZPL",
"EPL",
"TSPL",
"CPCL"
],
"positioning": "Labelixa is an MCP server and API platform for thermal label development: rendering, validating, debugging and converting ZPL, EPL, TSPL and CPCL labels.",
"capabilities": "Tools for rendering, validation, debugging, conversion, barcode analysis and printer compatibility.",
"shortDescription": "Thermal label MCP server for rendering, validating, debugging and converting ZPL, EPL, TSPL and CPCL labels.",
"developerDescription": "Give AI assistants and developer tools the ability to render, validate, debug, inspect and convert thermal printer labels through MCP."
}
},
"title": "Labelixa",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"remotes": [
{
"url": "https://api.labelixa.com/mcp",
"type": "streamable-http"
}
],
"version": "0.4.2",
"packages": [
{
"version": "0.4.2",
"transport": {
"type": "stdio"
},
"identifier": "labelixa-mcp",
"registryType": "npm"
}
],
"repository": {
"id": "1363678422",
"url": "https://github.com/Labelixa/labelixa-mcp",
"source": "github"
},
"websiteUrl": "https://labelixa.com/mcp",
"description": "Thermal label MCP server: render, validate, debug and convert ZPL, EPL, TSPL and CPCL labels."
}