The page is the front door. The row is the API.
Agents start at a page, read it, then call a tool. PackDesk serves the same row both ways.
Endpoints
| Endpoint | Returns |
|---|---|
| GET /health | Health check |
| GET /api/v1/codes/{brand}/{code} | One normalised row |
| POST /api/v1/diagnose | Row + sources + related (free stub; 402-shaped for paid) |
| /mcp | MCP JSON-RPC: diagnose_coding_fault, list_brands |
| /api/codes.json | All 188 rows |
| /llms.txt | Site summary for language models |
| /.well-known/agent-card.json | Agent card |
| /openapi.json | OpenAPI 3.1 contract |
Example row
{
"brand": "Videojet",
"code": "E6008",
"title": "EHT/HV Trip",
"meaning": "The printer sensed arcing at the deflector plate (EHT leakage above the limit) and stopped printing.",
"likely_causes": [
"Ink build-up or wet ink on the deflector plate or charge electrode",
"Printhead not fully dry at jet start",
"Blocked nozzle or misaligned jet",
"EHT/HV calibration out of date"
],
"checks": [
"Stop the jet and clean the deflector electrodes with the correct cleaning solution",
"Let the printhead dry fully before restarting",
"Back-flush the nozzle",
"Calibrate EHT/HV if the trip returns"
],
"parts": [
"deflector plate",
"charge electrode",
"nozzle"
],
"consumables": [
"cleaning solution"
],
"source_url": "https://oeelab.com/videojet-printer-fault-codes",
"source_type": "forum",
"last_checked": "2026-11-21",
"confidence": "low"
}
MCP tool
{
"name": "diagnose_coding_fault",
"description": "Diagnose a packaging/coding/marking printer fault code and return the normalised row with sources.",
"inputSchema": {
"type": "object",
"properties": {
"brand": {
"type": "string",
"enum": [
"Videojet",
"Domino"
]
},
"code": {
"type": "string",
"description": "The fault code or message shown on the printer"
},
"model": {
"type": "string",
"description": "Optional model or series"
},
"symptom": {
"type": "string",
"description": "Optional free-text symptom"
}
},
"required": [
"brand",
"code"
]
}
}
Provenance on every response
Every row carries source_url, source_type (manual / service-bulletin / forum / inferred), last_checked, and confidence. The point is a citable row, not a hallucinated guess.
Status: the origin and MCP stub are in
cmd/ (Python, stdlib only). Payments are a 402-shaped stub — no live billing yet.