# Labelixa

Gives your AI assistant tools to render, lint and inspect thermal printer labels written in ZPL, EPL, TSPL and CPCL. Useful when you want to see a label before it hits the printer.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: Labelixa
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Labelixa/labelixa-mcp
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/labelixa

## What it does

The server exposes label tooling to the assistant. `zpl_preview` turns ZPL into a PNG you can look at, while `zpl_validate` plus the EPL, TSPL and CPCL linters return JSON diagnostics with positions. Barcode generation covers code128, code39, ean13, upca, upce, itf14, msi, qrcode, datamatrix and pdf417, as SVG or PNG. There is also language detection for raw label code, a lookup for a single ZPL command, and a DPI converter.

Two connection paths exist. The remote endpoint `https://api.labelixa.com/mcp` carries the full tool set, templates, bulk jobs and reading barcodes from photos included. The npm package `labelixa-mcp` runs locally over stdio through `npx` and offers the core subset; every tool in it calls the Labelixa REST API. An `lbx_` key is optional either way — anonymous use falls back to a per-IP quota.

Some limits matter. `zpl_preview` is a render, not a print, so physical output still depends on the printer, media and darkness settings. `zpl_compatibility` is not an emulator and will not tell you a label works, only flag risk. `convert_zpl_dpi` leaves embedded `^GF` and `~DG` bitmaps alone and prints a warnings block ahead of the output when they are present. Numeric inputs are validated before the call: `dpmm` must be 6, 8, 12 or 24, label sides finite, above 0 and no more than 15 inches, DPI 152, 203, 300 or 600.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://api.labelixa.com/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http zpl https://api.labelixa.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add labelixa -- npx -y labelixa-mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add labelixa --url https://api.labelixa.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add labelixa -- npx -y labelixa-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "labelixa": {
            "url": "https://api.labelixa.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "labelixa": {
            "command": "npx",
            "args": [
                "-y",
                "labelixa-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "labelixa": {
            "type": "http",
            "url": "https://api.labelixa.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "labelixa": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "labelixa-mcp"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http labelixa https://api.labelixa.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add labelixa npx -y labelixa-mcp
```

## When to use it
- render a ZPL label to PNG and check the result
- catch unknown commands and layout overflow in label code
- produce a standalone code128 or qrcode image
- identify which printer language a raw label snippet uses
- rescale ZPL coordinates for a different printer resolution

## Example prompts
- Render this ZPL label and show me the PNG
- Validate the label code, size is 4x6 inches
- Generate a qrcode pointing to our site

## Similar
- [dtg-base](https://affpapa.org/en/nevibecode/skills/dtg-base.md) — skill · 327 installs
- [Nutrition MCP](https://affpapa.org/en/nevibecode/mcp/nutrition-mcp.md) — MCP server · ★ 81
- [Scandit](https://affpapa.org/en/nevibecode/mcp/scandit.md) — MCP server · ★ 20
- [vision-framework](https://affpapa.org/en/nevibecode/skills/vision-framework.md) — skill · 3800 installs
- [axiom-vision](https://affpapa.org/en/nevibecode/skills/axiom-vision.md) — skill · 1800 installs
- [syncfusion-react-barcode](https://affpapa.org/en/nevibecode/skills/syncfusion-react-barcode.md) — skill · 711 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md