supvan-e11
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SUPVAN_DEBUG | No | Set SUPVAN_DEBUG=1 when the bridge first starts to log every frame. | |
| SUPVAN_PROXIES | No | Optional 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
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
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.
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.
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.
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.