Talenox MCP by usefulapi
Review employees, payroll and leave, and approve or reject Talenox leave applications.
사용해야 할까요
품질 및 안전성
발견 사항 (5)
- LOWTool 'talenox_list_leave_applications' name length outside 3-30 rangetalenox_list_leave_applications에서
- LOWTool 'talenox_get_leave_entitlement_period' name length outside 3-30 rangetalenox_get_leave_entitlement_period에서
- LOWTool 'talenox_get_off_in_lieu_balance' name length outside 3-30 rangetalenox_get_off_in_lieu_balance에서
- LOWTool 'talenox_approve_leave_application' name length outside 3-30 rangetalenox_approve_leave_application에서
- LOWTool 'talenox_reject_leave_application' name length outside 3-30 rangetalenox_reject_leave_application에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"talenox": {
"url": "https://talenox.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://talenox.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢talenox_get_branch(id)
Get one branch (name, address, head, employee ids).
입력 스키마
{
"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.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢talenox_list_roles
List the company's employee roles (access roles).
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢talenox_get_role(id)
Get one employee role.
입력 스키마
{
"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).
입력 스키마
{
"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.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢talenox_get_working_day(id)
Get one working-day schedule.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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).
입력 스키마
{
"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).
입력 스키마
{
"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.
입력 스키마
{
"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).
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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).
입력 스키마
{
"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).
입력 스키마
{
"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).
입력 스키마
{
"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).
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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"
}커뮤니티
증거