Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
WATERJET_KBNoPath 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

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription
troubleshootGuided troubleshooting of the water jet table or pump from a symptom description
plan-hardware-additionPlan 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

NameDescription
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 procedureprocedure, 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-3762drawing, 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 originaldrawing, 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) - currentdrawing, 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 portalprocedure, 1 page(s), Návod na vyrovnání zkříženého portálu.docx
Procedure: reset the pump check-valve service counterprocedure, 1 page(s), Resetování Check valve.docx
Procedure: reset the pump oil & filter service counter after an oil changeprocedure, 1 page(s), Resetování po výměně oleje ČJ.docx
Procedure (pictures): replacement of intensifier low-pressure (hydraulic) seals - vymena tesneni NTprocedure, 1 page(s), výměna těsnění NT.doc
Note: firing pin and shift actuator dimensionsnote, 1 page(s), Firing Pin.txt
SERVOSTAR parameter dump - axis AOriginal SERVOSTAR ASCII parameter file of one axis
SERVOSTAR parameter dump - axis BOriginal SERVOSTAR ASCII parameter file of one axis
SERVOSTAR parameter dump - axis XOriginal SERVOSTAR ASCII parameter file of one axis
SERVOSTAR parameter dump - axis Y1Original SERVOSTAR ASCII parameter file of one axis
SERVOSTAR parameter dump - axis Y2Original SERVOSTAR ASCII parameter file of one axis
SERVOSTAR parameter dump - axis ZOriginal SERVOSTAR ASCII parameter file of one axis

TDQS

A3.5/5.0

Scored across 22 tools

Disambiguation4/5

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.

Naming Consistency4/5

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.

Tool Count4/5

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.

Completeness4/5

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).

Maintenance

ActivityMaintained
ResponsivenessNo issues