Skip to content
MCP server

Labelixa

Render, lint, convert and debug ZPL, EPL, TSPL and CPCL thermal labels from an assistant

Install
Pricing
Freemium
Platforms
API, CLI, self-hosted
Runs
Locally or Remotely
Version
0.5.2
Listing updated
3 days ago

About Labelixa

Labelixa is a freemium MCP server for developer tools. It can run locally on your machine or as a hosted remote server.

The remote server exposes a large toolset for label code. Previews render ZPL, EPL, TSPL and CPCL to PNG, and validators lint each language with line and column findings. A health report scores a finished ZPL label from 0 to 100 across syntax, size and DPI, orientation, barcodes, fonts, graphics memory and job behaviour. Other tools explain a single ZPL command and whether the preview draws it, rescale ZPL between 203, 300 and 600 DPI, convert an image of up to 200 KB into a ZPL graphic, detect which language a snippet is written in, and decode barcodes from a photo of a printed label.

Anonymous use is free and rate-limited per IP, and an optional lbx_ API key counts against your own account quota. The free plan lists 5,000 labels and 10,000 requests a month with no watermarks. Paid tiers raise quotas and add saved labels, templates, bulk generation, webhooks, ERP connectors and a DirectPrint agent, and an on-premise licence is offered. Quotas stop with a 429 rather than billing overage.

The local npm package, labelixa-mcp, serves a core subset by calling the REST API and reads LABELIXA_API_KEY. The vendor verified the remote server with Claude Desktop and Claude Code and says it has not tested other clients.

Install

Run in a terminal

claude mcp add --transport http zpl https://api.labelixa.com/mcp

Add to Settings → Connectors → Add custom connector

https://api.labelixa.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "zpl": {
      "url": "https://api.labelixa.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "zpl": {
      "type": "http",
      "url": "https://api.labelixa.com/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "zpl": {
      "serverUrl": "https://api.labelixa.com/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "zpl": {
      "type": "http",
      "url": "https://api.labelixa.com/mcp"
    }
  }
}

Tools this server provides (18)

Taken from the project documentation; the running server may differ.

zpl_preview
Renders ZPL label code and returns the label as a PNG image.
zpl_validate
Lints ZPL with machine-readable diagnostics including line, column, code and severity.
zpl_command_help
Explains one ZPL command: syntax, parameters and whether the renderer draws it.
barcode_png
Generates a single barcode as a PNG image.
language_detect
Detects whether label code is ZPL, EPL, TSPL or CPCL.
epl_validate
Lints EPL and EPL2 label code.
tspl_validate
Lints TSPL and TSPL2 label code.
cpcl_validate
Lints CPCL label code.
explain_zpl
Human-readable health report with a 0 to 100 score for a ZPL label.
convert_zpl_dpi
Rescales ZPL between 203, 300 and 600 DPI.
template_list
Lists the first-party label template catalog.
template_get
Fetches one catalog template with metadata and preview URL.
save_label
Saves a ZPL label to a Labelixa account.
epl_preview
Renders EPL and EPL2 code to a PNG preview.
tspl_preview
Renders TSPL and TSPL2 code to a PNG preview.
cpcl_preview
Renders CPCL code to a PNG preview.
image_to_zpl
Converts an image of up to 200 KB to a ZPL graphic command.
barcode_verify
Decodes barcodes from a photo of a printed label.

What it does

Label previews
Render ZPL, EPL, TSPL and CPCL labels to PNG images.
Linting
Positioned diagnostics for each printer language.
Health score
A 0 to 100 report across syntax, DPI, barcodes, fonts and more for ZPL.
DPI conversion
Rescale ZPL between 203, 300 and 600 DPI.
Barcode tools
Generate barcodes and decode them from photos of printed labels.
Template catalog
List and fetch first-party label templates.

Good for

  • Check a ZPL label for errors before it reaches a printer
  • Convert a label design to a different printer resolution
  • Find out which command in a ZPL file the preview does not draw
  • Turn a logo image into a ZPL graphic

Pricing

Freemium

Free tier with 5,000 labels and 10,000 requests a month; paid plans raise quotas

Prices change. Check labelixa.com before you buy.

Labelixa FAQ

Do I need an API key?

No for light use. Anonymous use is free and rate-limited per IP; a key gives your own quota.

Which printer languages are covered?

ZPL, EPL, TSPL and CPCL.

Is a preview a guarantee of print output?

No. The tool notes it is a server-side render, not a guarantee of how a specific printer will output the label.

Can I run it locally?

Yes, a core subset is published as the labelixa-mcp npm package.

Is Labelixa free?

Labelixa has a free plan, with paid plans for more usage or features.

How do I add Labelixa to Claude Code?

Run this command in your terminal: claude mcp add --transport http zpl https://api.labelixa.com/mcp

What are the best alternatives to Labelixa?

The closest alternatives to Labelixa are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

Alternatives to Labelixa

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  3. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  4. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  5. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  6. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory