Timetaag MCP by usefulapi

Read employees, leave, attendance, punches, shifts and holidays in Timetaag.

Sollte ich dies verwenden

Qualität und Sicherheit

A
Qualität der Beschreibung
100%
Vollständigkeit des Schemas
97%
Qualität der Benennung
79%
Risiko der Vergiftung
100%
Übereinstimmung der Berechtigungen
100%
Einhaltung des Protokolls
100%

Befunde (1)

  • LOWTool 'timetaag_list_shift_assignments' name length outside 3-30 rangein timetaag_list_shift_assignments

Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.

Kontextkosten

~3,543Tokens (Tool-Definitionen)
~2.0 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (2.77% von 128k Kontext)

Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.

Installieren

Installation mit einem Klick

Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:

{
  "mcpServers": {
    "timetaag": {
      "url": "https://timetaag.usefulapi.io/mcp"
    }
  }
}

Remote-Endpunkte

https://timetaag.usefulapi.io/mcpstreamable-http

Was es kann

Tool-Inventar

Tools (14)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢timetaag_list_employees(status, emp_code, search, branch_id, department_id, ...)

List employees with their branch, department, designation, location and shift groups. Working employees by default; set status to resigned or all. Timetaag API: GET /api/v2/employees.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "status": {
      "description": "Default active.",
      "type": "string",
      "enum": [
        "active",
        "resigned",
        "all"
      ]
    },
    "emp_code": {
      "description": "Employee code, for example 101. Several codes: separate with commas.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "search": {
      "description": "Part of the name or code.",
      "type": "string"
    },
    "branch_id": {
      "description": "Filter by branch id (from timetaag_list_setup kind branches).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "department_id": {
      "description": "Filter by department id.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "location_id": {
      "description": "Filter by location id.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "section_id": {
      "description": "Filter by section id.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "designation_id": {
      "description": "Filter by designation id.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "updated_since": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
      "description": "Only records changed at or after this time, yyyy-mm-dd hh:mm:ss (company time zone). Use it for syncs."
    },
    "per_page": {
      "description": "Results per page, 1 to 200 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢timetaag_get_employee(emp_code)

Get one employee by employee code, with the same fields as the list. Timetaag API: GET /api/v2/employees/{emp_code}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "emp_code": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Employee code, for example 101."
    }
  },
  "required": [
    "emp_code"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢timetaag_list_leave_types(date)

List the leave types the company uses, for example annual or sick leave. Timetaag API: GET /api/v2/leave-types.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "date": {
      "description": "Leave types valid on this date.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢timetaag_list_leave_balances(emp_code, leave_type_id, date)

List the leave balances of one employee, per leave type. Timetaag API: GET /api/v2/leave-balances.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "emp_code": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Employee code, for example 101. Several codes: separate with commas."
    },
    "leave_type_id": {
      "description": "Only this leave type (from timetaag_list_leave_types).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "date": {
      "description": "Balances on this date (default today).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    }
  },
  "required": [
    "emp_code"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢timetaag_list_leaves(from, to, emp_code, status, leave_type_id, ...)

List leave entries that touch a date range, with status pending, approved or declined. Deleted leaves are left out. Timetaag API: GET /api/v2/leaves.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "First day, yyyy-mm-dd."
    },
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Last day, yyyy-mm-dd (at most 62 or 366 days after from, depending on the endpoint)."
    },
    "emp_code": {
      "description": "Employee code, for example 101. Several codes: separate with commas.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "status": {
      "type": "string",
      "enum": [
        "pending",
        "approved",
        "declined"
      ]
    },
    "leave_type_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "updated_since": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
      "description": "Only records changed at or after this time, yyyy-mm-dd hh:mm:ss (company time zone). Use it for syncs."
    },
    "per_page": {
      "description": "Results per page, 1 to 200 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "from",
    "to"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢timetaag_get_leave(id)

Get one leave entry by its id. Timetaag API: GET /api/v2/leaves/{id}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Leave id, from timetaag_list_leaves."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢timetaag_list_daily_attendance(from, to, emp_code, per_page, page)

List the calculated daily attendance (in, out, worked time, late and early marks) for a date range. Reports need a plan that includes them (HTTP 403 otherwise). Timetaag API: GET /api/v2/attendance/daily.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "First day, yyyy-mm-dd."
    },
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Last day, yyyy-mm-dd (at most 62 or 366 days after from, depending on the endpoint)."
    },
    "emp_code": {
      "description": "Employee code, for example 101. Several codes: separate with commas.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "per_page": {
      "description": "Results per page, 1 to 200 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "from",
    "to"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢timetaag_list_punches(from, to, emp_code, serial_number, updated_since, ...)

List the raw clock punches (biometric device and manual) for a date range. Timetaag API: GET /api/v2/punches.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "First day, yyyy-mm-dd."
    },
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Last day, yyyy-mm-dd (at most 62 or 366 days after from, depending on the endpoint)."
    },
    "emp_code": {
      "description": "Employee code, for example 101. Several codes: separate with commas.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "serial_number": {
      "description": "Only punches from this device serial number.",
      "type": "string"
    },
    "updated_since": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
      "description": "Only records changed at or after this time, yyyy-mm-dd hh:mm:ss (company time zone). Use it for syncs."
    },
    "per_page": {
      "description": "Results per page, 1 to 200 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "from",
    "to"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢timetaag_list_shift_assignments(from, to, emp_code, per_page, page)

List which shift each employee works on each day in a date range. Timetaag API: GET /api/v2/shift-assignments.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "First day, yyyy-mm-dd."
    },
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Last day, yyyy-mm-dd (at most 62 or 366 days after from, depending on the endpoint)."
    },
    "emp_code": {
      "description": "Employee code, for example 101. Several codes: separate with commas.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "per_page": {
      "description": "Results per page, 1 to 200 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "from",
    "to"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢timetaag_list_holidays(year, holiday_group_id)

List public holidays, for one year or one holiday group. Timetaag API: GET /api/v2/holidays.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "year": {
      "description": "Holiday year, for example 2026.",
      "type": "integer",
      "minimum": 1900,
      "maximum": 2999
    },
    "holiday_group_id": {
      "description": "Only this holiday group (from timetaag_list_setup kind holiday-groups).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢timetaag_list_regularizations(from, to, emp_code, status, per_page, ...)

List attendance regularization requests (corrections of punches) in a date range, with their status. Timetaag API: GET /api/v2/regularizations.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "First day, yyyy-mm-dd."
    },
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Last day, yyyy-mm-dd (at most 62 or 366 days after from, depending on the endpoint)."
    },
    "emp_code": {
      "description": "Employee code, for example 101. Several codes: separate with commas.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "status": {
      "type": "string",
      "enum": [
        "pending",
        "approved",
        "declined"
      ]
    },
    "per_page": {
      "description": "Results per page, 1 to 200 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "from",
    "to"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢timetaag_list_work_requests(from, to, emp_code, type, status, ...)

List work requests (for example on-duty or out-of-office) in a date range, with their type and status. Timetaag API: GET /api/v2/work-requests.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "First day, yyyy-mm-dd."
    },
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Last day, yyyy-mm-dd (at most 62 or 366 days after from, depending on the endpoint)."
    },
    "emp_code": {
      "description": "Employee code, for example 101. Several codes: separate with commas.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "type": {
      "description": "The request type, as Timetaag names it.",
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "pending",
        "approved",
        "declined",
        "cancelled"
      ]
    },
    "per_page": {
      "description": "Results per page, 1 to 200 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "from",
    "to"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢timetaag_list_expense_claims(from, to, emp_code, status, per_page, ...)

List expense claims in a date range, with their status and payout status. Timetaag API: GET /api/v2/expense-claims.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "First day, yyyy-mm-dd."
    },
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Last day, yyyy-mm-dd (at most 62 or 366 days after from, depending on the endpoint)."
    },
    "emp_code": {
      "description": "Employee code, for example 101. Several codes: separate with commas.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "status": {
      "type": "string",
      "enum": [
        "pending",
        "approved",
        "declined",
        "cancelled"
      ]
    },
    "per_page": {
      "description": "Results per page, 1 to 200 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "from",
    "to"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢timetaag_list_setup(kind)

List one kind of company setup: branches, departments, designations, locations, sections, teams, employment-types, biometric-groups, shifts, holiday-groups or devices. Use the ids in employee and leave filters. Timetaag API: GET /api/v2/<kind>.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "branches",
        "departments",
        "designations",
        "locations",
        "sections",
        "teams",
        "employment-types",
        "biometric-groups",
        "shifts",
        "holiday-groups",
        "devices"
      ],
      "description": "The setup list to read."
    }
  },
  "required": [
    "kind"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet14 Tools