MCP tools reference

Generated from the two servers' registries at build time. ? marks an optional argument.

Product (85 tools)

The MES as tools. Everything goes through a plant's HTTP API as the AGENT role; writes accept dry_run, on_behalf_of and client_ref (see the write discipline).

• add_bom_component — Put a component on a material's bill, with the operation it
  no arguments
• add_calendar_exception — A shutdown day (capacity removed) or an overtime day (capacity
  no arguments
• add_person — Add a person without a sign-in (create_user makes an account).
  no arguments
• add_shift — Add a shift pattern: starts/ends as HH:MM, days as seven 1/0 flags
  no arguments
• adjustment — One recommendation in full, including the verification: the
  no arguments
• adjustments — The recommendation queue: proposed, approved (waiting for the agent
  no arguments
• assign_role — Put a person into a role. Effective on their very next action, because
  no arguments
• audit — The append-only audit trail, newest first - humans and agents in the
  no arguments
• bill_of_material — What a material is made of: each component, its quantity per unit,
  no arguments
• book_output — Book output by hand: good and scrap counts made on a machine, against
  no arguments
• browse_tags — Every tag on every machine, flat, with a health line per machine
  no arguments
• calibrate_gauge — Record a calibration: pass, adjusted, or fail_as_found. A failure
  no arguments
• capabilities — Every capability a role can grant, and what each one means.
  no arguments
• certificate — The certificate for an order - the revision in force as Markdown,
  no arguments
• certificates — Every certificate of analysis in force, newest first.
  no arguments
• close_nonconformance — Close a non-conformance - a supervisor action, audited as AGENT.
  no arguments
• create_document — Create a controlled document as a draft (documents.write). It is not
  no arguments
• create_equipment — Add a node to the equipment tree: level is enterprise, site, area,
  no arguments
• create_maintenance_plan — Define a preventive plan on a machine. trigger is runtime_hours,
  no arguments
• create_material — Add a material: raw, intermediate or finished.
  no arguments
• create_order — Create a work order (and by default release it to the floor).
  no arguments
• create_role — Define a role as a bundle of capabilities.
  no arguments
• create_routing — Define a routing: operations as
  no arguments
• create_spec — Define a quality specification: a characteristic on a material with
  no arguments
• create_user — Create a sign-in account in a role.
  no arguments
• downtime — Downtime pareto over the window: which reasons cost what, and how much
  no arguments
• draft_instruction — Draft a work instruction. It arrives unapproved.
  no arguments
• draft_trigger — Draft a trigger: when tag on machine (or any machine) meets
  no arguments
• equipment_tree — The plant as a tree - site, lines, cells, machines - with the cost
  no arguments
• erp_outbox — The ERP interface's queue: counts by status (pending, sent, error,
  no arguments
• erp_retry — Put a dead or failing outbox message back in the queue. Needs
  no arguments
• gauge_impact — Every measurement taken with this gauge since its last calibration,
  no arguments
• gauge_resolution — Can this gauge judge this tolerance? The rule of ten: resolution
  no arguments
• gauges — The gauge register: every measuring instrument with its status,
  no arguments
• instruction — One instruction in full. Ask for a revision to read what it said then.
  no arguments
• instructions — Every controlled work instruction, and which revision is in force.
  no arguments
• instructions_for — The approved instructions covering a piece of work.
  no arguments
• issue_certificate — Issue or reissue the certificate for a completed order. Reissuing
  no arguments
• issue_material — Issue material from a lot to an order - the consumption side of
  no arguments
• issue_pallet_certificate — Issue a pallet's certificate of analysis - a supervisor's act
  no arguments
• line_wip — Work in progress at each station of a line, summed over the orders
  no arguments
• list_plants — The plants this server can operate, with reachability.
  no arguments
• lots — Material lots and how much of each remains.
  no arguments
• machine — One machine's head facts: where it sits, its cost center, its state
  no arguments
• machine_alarms — Active alarm bits, by name, on one machine or on every machine.
  no arguments
• machine_tags — Every tag the machine publishes with its latest value and age:
  no arguments
• machines — Every machine: current state, current order, its analog value, and OEE.
  no arguments
• maintenance_due — Plans that have come due (and those past 80%, due soon), worst
  no arguments
• maintenance_plans — Every preventive plan with how far through its interval it is.
  no arguments
• maintenance_work — Maintenance orders, newest first: due, in progress, or done, with
  no arguments
• materials — Every material with its unit and type (raw, intermediate, finished);
  no arguments
• order_action — release, hold, resume, close, or cancel an order.
  no arguments
• order_detail — One order: route progress per operation, plus its genealogy -
  no arguments
• order_promise — When the plan says this order finishes, and whether that misses
  no arguments
• orders — Work orders, newest first, one page at a time.
  no arguments
• pack_unit — Put one unit inside another: bottle into case, case onto pallet.
  no arguments
• pallet_certificate — A pallet's certificate of analysis: the Cpk of every dimensional
  no arguments
• people — Everyone the plant knows, with their role - or, with q (a code
  no arguments
• perform_maintenance — start or complete a maintenance order. Completing re-baselines its
  no arguments
• plan_all_orders — Schedule every open order, highest priority first.
  no arguments
• plan_order — Schedule one order's operations in route sequence through working
  no arguments
• plant_calendar — When the plant runs: shift patterns (with the days they run and
  no arguments
• produce_batch — Bring a batch of identified units into existence in one call, packed:
  no arguments
• produce_units — Bring identified units into existence for a material, optionally
  no arguments
• propose_adjustment — Recommend a setpoint change on a machine. The tag must be one the
  no arguments
• quality — The quality picture: specs, recent checks with pass/fail, and open
  no arguments
• raise_corrective_maintenance — Raise corrective work on a machine because something broke, with
  no arguments
• raise_due_maintenance — Turn every due plan into a maintenance order, once - a plan with
  no arguments
• record_check — Record a quality measurement. Out-of-spec values automatically open a
  no arguments
• register_gauge — Add a gauge to the register (master data - refused unless an admin
  no arguments
• roles — Roles defined in this plant, with the capabilities each grants.
  no arguments
• routings — Every routing: the ordered operations and the machine each runs on.
  no arguments
• schedule_board — The schedule machine by machine over the next hours: production
  no arguments
• set_machine_state — Set a machine's state (running/idle/down/setup...). Labelling downtime
  no arguments
• set_unit_status — Quarantine, release or scrap a unit and, by default, everything
  no arguments
• spc_chart — The individuals control chart for one characteristic: control
  no arguments
• tag_trend — A machine's process value over time - the signal that drifts before a
  no arguments
• trigger_catalog — The actions a trigger may take (log_event, open_nc,
  no arguments
• trigger_firings — What fired: for one trigger, or every firing in the last hours,
  no arguments
• triggers — Every trigger with its condition, action, status (draft, approved,
  no arguments
• unit — One identified unit and everything packed inside it, as a tree:
  no arguments
• unit_trace — What went into this unit and everything inside it: every lot, and
  no arguments
• update_role — Change what a role grants. Effective on everyone's next action.
  no arguments
• users — Accounts, their role, and what that role lets them do.
  no arguments
• where_used — Every package carrying a lot - the recall question, answered as
  no arguments

Simulation (13 tools)

The simulator and scoring harness as tools, for driving and judging fake plants. Not for a real one.

• compare_runs — Put recorded scorecards side by side, and say what differs.
  no arguments
• describe_line — What a plant's line is and what the simulator does to it.
  no arguments
• ingest_dataset — Profile a CSV of real records so a scenario can be built from its shape.
  no arguments
• job_status — How a scored run or sweep is getting on, and its result once finished.
  no arguments
• list_datasets — Datasets ingested so far.
  no arguments
• list_jobs — Jobs started this session. Restarting the server forgets them; finished
  no arguments
• list_knobs — What a sweep is allowed to vary, and why only these.
  no arguments
• list_plants — The simulated plants available, and whether each can be scored.
  no arguments
• metric_trend — One metric across past runs, oldest first.
  no arguments
• recent_runs — Scored runs already recorded, newest first.
  no arguments
• run_scorecard — The full scorecard for one recorded run.
  no arguments
• score_plant — Run a plant through its scripted hour and score what it reported.
  no arguments
• sweep_plant — Vary a line, score every variant, and compare the results.
  no arguments