# Labelixa

> Labelixa is a freemium MCP server for developer tools. Render, lint, convert and debug ZPL, EPL, TSPL and CPCL thermal labels from an assistant. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI, self-hosted
- **Website:** https://labelixa.com/mcp
- **Repository:** https://github.com/labelixa/labelixa-mcp
- **MCP Registry name:** com.labelixa/zpl
- **Categories:** developer tools, design and media
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.labelixa.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "zpl": {
      "url": "https://api.labelixa.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/labelixa
