waterjet
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| WATERJET_KB | No | Path to an alternative copy of the knowledge folder. By default the knowledge folder is found next to dist/. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| machine_overviewA | Identity and key facts of the water jet installation: PTV WJ3020B 1Z-PJ-NL cutting table (Cnc886 control, Kollmorgen SERVOSTAR drives, Elsaco PLC I/O), JETS 3.8/60-COMPACT pump, power supply, safety chain, options installed and where to find each subject in the documents. Call this first. |
| list_documentsB | List all documents in the knowledge base (manuals, electrical schematics, drawings, procedures, notes) with their ids, titles, vendor, language and page counts. |
| searchA | Search every page of every document plus the curated machine data (axes, PLC I/O, components, pump, procedures, parts, drive parameter dictionary). Returns ranked hits with document id, page number and a snippet. Use device designators (e.g. "KM1", "SQ14", "XT7"), part numbers ("302001-1"), signal names ("PSTOP", "COM_OUT3"), or plain words. Follow up with get_page / get_page_image to read the full sheet. |
| get_pageA | Return the extracted text of one page of a document (and optionally the rendered page image). For schematic sheets the text is a list of labels, designators and wire numbers; request the image to read the actual circuit. Page numbers are PDF page numbers (= sheet numbers for the electrical documentation). |
| get_page_imageA | Return the rendered image (PNG, 1600 px long side) of a document page, e.g. a wiring sheet of the electrical documentation, the hydraulic scheme of the pump, or a drawing. Use search or find_sheet to find the page number first. |
| get_document_imagesC | Return the pictures embedded in a Word procedure document (portal alignment photos, pump display screenshots, intensifier seal replacement photos). |
| find_sheetA | Find sheets (pages) of the electrical documentation or the pump manual by subject, e.g. "drive Z1", "PLC A2", "terminal XT7", "hydraulic scheme", "operator panel". Returns page numbers to use with get_page_image. |
| get_sheet_indexB | Complete page/sheet index of the electrical documentation (126 sheets) and the pump manual (82 pages) with one-line titles. |
| get_axisA | Everything about one axis of the cutting table: drive model and CAN address, motor, feedback, limit/reference switches, valves and sensors on that trolley, connectors, terminal strips and the schematic sheets. Axes: X1, Y1, Y2, Z1, A1, B1, abrasive feeder. Without an argument returns all axes plus general notes. |
| get_drive_parametersA | Return the Kollmorgen SERVOSTAR parameter set dumped from one axis drive (files "Amplifier X/Y1/Y2/Z/A/B" kept by AMC). Optionally filter by parameter names or a substring. Each value is annotated with its meaning from the parameter dictionary when known. |
| compare_drive_parametersA | Diff the parameter sets of two axis drives and explain each differing parameter. Useful when cloning a drive, replacing a SERVOSTAR, or checking why two axes behave differently. |
| explain_drive_parameterA | Explain a SERVOSTAR 600 ASCII parameter (e.g. GP, GVTN, FBTYPE, IN3MODE, PGEARI) and show its value in every axis drive. Entries carry a confidence level; verify medium/low ones in the Kollmorgen ASCII reference before changing a drive. |
| get_plc_ioC | I/O assignment of the Elsaco PROMOS line2 modules (A2 CBIO-12, A3 CAIO-12, A5 CBIO-12) on CAN bus 2, the relay interface to the high-pressure pump (COM_IN/COM_OUT), and notes on spare capacity for adding hardware. |
| find_componentA | Look up an electrical component of the cutting table by designator (KM1, FU3, SQ14, YV11, XT7, GF1.5 ...), type (LC1D18BD, XPS-AC5121), manufacturer or function words (contactor, limit switch, valve, fuse). Returns function, type, manufacturer part number, location and the sheet where it is drawn. Also searches cables. |
| search_partsB | Search the H2O Jet / PTV spare parts price list used by AMC (intensifier, check valves, seals, on/off valve, nozzles, mixing tubes, filters, lubricants, swivels) by name or order number, and the spare-parts pages of the pump manual. |
| get_pump_infoB | Structured data on the JETS 3.8/60-COMPACT pump: technical parameters, electrical installation and distributor elements, hydraulic scheme positions, display abbreviations, password levels and menus, service intervals, alarm thresholds, torques, lubricants. |
| nozzle_flowA | Water flow through a pure-water orifice from the pump manual table (orifice diameter in thousandths of an inch, pressure in psi or bar) and whether the JETS 3.8/60 pump (3.8 l/min) can supply it. Give several orifices to check a multi-head or orifice + leak scenario. Also returns the pump pressure-level table. |
| list_proceduresA | List the maintenance and service procedures available (pump start/stop, oil change, service counter reset, check valve lapping, HP seal change, LP seals/end bells, bleed-down valve, ON/OFF valve repair kit, firing pin, portal alignment, control PC maintenance, adding hardware/I-O). |
| get_procedureA | Return a step-by-step maintenance procedure with torques, part numbers and the source pages. Use list_procedures for the ids; a free-text name also works. |
| list_drawingsB | List the CAD drawings (converted from DWG: table general arrangement, workshop layout, cutting head, height sensor arm, X bellows) and the PDF drawings (table dimensions, ON/OFF valve holder, abrasive hopper air assembly, check valve machining) with key dimensions. |
| get_drawingA | Return a CAD drawing as an image (PNG render of the DWG) together with its metadata and extracted text; DXF/SVG file paths are reported for CAD use. For PDF drawings use get_page_image with the document id. |
| dump_machine_dataA | Return one curated data file as text: overview, axes, plc_io, components, pump, procedures, nozzle_flow, sheets. Handy to load a whole subject into context at once. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| troubleshoot | Guided troubleshooting of the water jet table or pump from a symptom description |
| plan-hardware-addition | Plan wiring and integration of a new sensor, actuator or device on the cutting table or pump |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Check valve component machining allowances (H2O Jet 301002-X) | drawing, 1 page(s), 301002-X CHECK VALVE MACHINING.PDF |
| Compressed-air assembly of abrasive hopper TDJ 10T (1. Tousenska C-803-0501-000016) | drawing, 1 page(s), C-803-0501-000016-kompl StV1.pdf |
| ON/OFF valve repair kit HP (302001-1) installation procedure | procedure, 3 page(s), HP Rebuild Installation PWJ onoff.pdf |
| H2O Jet intensifier service procedures (IMO-1030 Rev C) | manual, 47 page(s), Intensifier Manual-Rev C.pdf |
| PTV JETS 3.8/60-COMPACT high-pressure pump - operation and maintenance manual (M-01/2007-EN) | manual, 82 page(s), MANUAL JETS3.8_60-COMPACT EN(starý-dvojdrážkový píst,mechanický multiplikátor).pdf |
| X portal bellows (Mech portalu X) PTV-012-V-3762 | drawing, 1 page(s), PTV-012-V-3762 - Mech portalu X.pdf |
| Dimension drawing CNC table WJ3020-1Z-NL (PTV-012-V-3972) | drawing, 1 page(s), PTV-012-V-3972 - Dimension CNC table WJ3020-1Z-NL.pdf |
| ON/OFF valve holder 5-axis head (Drzak ON-OFF 5AX) PTV-012-V-6066 original | drawing, 1 page(s), PTV-012-V-6066 - Drzak ON-OFF 5AX.pdf |
| ON/OFF valve holder 5-axis head PTV-012-V-6066a (rev a: two M6 holes 34 mm apart) | drawing, 1 page(s), PTV-012-V-6066a - Drzak ON-OFF 5AX.pdf |
| ON/OFF valve holder 5-axis head PTV-012-V-6066b (rev b: M6x12 thread, dia 32 tolerance) | drawing, 1 page(s), PTV-012-V-6066b - Drzak ON-OFF 5AX.pdf |
| ON/OFF valve holder 5-axis head PTV-012-V-6066c (rev c 2014: two M6 holes removed) - current | drawing, 1 page(s), PTV-012-V-6066c - Drzak ON-OFF 5AX.pdf |
| PTV WJ3020B 1Z-PJ-NL cutting table - electrical user documentation (PTV-V52-N-0001) | electrical-schematics, 126 page(s), PTV-052-N-0001 (UD) EN.pdf |
| Servicing manual for CNC PCs with Windows 10 IoT Enterprise (Cnc886 control PC) | manual, 6 page(s), Windows 10 IoT User Guide EN.pdf |
| Procedure: aligning a twisted (crossed) gantry portal | procedure, 1 page(s), Návod na vyrovnání zkříženého portálu.docx |
| Procedure: reset the pump check-valve service counter | procedure, 1 page(s), Resetování Check valve.docx |
| Procedure: reset the pump oil & filter service counter after an oil change | procedure, 1 page(s), Resetování po výměně oleje ČJ.docx |
| Procedure (pictures): replacement of intensifier low-pressure (hydraulic) seals - vymena tesneni NT | procedure, 1 page(s), výměna těsnění NT.doc |
| Note: firing pin and shift actuator dimensions | note, 1 page(s), Firing Pin.txt |
| SERVOSTAR parameter dump - axis A | Original SERVOSTAR ASCII parameter file of one axis |
| SERVOSTAR parameter dump - axis B | Original SERVOSTAR ASCII parameter file of one axis |
| SERVOSTAR parameter dump - axis X | Original SERVOSTAR ASCII parameter file of one axis |
| SERVOSTAR parameter dump - axis Y1 | Original SERVOSTAR ASCII parameter file of one axis |
| SERVOSTAR parameter dump - axis Y2 | Original SERVOSTAR ASCII parameter file of one axis |
| SERVOSTAR parameter dump - axis Z | Original SERVOSTAR ASCII parameter file of one axis |
TDQS
Scored across 22 tools
Most tools have a clearly distinct target: procedures, drawings, pages, sheets, axes, drive parameters, PLC I/O, components, parts and pump flow are all separable, and descriptions actively steer selection ("call this first", "use list_procedures for the ids"). The main friction is that dump_machine_data re-packages subsets of machine_overview, get_axis, get_plc_io, get_pump_info and list_procedures, and that global search overlaps with find_component/search_parts/find_sheet, so an agent may pick the wrong entry point for a lookup.
The dominant pattern is verb_noun (list_procedures, get_procedure, get_drawing, get_page, get_page_image, get_axis, get_plc_io, find_component, search_parts, get_pump_info, compare_drive_parameters, explain_drive_parameter). A few deviate into bare nouns or odd forms (machine_overview, nozzle_flow, get_sheet_index, dump_machine_data), but nothing is chaotic and the intent is always readable.
22 tools is on the heavy side, but the domain genuinely spans documents, CAD drawings, electrical schematics, drive parameter files, PLC I/O, spare parts and pump hydraulics, so each tool maps to a real subject area. A couple of pairs (list_documents/list_drawings, find_sheet/get_sheet_index) could be consolidated without losing capability.
Coverage of a technical documentation/knowledge base is strong: overview, document listing, full-text search, page text and images, procedures, drawings, axes, drive parameters (get/diff/explain), PLC I/O, component lookup, spare parts and nozzle flow calculations. Minor gaps remain — no alarm/fault-code troubleshooting tool despite alarm thresholds being mentioned, and drawing retrieval is split (get_drawing handles CAD only, PDF drawings require get_page_image).