Aladtec MCP by usefulapi
Read schedules, open shifts, time off, time clock and payroll reports in Aladtec.
Should I use this
Quality & Safety
Findings (4)
- LOWin aladtec_list_position_qualifications
- LOWin aladtec_list_members_scheduled_now
- LOWin aladtec_list_time_clock_records
- LOWin aladtec_list_clocked_in_members
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"aladtec": {
"url": "https://aladtec.usefulapi.io/mcp"
}
}
}Remote endpoints
https://aladtec.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (24)
🟢aladtec_list_members(member_ids, include_inactive, attribute_ids, limit, offset)
List members with their Member Database attributes, sorted by last name. Attributes not enabled for the API return null. Read only.
Input Schema
{
"type": "object",
"properties": {
"member_ids": {
"description": "Member IDs to include. Leave out for all members.",
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"include_inactive": {
"description": "Include inactive members. Default false.",
"type": "boolean"
},
"attribute_ids": {
"description": "Custom attribute IDs to return.",
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"limit": {
"description": "Rows per page.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"offset": {
"description": "Rows to skip, for paging.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢aladtec_list_employee_types
List the employee types of the system, for example full time or part time. Read only.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢aladtec_list_custom_attributes
List the custom Member Database attribute definitions. Read only.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢aladtec_get_availability(range_start, range_stop)
Get the availability of members for a date and time range. Read only.
Input Schema
{
"type": "object",
"properties": {
"range_start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$",
"description": "Start of the range, YYYY-MM-DDTHH:MM in the system time zone."
},
"range_stop": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$",
"description": "End of the range, YYYY-MM-DDTHH:MM in the system time zone."
}
},
"required": [
"range_start",
"range_stop"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢aladtec_list_time_off(range_start, range_stop, statuses)
List time off requests in a range. Approved requests only, unless statuses includes pending. Read only.
Input Schema
{
"type": "object",
"properties": {
"range_start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$",
"description": "Start of the range, YYYY-MM-DDTHH:MM in the system time zone."
},
"range_stop": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$",
"description": "End of the range, YYYY-MM-DDTHH:MM in the system time zone."
},
"statuses": {
"description": "Request statuses to include.",
"type": "array",
"items": {
"type": "string",
"enum": [
"approved",
"pending"
]
}
}
},
"required": [
"range_start",
"range_stop"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢aladtec_list_schedules(include_archived)
List the schedules of the system, in the order set on the Setup page. Read only.
Input Schema
{
"type": "object",
"properties": {
"include_archived": {
"description": "Include archived schedules. Default false.",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢aladtec_list_position_qualifications(limit, offset)
List the unique position qualifications. Read only.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"description": "Rows per page.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"offset": {
"description": "Rows to skip, for paging.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢aladtec_list_scheduled_time(range_start, range_stop, schedule_ids, member_ids, position_ids, ...)
List scheduled time ranges for a period, with the member and position for each. Read only.
Input Schema
{
"type": "object",
"properties": {
"range_start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$",
"description": "Start of the range, YYYY-MM-DDTHH:MM in the system time zone."
},
"range_stop": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$",
"description": "End of the range, YYYY-MM-DDTHH:MM in the system time zone."
},
"schedule_ids": {
"description": "Schedule IDs to include. Leave out for all schedules.",
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"member_ids": {
"description": "Member IDs to include. Leave out for all members.",
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"position_ids": {
"description": "Position IDs to include.",
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"time_type_ids": {
"description": "Time type IDs to include.",
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"include_time_types": {
"description": "Include the time type of each range.",
"type": "boolean"
}
},
"required": [
"range_start",
"range_stop"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢aladtec_list_open_time(range_start, range_stop, schedule_ids, position_ids, include_only_shift_time)
List time ranges where no member is scheduled, for finding shifts that need cover. Up to one month per request. Read only.
Input Schema
{
"type": "object",
"properties": {
"range_start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$",
"description": "Start of the range, YYYY-MM-DDTHH:MM in the system time zone."
},
"range_stop": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$",
"description": "End of the range, YYYY-MM-DDTHH:MM in the system time zone."
},
"schedule_ids": {
"description": "Schedule IDs to include. Leave out for all schedules.",
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"position_ids": {
"description": "Position IDs to include.",
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"include_only_shift_time": {
"description": "Only return time inside shift boundaries.",
"type": "boolean"
}
},
"required": [
"range_start",
"range_stop"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢aladtec_list_members_scheduled_now(schedule_ids)
List each member scheduled at the time of the request, with the schedule and position. Read only.
Input Schema
{
"type": "object",
"properties": {
"schedule_ids": {
"description": "Schedule IDs to include. Leave out for all schedules.",
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢aladtec_list_schedule_notes(start_date, stop_date, schedule_ids)
List schedule notes by calendar date. Up to one year per request. Read only.
Input Schema
{
"type": "object",
"properties": {
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day, YYYY-MM-DD."
},
"stop_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day, YYYY-MM-DD."
},
"schedule_ids": {
"description": "Schedule IDs to include. Leave out for all schedules.",
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
}
},
"required": [
"start_date",
"stop_date"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢aladtec_list_extra_hours(range_start, range_stop, schedule_ids, member_ids, position_qualification_ids, ...)
List extra hours in a past period. Read only.
Input Schema
{
"type": "object",
"properties": {
"range_start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$",
"description": "Start of the range, YYYY-MM-DDTHH:MM in the system time zone."
},
"range_stop": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$",
"description": "End of the range, YYYY-MM-DDTHH:MM in the system time zone."
},
"schedule_ids": {
"description": "Schedule IDs to include. Leave out for all schedules.",
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"member_ids": {
"description": "Member IDs to include. Leave out for all members.",
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"position_qualification_ids": {
"description": "Position qualification IDs to include.",
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"time_type_ids": {
"description": "Time type IDs to include.",
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"statuses": {
"description": "Status names to include, as Aladtec defines them.",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"range_start",
"range_stop"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢aladtec_list_paycodes
List the active paycodes that can be applied to time clock time. Read only.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢aladtec_list_kiosks
List the active kiosks that members use to clock in and out. Read only.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢aladtec_list_time_clock_records(range_start, range_stop)
List time clock records in a range. Members still clocked in are left out. Read only.
Input Schema
{
"type": "object",
"properties": {
"range_start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$",
"description": "Start of the range, YYYY-MM-DDTHH:MM in the system time zone."
},
"range_stop": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$",
"description": "End of the range, YYYY-MM-DDTHH:MM in the system time zone."
}
},
"required": [
"range_start",
"range_stop"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢aladtec_list_clocked_in_members
List the members clocked in at the time of the request. Read only.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢aladtec_list_events(range_start, range_stop)
List events (title, description, location) in a date and time range. Read only.
Input Schema
{
"type": "object",
"properties": {
"range_start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$",
"description": "Start of the range, YYYY-MM-DDTHH:MM in the system time zone."
},
"range_stop": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$",
"description": "End of the range, YYYY-MM-DDTHH:MM in the system time zone."
}
},
"required": [
"range_start",
"range_stop"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢aladtec_list_shift_labels(start_date, stop_date)
List shift labels, such as A/B/C or Red/Gold/Black, for a date range. Read only.
Input Schema
{
"type": "object",
"properties": {
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day, YYYY-MM-DD."
},
"stop_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day, YYYY-MM-DD."
}
},
"required": [
"start_date",
"stop_date"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢aladtec_list_work_groups
List all work groups, which hold the scheduling and overtime rules for members. Read only.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢aladtec_list_time_types(limit, offset)
List the unique time types that can be applied to scheduled time. Read only.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"description": "Rows per page.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"offset": {
"description": "Rows to skip, for paging.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢aladtec_list_accrual_banks
List all time off accrual banks. Read only.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢aladtec_get_accrual_balances(member_ids, accrual_bank_ids)
Get the hours in each accrual bank for a list of members. Read only.
Input Schema
{
"type": "object",
"properties": {
"member_ids": {
"minItems": 1,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"description": "Member IDs to read."
},
"accrual_bank_ids": {
"minItems": 1,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"description": "Accrual bank IDs to read."
}
},
"required": [
"member_ids",
"accrual_bank_ids"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢aladtec_get_configuration
Get the configuration settings of the system. Read only.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢aladtec_get_payroll_report(range_start, range_stop, member_ids, time_categories, next_token)
Run the payroll report export for a range. Pass next_token from the previous reply to get the next page. Read only.
Input Schema
{
"type": "object",
"properties": {
"range_start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$",
"description": "Start of the range, YYYY-MM-DDTHH:MM in the system time zone."
},
"range_stop": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$",
"description": "End of the range, YYYY-MM-DDTHH:MM in the system time zone."
},
"member_ids": {
"description": "Member IDs to include. Leave out for all members.",
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"time_categories": {
"description": "Payroll categories to include.",
"type": "array",
"items": {
"type": "string",
"enum": [
"time_worked",
"time_off",
"overtime",
"holiday"
]
}
},
"next_token": {
"description": "Pagination token from the previous reply.",
"type": "string"
}
},
"required": [
"range_start",
"range_stop"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence