Documentation

Complete MCP tool reference for the OpenShopFloor factory simulation. All tools are available via the Model Context Protocol.

Getting Started

OpenShopFloor exposes a full manufacturing simulation through 91 MCP (Model Context Protocol) tools. Your AI agent connects to our MCP server and gets access to real-time factory data.

// Connect your agent to the MCP server

endpoint: "https://api.openshopfloor.zeroguess.ai/mcp"

auth: "Bearer YOUR_API_KEY"

The factory simulates a complete manufacturing environment: CNC machines, injection molding (SGM), assembly lines, pre-assembly, and a test field. All connected to ERP, OEE, QMS, and tool management databases.

Tool Reference

Capacity Planning

5 tools

Machine utilization, load analysis, CM01/CM21

factory_get_cm01

Kapazitaetsauslastung (CM01) fuer eine Maschine nach Perioden (Tag/Woche).

Parameter	Required
machineNo	yes
periodType	no
periodCount	no

factory_get_capacity_overview

Kapazitaetsuebersicht aller Maschinen. Identifiziert ueber-/unterausgelastete Maschinen.

Parameter	Required
periodType	no
periodCount	no

factory_get_capacity_summary

Kompakte Kapazitaetszusammenfassung aller Maschinen (aktuelle + naechste Woche).

factory_get_cm21_orders

Fertigungsauftraege pro Arbeitsplatz (CM21), filterbar nach Maschine.

Parameter	Required
machineNo	no

factory_get_capacity_load

Durchschnittliche Kapazitaetsauslastung in Prozent.

Customer Orders

4 tools

Order tracking, delivery risk, VA05

factory_get_customer_orders

Listet alle Kundenauftraege: Kunde, Artikel, Menge, Liefertermine, Status.

Parameter	Required
status	no

factory_get_customer_order

Details eines Kundenauftrags inkl. Produktionsauftrag und Lieferstatus.

Parameter	Required
kundenauftragNr	yes

factory_get_va05_summary

VA05-Uebersicht: Gesamtzahl, offen, in Produktion, versandt, ueberfaellig.

factory_get_orders_at_risk

Gefaehrdete Kundenauftraege nahe am Liefertermin oder ueberfaellig.

Parameter	Required
daysAhead	no

KPIs & Revenue

3 tools

OTD, revenue, delivery performance

factory_get_customer_otd

Gesamt-Liefertreue (On-Time Delivery) ueber alle Kunden.

factory_get_otd_statistics

Detaillierte OTD-Statistiken gesamt und je Kunde.

factory_get_monthly_revenue

Monatsumsatz aus gelieferten Kundenauftraegen.

Maintenance

5 tools

Notifications, MTBF/MTTR, downtime analysis

factory_get_open_notifications

Alle offenen Stoer- und Wartungsmeldungen.

factory_get_maintenance_orders

Wartungsauftraege, optional nach Status filtern.

Parameter	Required
status	no

factory_get_machine_reliability

Zuverlaessigkeitskennzahlen: MTBF, MTTR, Verfuegbarkeit.

Parameter	Required
machineNo	yes
daysBack	no

factory_get_maintenance_summary

PM-Uebersicht: offene Meldungen, Auftraege, MTBF/MTTR.

factory_get_downtime_report

Stillstandsanalyse mit Grund und Dauer.

Parameter	Required
daysBack	no

Material Planning

4 tools

MD04, MD07, availability forecasts, shortages

factory_get_md04

Bedarfs-/Bestandsliste (MD04) fuer ein Teil, aehnlich SAP MD04.

Parameter	Required
teilId	yes

factory_get_md07

Alle aktuellen Unterdeckungen (MD07) — Teile mit Fehlmengen.

factory_get_availability_at_date

Prognostiziert Teilverfuegbarkeit an einem bestimmten Datum.

Parameter	Required
teilId	yes
date	yes

factory_get_baugruppen_shortages

Fehlmengen bei Baugruppen (Eigenfertigung, nicht bestellbar).

OEE & Production

4 tools

Availability, performance, quality, scrap history

factory_get_machine_oee

OEE einer Maschine: Verfuegbarkeit x Leistung x Qualitaet.

Parameter	Required
machineNo	yes
hours	no

factory_get_latest_oee

Aktuellste OEE-Werte aller Maschinen.

factory_get_production_history

Produktionsverlauf: Gut-Teile, Ausschuss, Nacharbeit pro Stunde.

Parameter	Required
hours	no

factory_get_scrap_history

Ausschuss-Historie nach Maschine gruppiert.

Parameter	Required
hours	no

Work Orders

4 tools

Order details, machine queues, material readiness

factory_get_work_order

Details eines Fertigungsauftrags inkl. Material-/Kapazitaetsstatus.

Parameter	Required
orderNo	yes

factory_get_machine_queue

Warteschlange einer Maschine: Auftraege nach Prioritaet.

Parameter	Required
machineNo	yes

factory_check_material_readiness

Materialverfuegbarkeit fuer einen Fertigungsauftrag pruefen.

Parameter	Required
orderNo	yes

factory_get_blocked_orders_count

Anzahl blockierter Auftraege (Material/Kapazitaet).

Purchasing

3 tools

Open purchases, suppliers, evaluations

factory_get_pending_purchases

Alle offenen Bestellungen mit erwartetem Lieferdatum.

factory_get_supplier_for_material

Lieferant fuer ein Material mit Lieferzeit und Preis.

Parameter	Required
teilId	yes

factory_get_supplier_evaluation

Lieferantenbewertung: Liefertreue, Qualitaet, Preise.

Parameter	Required
supplierId	no

Quality Management

4 tools

SPC alarms, calibration, Cpk, quality notifications

factory_get_spc_alarms

Aktive SPC-Alarme mit betroffenen Maschinen.

factory_get_calibration_due

Messmittel mit faelliger Kalibrierung.

factory_get_quality_notifications

Offene Qualitaetsmeldungen (Reklamationen, interne Fehler).

factory_get_cpk_overview

Prozessfaehigkeitsindizes (Cpk) fuer alle ueberwachten Merkmale.

Parameter	Required
machineNo	no

Stock & Inventory

2 tools

Stock levels, reservations, low-stock alerts

factory_get_stock_item

Lagerbestand eines Materials mit Reservierungen und Verfuegbarkeit.

Parameter	Required
teilId	yes

factory_get_low_stock_items

Materialien mit niedrigem Bestand (unter Sicherheitsbestand).

Tool Management

9 tools

Tool wear, replacements, article tool lists

tms_get_status

Status aller Werkzeuge: Verschleiss, Standort, Verfuegbarkeit.

tms_get_machine_tools

Alle Werkzeuge aktuell an einer Maschine.

Parameter	Required
machine_no	yes

tms_get_critical

Werkzeuge mit kritischem Verschleiss (>80%).

tms_replace_tool

Verschlissenes Werkzeug an einer Maschine tauschen.

Parameter	Required
machine_no	yes
old_tool_id	yes
new_tool_id	no

tms_get_replacements

Verfuegbare Ersatzwerkzeuge fuer einen Werkzeugtyp.

Parameter	Required
werkzeug_id	yes

tms_get_tools_for_article

Werkzeugliste fuer einen Artikel — benoetigte Werkzeugtypen.

Parameter	Required
article_no	yes

tms_check_tool_availability

Prueft ob eine Maschine alle Werkzeuge fuer einen Artikel hat.

Parameter	Required
machine_no	yes
article_no	yes

tms_get_tool_changes

Benoetigte Werkzeugtausche bei Umruestung + zusaetzliche Ruestzeit.

Parameter	Required
machine_no	yes
article_no	yes

tms_get_history

Letzte Werkzeugeinsaetze und -tausche.

Parameter	Required
limit	no

Injection Molding

5 tools

Process data, cavity balance, trends, aggregates

sgm_get_process_data

Spritzguss-Prozessdaten (~97 Parameter): Temperaturen, Druecke, Geschwindigkeiten.

Parameter	Required
machine_no	yes
hours	no

sgm_get_process_trend

Trend eines Prozessparameters ueber Zeit — Drift-Erkennung.

Parameter	Required
machine_no	yes
parameter	yes
hours	no

sgm_get_cavity_balance

Kavitaets-Balance (Druckverteilung) — erkennt ungleichmaessige Fuellung.

Parameter	Required
machine_no	yes
shots	no

sgm_get_cavity_trend

Trend einer Kavitaet (Heisskanal-Temp, Druck) ueber Zeit.

Parameter	Required
machine_no	yes
cavity_nr	yes
hours	no

sgm_get_hourly_aggregates

Stuendliche Aggregate: Durchschnittswerte, Schusszahl, Ausschussrate.

Parameter	Required
machine_no	yes
hours	no

Assembly Lines

14 tools

Station tools, OEE, BDE, process data, maintenance

montage_get_tms_status

Status aller Montage-Werkzeuge: Verschleiss, Station, Verfuegbarkeit.

montage_get_critical_tools

Montage-Werkzeuge mit kritischem Verschleiss (>80%).

montage_get_station_tools

Alle Werkzeuge einer Montagestation.

Parameter	Required
station_id	yes

montage_get_replacements

Ersatzwerkzeuge fuer Montage-Werkzeugtyp.

Parameter	Required
werkzeug_id	yes

montage_replace_tool

Verschlissenes Werkzeug an Montagestation tauschen.

Parameter	Required
station_id	yes
old_tool_id	yes

montage_get_tool_history

Letzte Werkzeugeinsaetze an Montagestationen.

Parameter	Required
limit	no

montage_get_maintenance_summary

Montage-Instandhaltungsuebersicht.

montage_get_open_notifications

Offene Stoer-/Wartungsmeldungen der Montagelinien.

montage_get_open_orders

Offene Wartungsauftraege der Montagelinien.

montage_get_station_reliability

Zuverlaessigkeit: MTBF, MTTR, Verfuegbarkeit.

Parameter	Required
station_id	no

montage_get_due_plans

Faellige Wartungsplaene der Montagelinien.

montage_get_oee

OEE einer Montagelinie (Verfuegbarkeit, Leistung, Qualitaet).

Parameter	Required
linie_id	no

montage_get_prozessdaten

Prozessdaten einer Montagestation (Parameter, Soll, Toleranz).

Parameter	Required
station_id	yes
limit	no

montage_get_bde

BDE-Daten: Zykluszeiten, Gut-Teile, NIO-Teile, Stoergruende.

Parameter	Required
linie_id	no
limit	no

Energy Management

6 tools

Consumption, cost, per-part energy, base load

factory_get_energy_overview

Energieverbrauch aller Maschinen: aktuelle Leistung, Gesamt-kWh.

factory_get_machine_energy

Energieverbrauch einer Maschine ueber Zeit.

Parameter	Required
machineNo	yes
hours	no

factory_get_energy_per_part

kWh pro Gutteil einer Maschine.

Parameter	Required
machineNo	yes
hours	no

factory_get_energy_costs

Energiekosten in EUR.

Parameter	Required
pricePerKwh	no
hours	no

factory_get_energy_trend

Stuendlicher Leistungstrend einer Maschine.

Parameter	Required
machineNo	yes
hours	no

factory_get_base_load

Grundlast vs. Produktionslast aller Maschinen.

Subcontracting

7 tools

External processing orders, supplier capacity

factory_get_fb_auftraege

Alle Fremdbearbeitungsauftraege mit Status.

Parameter	Required
status	no

factory_get_fb_kapazitaet

Kapazitaet und Auslastung der FB-Lieferanten.

factory_get_fb_versand

Auftraege bereit zum Versand an Lieferant.

factory_get_fb_wareneingang

Auftraege mit erwartetem Wareneingang.

factory_get_fb_liefertreue

Liefertreue der FB-Lieferanten.

factory_get_fb_queue

Auftraege in Warteschlange nach Lieferant.

Parameter	Required
lieferantId	no

factory_get_fb_bewertung

Qualitaetsbewertung der FB-Lieferanten.

Pre-Assembly

4 tools

Cell status, OEE, buffer levels, maintenance

montage_get_vormontage_status

Status der Vormontage-Zellen VM-1, VM-2, VM-3.

montage_get_vormontage_oee

OEE der Vormontage-Zellen.

Parameter	Required
cell_id	no

montage_get_vormontage_buffer

Pufferfuellstand zwischen Vormontage und Montagelinien.

montage_get_vormontage_wartung

Wartungsstatus der Vormontage-Stationen.

Test Field

4 tools

Function tests, leak tests, burn-in, defect analysis

montage_get_prueffeld_status

Status des Prueffelds (Funktionstest, Dichtheit, Burn-In).

montage_get_prueffeld_ergebnisse

IO/NIO-Rate des Prueffelds.

Parameter	Required
hours	no

montage_get_prueffeld_queue

Teile in der Prueffeld-Warteschlange.

montage_get_prueffeld_fehleranalyse

Fehleranalyse nach Fehlertyp und Produkt.