MCP tools reference

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

Product (120 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 day the calendar treats differently, for the plant or one machine.
  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_maintenance_order — Give one maintenance order to a named person, by hand, overruling the
  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
• change_dispatch_rule — Change one blank on a written dispatch rule, switch it on or off, or
  no arguments
• close_nonconformance — Close a non-conformance - a supervisor action, audited as AGENT. Refused
  no arguments
• complete_operation — Complete one step of a work order.
  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_lot — Book a material lot in: a delivery arriving, or a quantity somebody
  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
• dispatch_maintenance — Run the supervisor's rules over every order at due and hand each
  no arguments
• disposition_nonconformance — Decide what happens to the material: use_as_is, rework, scrap or return.
  no arguments
• downtime_pareto — Downtime grouped by reason, worst first, with a running cumulative
  no arguments
• downtime_reasons — The plant's whole downtime vocabulary in code order, with its total:
  no arguments
• draft_downtime_reason — Draft one downtime reason for this plant. It changes nothing on the
  no arguments
• draft_instruction — Draft a work instruction. It arrives unapproved.
  no arguments
• draft_nc_severity — Draft one non-conformance severity for this plant. It grades nothing
  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 and identity.
  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_explain — Why this maintenance order went where it went: which rules were
  no arguments
• maintenance_mttr — Repair time over time, with the count of repairs nobody timed beside
  no arguments
• maintenance_plans — Every preventive plan with how far through its interval it is, how
  no arguments
• maintenance_roster — Who is on shift, which trades they hold, and how much they already
  no arguments
• maintenance_rules — The supervisor's dispatch rules in the order they are tried, with
  no arguments
• maintenance_shift — This shift in one read: one line a supervisor could say out loud -
  no arguments
• maintenance_work — Maintenance orders, newest first: due, given to somebody, in
  no arguments
• materials — Every material with its unit and type (raw, intermediate, finished);
  no arguments
• nc_severities — The plant's whole severity vocabulary in code order, with its total:
  no arguments
• nonconformance — One non-conformance with every step it has been through: who raised it,
  no arguments
• oee_breakdown — OEE per station with every loss named, plus the line's rollup - the
  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
• plant_settings — The settings a plant owns - found by what a person calls one, read
  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
• record_count — Record one inspection count for a characteristic whose specification says
  no arguments
• record_sample — Record a sample of n pieces for a characteristic whose specification is
  no arguments
• register_gauge — Add a gauge to the register (master data - refused unless an admin
  no arguments
• remove_dispatch_rule — Remove a dispatch rule that never handed any work out. One that has
  no arguments
• review_nonconformance — Take a non-conformance under review - a supervisor action saying somebody
  no arguments
• revise_document — Change an instruction that already exists: the next revision, as a draft.
  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_home_equipment — Say where a person normally works - a work center or a station -
  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
• setting_changes — What has actually been written to this plant's settings, newest
  no arguments
• shifts — Which shifts this plant has run lately, which one is running now, and on
  no arguments
• spc_chart — The control chart for one characteristic: control limits from the
  no arguments
• spc_lot — Why is this lot where it is - the records behind one point of a p
  no arguments
• spc_point — Why is this reading where it is - the records behind one point of a
  no arguments
• spc_sample — Why is this sample where it is - the records behind one point of an
  no arguments
• start_operation — Start one step of a work order - the operator's most basic act.
  no arguments
• state_timeline — Every state interval per machine - the shift as a Gantt, as the
  no arguments
• tag_trend — One machine's process value over the window, averaged into buckets
  no arguments
• trace_graph — This plant's questions and its stops as one graph of recorded facts -
  no arguments
• trace_rollup — What the people at this plant asked its assistant, grouped by
  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
• write_dispatch_rule — Write one of the supervisor's dispatch rules as the sentence it is:
  no arguments
• write_plant_setting — Put one of this plant's own settings in force, now.
  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