Talenox MCP by usefulapi
Review employees, payroll and leave, and approve or reject Talenox leave applications.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (5)
- LOWTool 'talenox_list_leave_applications' name length outside 3-30 rangein talenox_list_leave_applications
- LOWTool 'talenox_get_leave_entitlement_period' name length outside 3-30 rangein talenox_get_leave_entitlement_period
- LOWTool 'talenox_get_off_in_lieu_balance' name length outside 3-30 rangein talenox_get_off_in_lieu_balance
- LOWTool 'talenox_approve_leave_application' name length outside 3-30 rangein talenox_approve_leave_application
- LOWTool 'talenox_reject_leave_application' name length outside 3-30 rangein talenox_reject_leave_application
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
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": {
"talenox": {
"url": "https://talenox.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://talenox.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (28)
🟢talenox_list_employees(search, status, limit, offset)
List the company's employees as a short summary (id, employee_id, names, email, hired/resign dates, current job). Talenox returns every employee in one reply, so use search to narrow and limit/offset to page here. Use talenox_get_employee for the full record. Sensitive fields (national id, passport, bank account) are never included.
Eingabe-Schema
{
"type": "object",
"properties": {
"search": {
"description": "Words that must all appear in the name, employee id, nickname or email (case-insensitive).",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"status": {
"description": "active = no resign date or one in the future; resigned = a resign date in the past. Default all.",
"type": "string",
"enum": [
"active",
"resigned",
"all"
]
},
"limit": {
"description": "Employees to return, 1-200 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 200
},
"offset": {
"description": "Employees to skip (default 0); use next_offset from the previous reply.",
"type": "integer",
"minimum": 0,
"maximum": 100000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢talenox_get_employee(id, include_sensitive)
Get one employee's full record: personal details, jobs, cost centres, custom fields. National id, passport, bank account and health fields are left out unless include_sensitive is true.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
],
"description": "The employee's Talenox id (the numeric `id` from talenox_list_employees)."
},
"include_sensitive": {
"description": "Include national id (ssn), passport, bank account, religion/race and vaccination fields. Default false.",
"type": "boolean"
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢talenox_get_job(id)
Get one job record of an employee (title, department, start/end date, pay amount and rate, currency). Job ids are in the employee's `jobs` list.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
],
"description": "The job id (from an employee's jobs list)."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢talenox_list_branches
List the company's branches with their head and employee ids.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢talenox_get_branch(id)
Get one branch (name, address, head, employee ids).
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
],
"description": "The branch id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢talenox_list_cost_centres
List the company's cost centres with their employee ids.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢talenox_list_roles
List the company's employee roles (access roles).
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢talenox_get_role(id)
Get one employee role.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
],
"description": "The role id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢talenox_get_company_settings
Get the company's API-related settings (for example whether an employee may belong to several cost centres).
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢talenox_list_working_days
List the working-day schedules (weekly pattern Sunday to Saturday: full_day, first_half, second_half, not_working) and who is on each.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢talenox_get_working_day(id)
Get one working-day schedule.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
],
"description": "The working-day schedule id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢talenox_list_holiday_policies(last_seen_id, limit)
List the company's public-holiday policies (country, state, default flag). Paged: pass next_last_seen_id as last_seen_id.
Eingabe-Schema
{
"type": "object",
"properties": {
"last_seen_id": {
"description": "Pagination: return results after this id (next_last_seen_id of the previous reply).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Results per page, 1-50 (Talenox default 20).",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢talenox_get_holiday_policy(id, start_at, end_at)
Get one holiday policy with its calendar events between two dates.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
],
"description": "The holiday policy id."
},
"start_at": {
"type": "string",
"description": "Start date, yyyy-mm-dd."
},
"end_at": {
"type": "string",
"description": "End date, yyyy-mm-dd."
}
},
"required": [
"id",
"start_at",
"end_at"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢talenox_list_company_holidays(year, show_inactive)
List the company's holidays (from its default holiday policy) for a year.
Eingabe-Schema
{
"type": "object",
"properties": {
"year": {
"description": "Calendar year (default: the current year at Talenox).",
"type": "integer",
"minimum": 1990,
"maximum": 2100
},
"show_inactive": {
"description": "Include inactive holidays (default false).",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢talenox_list_leave_applications(overlap_from, overlap_to, status, employee_id, approver_id, ...)
List leave applications that overlap a date range, optionally by status, employee, approver or leave type. Paged: pass next_last_seen_id as last_seen_id. Uses Talenox's leave API (beta).
Eingabe-Schema
{
"type": "object",
"properties": {
"overlap_from": {
"type": "string",
"description": "Start of the date range, yyyy-mm-dd."
},
"overlap_to": {
"type": "string",
"description": "End of the date range, yyyy-mm-dd."
},
"status": {
"description": "Only applications with this status.",
"type": "string",
"enum": [
"pending",
"approved",
"rejected"
]
},
"employee_id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
],
"description": "Only this employee's applications."
},
"approver_id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
],
"description": "Only applications this employee approves."
},
"category": {
"description": "type = leave type, oil = off in lieu.",
"type": "string",
"enum": [
"type",
"oil"
]
},
"category_id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
],
"description": "Leave type id (category type) or off in lieu id (category oil)."
},
"last_seen_id": {
"description": "Pagination: return results after this id (next_last_seen_id of the previous reply).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Results per page, 1-50 (Talenox default 20).",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"required": [
"overlap_from",
"overlap_to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢talenox_get_leave_application(id)
Get one leave application (employee, dates, half-day markers, amount, status, approvers, attachments).
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
],
"description": "The leave application id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢talenox_list_leave_types(employee_id, last_seen_id, limit)
List the leave types of the company, or those an employee may apply for (employee_id). Paged: pass next_last_seen_id as last_seen_id.
Eingabe-Schema
{
"type": "object",
"properties": {
"employee_id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
],
"description": "Only the leave types open to this employee."
},
"last_seen_id": {
"description": "Pagination: return results after this id (next_last_seen_id of the previous reply).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Results per page, 1-50 (Talenox default 20).",
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢talenox_get_leave_type(id)
Get one leave type (name, half-day allowed, quantity type, policy dates).
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
],
"description": "The leave type id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢talenox_get_leave_balance(employee_id, query_date, leave_type_id)
Get an employee's leave balance on a date, for every leave type or for one (leave_type_id). A type that does not apply to the employee comes back with an error text instead of a balance.
Eingabe-Schema
{
"type": "object",
"properties": {
"employee_id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
],
"description": "The employee's Talenox id."
},
"query_date": {
"type": "string",
"description": "The date to compute the balance for, yyyy-mm-dd."
},
"leave_type_id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
],
"description": "Only this leave type."
}
},
"required": [
"employee_id",
"query_date"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢talenox_get_leave_entitlement_period(employee_id, leave_type_id, query_date)
Get the entitlement periods (start and end dates) of one leave type for an employee around a date.
Eingabe-Schema
{
"type": "object",
"properties": {
"employee_id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
],
"description": "The employee's Talenox id."
},
"leave_type_id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
],
"description": "The leave type id."
},
"query_date": {
"type": "string",
"description": "Reference date, yyyy-mm-dd."
}
},
"required": [
"employee_id",
"leave_type_id",
"query_date"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢talenox_list_off_in_lieus(employee_id, last_seen_id)
List the off-in-lieu types of the company, or of one employee. Paged: pass next_last_seen_id as last_seen_id.
Eingabe-Schema
{
"type": "object",
"properties": {
"employee_id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
],
"description": "Only this employee's off in lieus."
},
"last_seen_id": {
"description": "Pagination: return results after this id (next_last_seen_id of the previous reply).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢talenox_get_off_in_lieu_balance(employee_id, query_date, off_in_lieu_id)
Get an employee's off-in-lieu balance on a date, for every off in lieu or for one (off_in_lieu_id).
Eingabe-Schema
{
"type": "object",
"properties": {
"employee_id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
],
"description": "The employee's Talenox id."
},
"query_date": {
"type": "string",
"description": "The date to compute the balance for, yyyy-mm-dd."
},
"off_in_lieu_id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
],
"description": "Only this off in lieu."
}
},
"required": [
"employee_id",
"query_date"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢talenox_list_payroll_payments(month, year, created_by_webhook)
List the payroll payment runs of a month (period, pay group, status Draft or Processed, bank file state).
Eingabe-Schema
{
"type": "object",
"properties": {
"month": {
"type": "string",
"enum": [
"January",
"February",
"March",
"April",
"May",
"June",
"July",
"August",
"September",
"October",
"November",
"December"
],
"description": "Month name in English, e.g. September."
},
"year": {
"type": "integer",
"minimum": 2000,
"maximum": 2100,
"description": "Year, e.g. 2026."
},
"created_by_webhook": {
"description": "Only payments created by a webhook.",
"type": "boolean"
}
},
"required": [
"month",
"year"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢talenox_get_payroll_payment(id)
Get one payroll payment run (period, status, bank file and cheque export state).
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
],
"description": "The payment id (payment_id from talenox_list_payroll_payments)."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢talenox_list_custom_pay_items
List the company's pay item definitions (name, category such as Adhoc or Recurring, taxable, gross/net setting).
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢talenox_get_payslips_data(month, year, employee_ids)
Get the payslip figures (gross, net, deductions, year-to-date) of a month as data, for all employees or the listed ones. Read only: nothing is created, processed or published. Contains salary data.
Eingabe-Schema
{
"type": "object",
"properties": {
"month": {
"type": "string",
"enum": [
"January",
"February",
"March",
"April",
"May",
"June",
"July",
"August",
"September",
"October",
"November",
"December"
],
"description": "Month name in English, e.g. September."
},
"year": {
"type": "integer",
"minimum": 2000,
"maximum": 2100,
"description": "Year, e.g. 2026."
},
"employee_ids": {
"description": "Only these employees (default: all).",
"minItems": 1,
"maxItems": 200,
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
],
"description": "An employee's Talenox employee_id or id."
}
}
},
"required": [
"month",
"year"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴talenox_approve_leave_application(id)
WRITE: approve a leave application as the token's user. The employee's balance and payroll are affected and Talenox may notify them. Read the application first (talenox_get_leave_application) and confirm with the user.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
],
"description": "The leave application id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴talenox_reject_leave_application(id)
WRITE: reject a leave application as the token's user. Talenox may notify the employee. Read the application first (talenox_get_leave_application) and confirm with the user.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
],
"description": "The leave application id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Nachweis