> Tillcast is live: the API at https://api.tillcast.com/v1 and the dashboard at https://dashboard.tillcast.com. A key prints on real printers, so do not call the API unless asked. A job carries its receipt as "document", an array of blocks (the recommended way), or as "receiptline", ReceiptLine text, exactly one of the two: read https://docs.tillcast.com/create-a-print-job.md and https://docs.tillcast.com/concepts/documents.md before you write a job body. Do not code against what does not exist yet: webhooks, a template language, stored templates (a job has no template field), OAuth connections and connectors for Make, Zapier and n8n, and OAuth sign-in for the MCP server. SDKs for TypeScript (@tillcast/sdk, version 0.2.0 or later for blocks) and Python (tillcast) exist as pre-1.0 versions. To show a receipt in a web page without printing, there are the npm packages @tillcast/preview and @tillcast/html-render (0.x, no API key, no call to Tillcast to draw): read https://docs.tillcast.com/preview-a-receipt.md. The docs are the source of truth: check the index https://docs.tillcast.com/llms.txt and https://docs.tillcast.com/roadmap.md before you code against anything. For clean Markdown of any page, append .md to the page URL. The Tillcast MCP server is live at https://api.tillcast.com/mcp and takes an API key as a bearer token (setup: https://docs.tillcast.com/connect-an-ai-assistant.md). It acts on the live account and its tools print on real paper, so do not connect to it or call its tools unless the owner asked you to. The MCP server at https://docs.tillcast.com/_mcp/server is a different one: it only searches these docs and cannot call the Tillcast API.

# Supported printers

> Tillcast supports Star CloudPRNT and Epson Server Direct Print. Example models, firmware, and what has run on a device.

Tillcast supports printers that **poll the server themselves**. Nothing has to be installed at the venue and no router setting changes: the printer
connects out over HTTPS, fetches the job and confirms it. There are two such technologies in wide use for receipt printers, and Tillcast supports both.

| Technology           | Maker          | What the printer does                                    | What Tillcast sends |
| -------------------- | -------------- | -------------------------------------------------------- | ------------------- |
| CloudPRNT, HTTP mode | Star Micronics | polls Tillcast, downloads the job, confirms it           | StarPRNT commands   |
| Server Direct Print  | Epson          | posts to Tillcast, gets the job as XML, posts the result | ESC/POS commands    |

Your software never writes printer commands. It sends a [document of blocks](/concepts/documents), and Tillcast renders it for the printer's [profile](/printers/profiles) when it accepts the job. To connect a printer, see [Set up a Star printer](/printers/star-setup) or [Set up an Epson printer](/printers/epson-setup).

## Star CloudPRNT

Printers on Star's list of CloudPRNT-compatible printers that also speak StarPRNT, with the minimum firmware for the HTTP mode
(from [Star's CloudPRNT manual](https://www.star-m.jp/starcloudPRNT-introduction.html)):

| Printer                               | Minimum firmware (HTTP) |
| ------------------------------------- | ----------------------- |
| mC-Print3                             | 1.2                     |
| mC-Print2                             | 1.2                     |
| TSP100IV (TSP143IV-UE, TSP143IV-UEWB) | 1.0                     |
| TSP100IV SK                           | 2.0                     |

On mC-Print models use firmware 3.2 or newer: older firmware sends no job token, so a confirmation is less exact.

Star also sells ESC/POS versions of the TSP143IV, under separate part numbers. The TSP100IV rows above are the StarPRNT versions. No ESC/POS version has been tried with Tillcast, and none is claimed.

Star's list also has the TSP650II, TSP700II, TSP800II, TSP650IISK and SP700 (through an interface board) and the label printers mC-Label2 and mC-Label3.
The first group speaks Star Line, not StarPRNT, and is not supported yet. Labels are not a goal.

## Epson Server Direct Print

Models whose own Epson product page names Server Direct Print as a feature:

| Printer   | Source                                                                                                                          |
| --------- | ------------------------------------------------------------------------------------------------------------------------------- |
| TM-m30III | [Epson TM-m30III](https://www.epson.com.sg/p/C31CK50302)                                                                        |
| TM-T88VII | [Epson TM-T88VII](https://www.epson.com.sg/For-Work/Printers/POS-Printers/Epson-TM-T88VII-Thermal-Receipt-Printer/p/C31CJ57512) |
| TM-T88VI  | [Epson TM-T88VI](https://www.epson.eu/en_EU/products/retail/pos-printers/pc-pos-printers/epson-tm-t88vi-series/p/20551)         |
| TM-m50II  | [Epson TM-m50II](https://epson.com/p/C31CK52002)                                                                                |

Epson's Server Direct Print manual lists more variants (for example the TM-m50 and TM-L100). Check Epson's page for the exact variant
before you buy. A plain TM-m30II, and a TM-T20 or TM-T82 without the intelligent board (the TM-T20II-i and TM-T82II-i are on Epson's list), are not on Epson's list.

With the printer's spooler on, an Epson answers "printed" when it has accepted the page, so a cover opened or paper out after that is not reported. Epson lists the spooler per printer, and none for the TM-m30III series, so what the TM-m30III-H reports for a cover opened or paper out has not been tried.

## What has been tested on a device

Nothing is claimed for a model that has not run on a device. The status of each profile, its `evidence`, is shown in the API and in the dashboard. See [Profiles and print options](/printers/profiles).

* Star mC-Print3 (firmware 5.2): printed with a hand-built StarPRNT stream in October 2026. On 16 October 2026 the full test page, a document rendered by Tillcast, was printed on it too, and every section came out. Ordinary receipts are not checked on paper yet.
* Epson TM-m30III-H: the full test page was printed through Server Direct Print on 16 October 2026 and every section came out. Other models, other variants of the TM-m30III and ordinary receipts are not checked on paper yet.
* Every other model above: not tested by Tillcast. It uses the same protocol and language as a tested one.

## Printers that need more than polling

Printers without a polling technology cannot call the cloud themselves: for example Epson printers without Server Direct Print, and Citizen, Bixolon, Seiko, Fujitsu and other ESC/POS printers. For printers like these that are on the venue's network (LAN or Wi-Fi), we are planning **Tillcast Bridge**, a small device in the venue that connects out to Tillcast and passes each job to the printer. Printers on USB, a serial port or Bluetooth only are not supported. The device is not available yet, and it has no date and no price. Which models it will support is not decided: a model is listed here only after it has printed through Tillcast Bridge on a real device. See the [roadmap](/roadmap).