assign_shift_employee
ChatGPTUse this when the user explicitly asks to put a person on a published shift. Same rules as the duty plan: nobody works two shifts at once (also across midnight), archived shifts stay closed, and a shift with a person group takes only its members. German: Schicht zuweisen, einplanen, auf Schicht setzen.
cancel_absence
ChatGPTUse this only when the user explicitly asks to cancel an approved absence. The entry stays with status=cancelled, the days are returned and the range is free again. A pending request is rejected with decide_absence instead. German: Urlaub stornieren, Abwesenheit zuruecknehmen.
cancel_absence_closure
ChatGPTUse this only when the user explicitly asks to cancel company holidays. Withdraws every entry that is still approved, returns the days and notifies those affected; entries already cancelled stay untouched. German: Betriebsferien stornieren, absagen.
create_absence
ChatGPTUse this when the user explicitly asks to request or enter an absence such as vacation, overtime compensation or training. Acts with the connected person's rights: for others only if the app allows it. Whether it is approved at once or waits is decided by the app, as for that person's own request. Sick leave, a child's sickness, quarantine and maternity protection are refused: they are entered in MetronHR itself. German: Urlaub beantragen, Abwesenheit eintragen.
create_absence_closure
ChatGPTUse this when the user confirms company holidays after seeing preview_absence_closure. Enters every eligible person with an approved absence and notifies them; people who do not fit are skipped instead of failing the whole run. German: Betriebsferien anlegen, Betriebsurlaub eintragen.
create_customer
ChatGPTUse this when the user explicitly asks to add a new client. The customer number must be unique in the company; the new customer gets the service "Allgemein". German: Kunde anlegen.
create_customer_contingent
ChatGPTUse this when the user explicitly asks to set up an hour budget for a customer and service. Overlapping another budget of the same service fails and names both ranges. German: Kontingent anlegen, Stundenbudget.
create_department
ChatGPTUse this when the user explicitly asks to create a department, optionally with a lead. A name already taken is refused. German: Abteilung anlegen.
create_holiday
ChatGPTUse this when the user explicitly asks to add a company day off, such as an anniversary, for all regions (regions: "ALL") or single ones. Absences and target hours are recalculated. Statutory holidays already exist and are not created here. German: freien Tag anlegen, eigener Feiertag.
create_project
ChatGPTUse this when the user explicitly asks to create a project for a customer. The customer cannot be changed later. German: Projekt anlegen.
create_service
ChatGPTUse this when the user explicitly asks to add a billable service with hourly rate and billing increment. German: Leistung anlegen.
create_support_ticket
ChatGPTUse this when the user explicitly wants to report a problem, ask a question or suggest something to the metronHR support team, in the connected person's name. Support answers that person in the help center and by email. Do not use it for questions you can answer with the other tools. German: Support kontaktieren, Fehler melden, Problem melden, Hilfe.
create_time_entry
ChatGPTUse this when the user explicitly asks to record working time for a person on a day, for example a forgotten clock-in. Follows the same rules as recording in the app: locked periods, overlap check and the statutory break split apply. Do not use it to change an existing entry (update_time_entry). German: Zeit nachtragen, Arbeitszeit eintragen, Stunden buchen.
decide_absence
ChatGPTUse this when the user explicitly approves or rejects a pending absence request. A decided request cannot be decided again; to change an approved one use update_absence, to withdraw it cancel_absence. German: Urlaub genehmigen, Antrag ablehnen, freigeben.
decide_shift_application
ChatGPTUse this when the user explicitly approves or rejects an application for an open shift. On approval the person is on the shift. German: Bewerbung annehmen, ablehnen.
decide_time_entry_change_request
ChatGPTUse this when the user explicitly approves or rejects a pending request to change, delete or add a time entry. Approval applies the change like the review in the app: locked days stay locked, and the requester is notified and reads a rejection reason. German: Korrektur genehmigen, ablehnen, freigeben.
delete_customer_contingent
ChatGPTUse this only when the user explicitly asks to delete a contingent. Works even without the plan that offers contingents. German: Kontingent loeschen.
delete_department
ChatGPTUse this only when the user explicitly asks to delete a department. If it still has members, it fails until reassignTo names the department they move to. German: Abteilung loeschen.
delete_holiday
ChatGPTUse this only when the user explicitly asks to remove one of the company's own days off. Statutory holidays cannot be deleted. German: Feiertag loeschen.
delete_project
ChatGPTUse this only when the user explicitly asks to remove a project. With time booked on it the app deactivates it instead of deleting. German: Projekt loeschen.
delete_service
ChatGPTUse this only when the user explicitly asks to delete a service. Fails and names what is in the way if time entries or contingents use it. German: Leistung loeschen.
delete_shift_assignment
ChatGPTUse this only when the user explicitly asks to take a person off a shift. Who is on a shift shows list_shifts or get_shift (assignedEmployeeIds). German: von Schicht nehmen, austragen.
delete_time_entry
ChatGPTUse this only when the user explicitly asks to delete a specific time entry. Cannot be undone; confirm with the user first. German: Zeiteintrag loeschen.
get_absence
ChatGPTUse this when you have one absence id (from list_absences) and need its details. German: Abwesenheit, Urlaubsantrag.
get_absence_closure
ChatGPTUse this when you have one closure id (from list_absence_closures) and need every person it created an entry for, with status. German: Betriebsferien.
get_customer
ChatGPTUse this when you have one customer id (from search or list_customers) and need that customer's details. German: Kunde, Kundendaten.
get_customer_contingent
ChatGPTUse this when you have one contingent id (from list_customer_contingents) and need its details. German: Kontingent.
get_department
ChatGPTUse this when you have one department id (from search or list_departments) and need its name and lead. German: Abteilung, Abteilungsleitung.
get_employee
ChatGPTUse this when you already have one employee id (from search or list_employees) and need that person's master data. Same fields and the same limits as list_employees. Do not guess an id from a name; call search first. German: Mitarbeiter, Stammdaten, Personalakte.
get_employee_compensation
ChatGPTUse this when you have one contract id and need that contract's pay. Same grant and limits as list_employee_compensation. German: Gehalt, Verguetung.
get_employee_contract
ChatGPTUse this when you have one contract id (from list_employee_contracts) and need its details, without pay. German: Arbeitsvertrag.
get_holiday
ChatGPTUse this when you have one holiday id (from list_holidays) and need its details. German: Feiertag.
get_project
ChatGPTUse this when you have one project id (from search or list_projects) and need its details and customer. German: Projekt.
get_service
ChatGPTUse this when you have one service id (from search or list_services) and need its rate and billing increment. German: Leistung, Stundensatz.
get_service_proof
ChatGPTUse this when you have one proof of service id (from list_service_proofs) and need its metadata. German: Leistungsnachweis.
get_service_proof_pdf
ChatGPTUse this when the user wants the PDF of a completed proof of service. Returns a download address valid for five minutes; a proof that is not completed has no document. German: Leistungsnachweis PDF, herunterladen.
get_shift
ChatGPTUse this when you have one shift id (from list_shifts) and need its details and who is assigned. German: Schicht, Besetzung.
get_shift_application
ChatGPTUse this when you have one application id (from list_shift_applications) and need its details. German: Schichtbewerbung.
get_shift_area
ChatGPTUse this when you have one shift area id and need its details. German: Schichtbereich.
get_support_ticket
ChatGPTUse this when you have one ticket id (from list_support_tickets) and need its description, history and the support team's answers. German: Ticket, Antwort vom Support.
get_time_account
ChatGPTUse this when the user asks about one person's overtime balance and you have their employee id (from search). German: Ueberstunden, Zeitkonto.
get_time_entry
ChatGPTUse this when you have one time entry id (from list_time_entries) and need its full details. German: Zeiteintrag, Buchung.
get_time_entry_change_request
ChatGPTUse this when you have one change request id (from list_time_entry_change_requests) and need its details. German: Korrekturantrag.
get_vacation_balance
ChatGPTUse this when the user asks about one person's remaining vacation and you have their employee id (from search). German: Resturlaub, Urlaubstage.
get_work_time_model
ChatGPTUse this when you have one work time model id and need its hours, days and break rule. German: Arbeitszeitmodell.
list_absence_closures
ChatGPTUse this when the user asks which company holidays or closure days the company has set, for example over Christmas. Returns range, type, recurrence and how many entries still apply. German: Betriebsferien, Betriebsurlaub, Schliesstage, Brueckentag.
list_absences
ChatGPTUse this when the user asks who is away or on vacation on a day or in a period, or which absence requests are pending. Filter by from/to (yyyy-MM-dd; every absence touching the range counts), employeeId and status (pending, approved, rejected, cancelled). Never returns notes or health information: the type is left out for sick leave, a child's sickness, quarantine and maternity protection, and wherever the connected person may not see it in the app, so such an entry only says that the person is away. Do not use it for remaining vacation days (list_vacation_balances). German: Urlaub, abwesend, wer fehlt, Abwesenheiten, Urlaubsantrag.
list_customer_contingents
ChatGPTUse this when the user asks how many hours a customer has left of an agreed budget per service, or which budgets are used up. Filter by customerId, serviceId and status. German: Kontingent, Stundenkontingent, Budget, Reststunden, verbraucht.
list_customers
ChatGPTUse this when the user asks about the company's own clients: which exist, their numbers or contact data. Accepts a search term. These are the customers time is booked for, not users of metronHR. German: Kunden, Auftraggeber, Kundenliste.
list_departments
ChatGPTUse this when the user asks which departments or teams exist or who leads one. Returns each department with its lead. Do not use it for the members of a department (use list_employees with a search term). German: Abteilungen, Teams, Bereiche, Abteilungsleitung.
list_employee_compensation
ChatGPTUse this when the user asks about salaries, wages, bonuses, pension schemes or notice periods per contract. Only offered with the separate compensation grant; people see what the app shows them (CEO, HR and accounting every contract, everyone else their own). German: Gehalt, Lohn, Verguetung, Bonus, Sonderzahlung, Kuendigungsfrist.
list_employee_contracts
ChatGPTUse this when the user asks about employment contracts: type, term, hours, vacation entitlement or overtime rule, for example which contracts end soon. Never returns pay, bonuses, pensions or notice periods (those need list_employee_compensation and its own grant). German: Arbeitsvertrag, Vertraege, befristet, Vertragsende, Probezeit, Urlaubsanspruch.
list_employees
ChatGPTUse this when the user asks who works in the company or a team: names, roles, departments, employment status, or a headcount. Accepts a search term. Never returns bank details, birth dates or health data; people without access to the employee list in the app see only name and department of colleagues, as in the team calendar. Do not use it for pay (list_employee_compensation) or contracts (list_employee_contracts). German: Mitarbeiter, Mitarbeitende, Team, Belegschaft, Personal, wer arbeitet bei uns.
list_holidays
ChatGPTUse this when the user asks whether a day is a holiday or day off at their company ("bei uns") or which holidays fall in a period. Answers for the company's own regions and its own days off, which general knowledge cannot; also needed to compare worked hours with target hours. Lists the statutory holidays of the company's country and region plus its own days off, sorted by date. Filter by from/to (yyyy-MM-dd), at most one year per call; without them, the current year. German: Feiertage, Feiertag, frei, gesetzlicher Feiertag.
list_projects
ChatGPTUse this when the user asks which projects exist or which projects a customer has. Accepts a search term; each project comes with its customer. Do not use it for the hours worked on a project (list_time_entries). German: Projekte, Auftraege, Projektliste.
list_service_proofs
ChatGPTUse this when the user asks about proofs of service (signed work reports for customers): number, customer, project and status. Filter by customerId, projectId and from/to on creation. Metadata only: snapshot and signatures stay in the app. German: Leistungsnachweis, Arbeitsnachweis, Stundennachweis, Unterschrift.
list_services
ChatGPTUse this when the user asks which billable services exist, their hourly rate or billing increment. Accepts a search term. Do not use it for a customer's hour budget (list_customer_contingents). German: Leistungen, Taetigkeiten, Stundensatz, Abrechnung.
list_shift_applications
ChatGPTUse this when the user asks who applied for open shifts or which applications wait for a decision (status=pending). German: Bewerbungen auf Schichten, offene Schichten.
list_shift_areas
ChatGPTUse this when the user asks in which areas or locations shifts are planned. German: Schichtbereiche, Bereiche, Stationen.
list_shifts
ChatGPTUse this when the user asks who works when: the published shift or duty plan for a period, with area, times and staffing. Filter by from/to (yyyy-MM-dd). Drafts of the planner are not included. German: Schichtplan, Dienstplan, Schichten, wer arbeitet morgen, Fruehschicht, Spaetschicht.
list_support_tickets
ChatGPTUse this when the user asks about their reports to metronHR support: what is open, closed or answered. Management and HR see all of the company's reports, everyone else their own. German: Support, Ticket, Meldung, Anfrage an metronHR.
list_time_accounts
ChatGPTUse this when the user asks about overtime or minus hours: whose balance is how high, what can be taken off today, what is requested or approved. Same figures as the dashboard, the terminal and the app. Do not use it for vacation days (list_vacation_balances). German: Ueberstunden, Ueberstundenkonto, Zeitkonto, Minusstunden, Gleitzeit, Stundenkonto.
list_time_entries
ChatGPTUse this when the user asks what someone worked, when they started or stopped, or how many hours were recorded in a period, for a person or the whole company. Filter by from/to (yyyy-MM-dd, inclusive) and employeeId; times are absolute ISO instants, date is the company's calendar day. Do not use it for overtime balances (list_time_accounts) or pending corrections (list_time_entry_change_requests). German: Arbeitszeit, Stunden, Zeiterfassung, Stundenzettel, gestempelt, eingestempelt, Zeiten.
list_time_entry_change_requests
ChatGPTUse this when the user asks which corrections of time entries employees have asked for, or what is waiting for approval. Returns reason, old and requested values and status; status=pending lists the open ones. German: Korrekturantraege, Aenderungsantraege, Zeitkorrektur, offene Antraege, Nachtrag.
list_vacation_balances
ChatGPTUse this when the user asks how many vacation days someone has left, carried over from last year, or already approved. A calculated balance per person. Do not use it for overtime (list_time_accounts). German: Resturlaub, Urlaubstage, Urlaubsanspruch, wie viel Urlaub, Urlaubskonto.
list_work_time_model_assignments
ChatGPTUse this when the user asks which working hours apply to a person on a day, or who works under which model since when, including individual weekly hours. German: Sollzeit einer Person, Stunden pro Woche, welches Arbeitszeitmodell.
list_work_time_models
ChatGPTUse this when the user asks about working hours rules: weekly hours, working days or break rules of the company's models. This is what recorded time is measured against. Do not use it to find which model one person has (list_work_time_model_assignments). German: Arbeitszeitmodell, Wochenstunden, Sollstunden, Teilzeit, Vollzeit, Pausenregel.
preview_absence_closure
ChatGPTUse this when the user wants to set company holidays: before create_absence_closure, always call this and show the result. Reports per person whether they would be entered, entered as paid leave because vacation does not cover it, or skipped with a reason. Creates nothing. German: Betriebsferien planen, Betriebsurlaub vorab pruefen.
refill_customer_contingent
ChatGPTUse this when the user explicitly asks to add hours to a contingent. A used-up or suspended contingent can be booked again afterwards. German: Kontingent auffuellen, Stunden nachkaufen.
reply_to_support_ticket
ChatGPTUse this when the user explicitly wants to answer the support team in an existing ticket, in the connected person's name. German: dem Support antworten.
search
ChatGPTUse this when the user names a person, department, customer, project or service by name or number and you need its id for another tool. Searches all five at once; every word must match. Areas the connection may not read are skipped and named. Do not use it for time entries, absences or shifts (use their list tools with a date range). German: suchen, finden, wer ist, Kunde, Projekt, Mitarbeiter.
update_absence
ChatGPTUse this when the user explicitly asks to change type, start, end or half day of a pending or approved absence, for example to move a vacation. Only the given fields change; days, vacation and overtime are recalculated. A change to sick leave, a child's sickness, quarantine or maternity protection is refused. If the new range overlaps another entry, the refusal names its id and range. German: Urlaub verschieben, Abwesenheit aendern.
update_customer
ChatGPTUse this when the user explicitly asks to change a client's master data or deactivate it (isActive=false). Customers are never deleted. German: Kunde aendern, Kunde deaktivieren.
update_customer_contingent
ChatGPTUse this when the user explicitly asks to change a contingent. Only the given fields change; the rest is calculated by the app. German: Kontingent aendern.
update_department
ChatGPTUse this when the user explicitly asks to rename a department or set its lead; leadId null removes the lead. Missing fields keep their value. German: Abteilung umbenennen, Leitung setzen.
update_employee
ChatGPTUse this when the user explicitly asks to change a person's name, personnel number, department, position, start date or supervisor. Only the given fields change, null clears one. Role, login address and personal data stay untouched; new people are invited in the app, not created here. German: Stammdaten aendern, Abteilung wechseln, Vorgesetzten setzen.
update_holiday
ChatGPTUse this when the user explicitly asks to change one of the company's own days off. Statutory holidays cannot be changed. German: Feiertag aendern.
update_project
ChatGPTUse this when the user explicitly asks to change a project. Fields not given stay unchanged. German: Projekt aendern.
update_service
ChatGPTUse this when the user explicitly asks to change a service. The product's system services cannot be changed. German: Leistung aendern, Stundensatz aendern.
update_time_entry
ChatGPTUse this when the user explicitly asks to correct an existing time entry, for example a wrong end time. Give the id (from list_time_entries) and at least one field; the rest stays. Do not use it to decide an employee's correction request (decide_time_entry_change_request). German: Zeit korrigieren, Eintrag aendern.
whoami
ChatGPTUse this only when the user asks about the connection itself: which company it belongs to, who is signed in with which role, or what it is allowed to do. Returns the company, the connected person with role and the granted scopes. Do not call it before other tools to check permissions: a tool that is not granted is not listed. Do not use it to look up other people (use search or list_employees). German: wer bin ich, welche Rechte, welche Firma.