Skip to main content
Glama
supvan-e11

supvan-e11

by marco308

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
SUPVAN_DEBUGNoSet SUPVAN_DEBUG=1 when the bridge first starts to log every frame.
SUPVAN_PROXIESNoOptional ESPHome Bluetooth proxies to use, formatted as host|api_encryption_key.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

Prints labels on a SUPVAN E11 Bluetooth label maker (12 mm wide tape, die-cut labels, usually 40 mm long). Always preview first (preview_label or preview_freezer_label) and show the user the picture; print only once they are happy with it. print_label prints exactly what a preview showed: pass the preview_id it returned. Each preview prints once (use copies for more than one) and lasts 10 minutes. Use a line break in text for a second line. Leave length_mm unset to use the loaded label length.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
printer_statusA

Connect to the label printer and report model, loaded tape (width, label length, labels remaining) and any problem such as the cover being open or the tape running out.

preview_labelA

Draw a text label and return a picture of it, and a preview_id, without printing.

text: label text; use \n for a new line (two lines fit comfortably, three is tiny). length_mm: label length along the tape; default is the loaded die-cut label length. font: sans-bold (default), sans, condensed-bold, condensed, serif or mono. size: font height in dots (8 dots per mm, the tape is 96 dots high); default fits the text. align: left, center or right. qr: if set, a QR code holding this text/URL goes at the left end. border: draw a rounded border. invert: white text on black.

print_labelA

Print a label the user has seen: exactly the picture from preview_label or preview_freezer_label. Show the user the preview and print only once they're happy.

preview_id: from the preview, made in the last 10 minutes. Each preview prints once; preview again to print it again. copies: how many to print (1-20). density: darkness, 1-15 (default 4); raise it if the print is faint.

preview_freezer_labelA

Picture of a freezer label, and a preview_id to print it with print_label: dish name large, then the date it was frozen. frozen defaults to today; use_by and portions are added only when given (ISO dates, e.g. 2026-10-01). qr: optional text/URL for a QR code at the left end.

feed_tapeB

Feed the tape on by one label without printing.

release_printerA

Drop the Bluetooth connection so the phone app can connect. The connection comes back by itself next time, and is also dropped after two idle minutes.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.9/5.0

Scored across 6 tools

Disambiguation4/5

The preview/print split is clear: preview_label and preview_freezer_label generate a preview_id, and print_label consumes it. The only mild overlap is between the two preview tools, but their descriptions make the free-text vs freezer-template distinction obvious.

Naming Consistency4/5

All names are snake_case and nearly all follow a verb_noun pattern (preview_label, print_label, feed_tape, release_printer). printer_status is noun-first rather than the verb_noun style, a minor deviation but still readable and predictable.

Tool Count5/5

Six tools is well-scoped for a label printer: status, two previews, print, feed, and connection release. Each tool covers a distinct step in the workflow with no filler.

Completeness4/5

The lifecycle from checking status through preview, print, feed, and releasing the connection is covered. Minor gaps exist, such as no cancel/abort of a print or explicit printer configuration tool, but the density parameter inside print_label partly covers that.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues