Log inSubmit server
Labelixa logo

Labelixa

Validate, render, inspect, convert, and generate assets for ZPL, EPL, TSPL, and CPCL thermal labels over MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Labelixa

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "labelixa-2": {
      "command": "npx",
      "args": [
        "-y",
        "labelixa-mcp"
      ],
      "env": {
        "LABELIXA_API_KEY": "YOUR_VALUE_HERE",
        "LABELIXA_BASE_URL": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

Labelixa MCP server connects MCP clients to Labelixa's thermal-label API for rendering, validation, debugging, conversion, and barcode generation. Its local npm package runs over stdio and provides core tools for ZPL, EPL, TSPL, and CPCL, while the remote Streamable HTTP endpoint offers a broader tool set. Use it to inspect generated labels, catch syntax and layout problems, assess ZPL printer compatibility, or rescale ZPL between supported DPIs before deployment. Rendering is server-side inspection rather than a guarantee of output from a particular physical printer.

Use cases

  • Validate generated ZPL before sending it to a printer
  • Render ZPL as a PNG for label inspection
  • Check ZPL compatibility with a named printer model
  • Convert ZPL coordinates between supported printer resolutions
  • Generate standalone barcodes for label workflows

Key features

  • ZPL rendering and structured validation
  • EPL, TSPL, and CPCL validation
  • Barcode generation as SVG or PNG
  • Printer-language detection
  • ZPL command lookup and compatibility risk analysis
  • ZPL DPI conversion and health reports

Tools11

What Labelixa lets your agent do. Expand a tool for its parameters.

Verified live~1.7k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

9/9 checks healthy over the last 38d

What it can do

From the 11 tools this server returned when we ran it.

Read-only tools · 11
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age69 days
Maintainers1

Observed 2026-11-02 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 15d ago via OSV.dev · labelixa-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads1.2kPackage downloads in the last 30 days.
Last commit10d agoMost recent push to the default branch.
Tools exposed11Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Labelixa works

What Labelixa MCP server does

Labelixa MCP server provides MCP access to tools for developing and checking thermal-printer labels. The local package covers four printer languages: ZPL, EPL, TSPL, and CPCL. Its capabilities include ZPL image rendering, structured linting, language detection, barcode generation, command reference lookup, printer compatibility analysis, DPI conversion, and human-readable ZPL health reports.

The package sends tool requests to the Labelixa REST API. It is intended for use from an MCP-compatible developer tool or assistant that needs to create, review, or troubleshoot raw printer-language code. The remote endpoint exposes a larger set of features, including additional rendering, templates, bulk jobs, image conversion, barcode reading, and language conversion tools.

How it works

The package runs as a local stdio process, launched directly with npm or through npx. A remote alternative is available at https://api.labelixa.com/mcp over stateless Streamable HTTP. Anonymous requests can use the service's rate-limited quota; an lbx_ API key uses the associated account quota.

For ZPL, zpl_validate returns machine-readable findings such as unknown commands, invalid parameter ranges, and layout overflow. explain_zpl instead produces a scored, sectioned report covering areas such as syntax, size and DPI, orientation, barcodes, fonts, and memory. Both validation approaches depend on the actual label dimensions.

zpl_preview produces a PNG through server-side rendering. It should be treated as an inspection image, not as a prediction of physical output under every printer, media, or darkness setting. Compatibility analysis similarly reports risk and evidence for a named manufacturer and model; it is not printer emulation.

Setup and configuration

Install globally with:

Terminal
npm install -g labelixa-mcp

Alternatively, configure an MCP client to run npx -y labelixa-mcp, optionally supplying the API key through the environment. The remote endpoint requires no package installation and can be configured with a URL and optional authorization header.

Configuration variables:

  • LABELIXA_API_KEY: Optional lbx_ key. Without it, anonymous quota rules apply.
  • LABELIXA_BASE_URL: Optional API base URL, defaulting to https://api.labelixa.com.

The package rejects invalid numeric inputs before making a request. Supported dpmm values are 6, 8, 12, and 24; label dimensions must be finite, greater than zero, and no more than 15 inches. Accepted DPI values are 152, 203, 300, and 600.

Tools and capabilities

  • Render ZPL as PNG for visual inspection.
  • Validate ZPL, EPL/EPL2, TSPL/TSPL2, and CPCL with positioned severity findings.
  • Generate standalone SVG or PNG barcodes, including Code 128, Code 39, EAN-13, UPC variants, ITF-14, MSI, QR Code, Data Matrix, and PDF417.
  • Detect ZPL, EPL, TSPL, or CPCL using a confidence tier and signal codes.
  • Look up ZPL syntax, parameter constraints, defaults, and preview support; command help can translate descriptions into English, Turkish, or German.
  • Analyze ZPL against a specified printer model and rescale coordinates between 203, 300, and 600 DPI.

Limitations and notes

The local package does not provide the remote server's extra EPL, TSPL, or CPCL preview functions, label templates, bulk generation, image-to-ZPL conversion, barcode reading from photos, or SBPL, DPL, and IPL conversion to ZPL. DPI conversion does not rescale embedded ^GF or ~DG bitmap data; it reports a warning when such data is present. Printer compatibility results describe risk and language posture rather than confirming that a label will print successfully. The package is licensed under MIT.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Labelixa

Labelixa is an MCP server that connects AI assistants and developer tools to the Labelixa thermal-label API. Its main tools render and validate ZPL, validate EPL, TSPL, and CPCL, generate barcodes, detect printer languages, inspect ZPL commands, analyze printer compatibility, convert ZPL DPI, and explain label health.

Install it globally with `npm install -g labelixa-mcp`, or run it through `npx -y labelixa-mcp` from your MCP client configuration. You can also connect without installing the package by using the remote endpoint at `https://api.labelixa.com/mcp`.

Yes. Claude Desktop can connect through a configuration containing the remote MCP URL, with an optional authorization header for an `lbx_` API key. The local package can also be run through a standard command-based MCP configuration.

No. `zpl_preview` creates a server-side PNG for inspection and does not guarantee physical printer output. Media, printer settings, and the specific printer model can affect the result; `zpl_compatibility` provides risk analysis rather than emulation.

Set `LABELIXA_API_KEY` to an `lbx_` key for the local package, or send it as a Bearer authorization header when using the remote MCP endpoint. The key is optional, but anonymous use is subject to the service's rate-limited quota.

Related MCP servers

All in Developer Tools All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewLabelixa AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/labelixa-2?style=directory)](https://allmcps.com/mcp/labelixa-2)
HTML Embed
<a href="https://allmcps.com/mcp/labelixa-2"><img src="https://allmcps.com/api/badge/labelixa-2?style=directory" alt="Labelixa on AllMCPs" /></a>