Getting started
Glasswise exposes two machine interfaces on top of its e-label surface:
- The REST API at
https://public-api.glasswise.eu/v1is the contract partner integrations program against. It covers the workspaces (wineries) you belong to, brands, labels with their parts and bottle-size formats, marketing QR codes, and the read-only reference catalogues. - The MCP server at
https://mcp.glasswise.eu/mcpexposes the same operations as tools to MCP clients such as Claude Code. The MCP server is itself a client of the API.
A label is the digital wine label behind a bottle’s QR code: identity, ingredients, grape varieties, certifications, packagings and translations, plus one bottle-size format per GTIN. A marketing QR code is a second, editable code that resolves to a destination you choose.
Label writes and shared wine data
Section titled “Label writes and shared wine data”A wine can supply shared text and lists to one or more labels. Bottle formats belong to a label and carry quantity and identifiers. Existing API operations work on labels and formats; wine management is not part of this contract.
Replacing a label list makes it independent of the wine’s list. Replacing a translation preserves existing override settings, while omitted text fields become null. A non-overridden text edit can update the wine if it has only one label. Read the write behavior before replacing content.
First request
Section titled “First request”Every call under /v1 needs a bearer token; see Authentication. The one exception is the OpenAPI document itself:
curl https://public-api.glasswise.eu/v1/openapi.jsonWith a token, list the workspaces your account belongs to:
curl -H "Authorization: Bearer <token>" https://public-api.glasswise.eu/v1/workspacesThe same token works on the MCP server. Connect the MCP covers the client setup and the tool list.
Where things live
Section titled “Where things live”| Surface | Base URL |
|---|---|
| REST API | https://public-api.glasswise.eu/v1 |
| OpenAPI document | https://public-api.glasswise.eu/v1/openapi.json |
| MCP server | https://mcp.glasswise.eu/mcp |
| Liveness probe | https://public-api.glasswise.eu/healthz (unauthenticated) |