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"
}コミュニティ
エビデンス