Connect your AI to Lucca API V5

What your AI can do with Lucca API V5

Once connected, these tools appear automatically in your AI assistant:

• list_employeesread-only

  List employees from the directory.

• get_employeeread-only

  Get one employee's details by id.

• list_departmentsread-only

  List the organization's departments.

• list_establishmentsread-only

  List the company's business establishments (sites).

• list_legal_entitiesread-only

  List the company's legal entities.

• list_personal_recordsread-only

  List the employees' personal records. Bank details (bankAccount) and national insurance numbers (insuranceNumber) are NEVER returned by this connector: the field is present but replaced by a notice. Everything else is returned — civil title, legal gender, birth date, nationality, personal phone and personal email.

• get_personal_recordread-only

  Get one employee's personal record. As with the list, bankAccount and insuranceNumber are never returned — do not report them as missing data, they are deliberately withheld.

• list_employmentsread-only

  List employment contracts, with their dates, working time and the job they attach to.

• get_employmentread-only

  Get one employment contract in full.

• list_employment_templatesread-only

  List the contract templates the company works from.

• get_employment_templateread-only

  Get one contract template.

• list_probationary_periodsread-only

  List probationary periods, with their end dates — what tells you whose trial period is about to close.

• get_probationary_periodread-only

  Get one probationary period.

• list_working_time_arrangementsread-only

  List the working-time arrangements — full time, part time, and the local variants a company defines.

• get_working_time_arrangementread-only

  Get one working-time arrangement.

• list_job_positionsread-only

  List the job positions — the posts people are appointed to.

• get_job_positionread-only

  Get one job position.

• list_professionsread-only

  List the professions the company recognises.

• get_professionread-only

  Get one profession.

• list_job_qualificationsread-only

  List the job qualifications — the classification levels a contract refers to.

• get_job_qualificationread-only

  Get one job qualification.

• list_occupation_categoriesread-only

  List the occupation categories — the socio-professional bands a payroll system depends on.

• get_occupation_categoryread-only

  Get one occupation category.

• get_legal_entityread-only

  Get one legal entity.

• get_establishmentread-only

  Get one business establishment.

• get_departmentread-only

  Get one department, with its place in the hierarchy.

• list_employee_attributesread-only

  List the values of the custom attributes carried by employees — the company's own fields.

• get_employee_attributeread-only

  Get one employee attribute value.

• list_employee_attribute_definitionsread-only

  List the definitions of those custom attributes — their names and types. Read this to know what the values mean.

• get_employee_attribute_definitionread-only

  Get one attribute definition.

• list_taxonomiesread-only

  List the taxonomies — the classification systems the company applies to its people and posts.

• get_taxonomyread-only

  Get one taxonomy.

• list_taxonomy_labelsread-only

  List the labels available inside the taxonomies.

• get_taxonomy_labelread-only

  Get one taxonomy label.

• create_departmentwrite · needs approval

  Create a department. The only creation this connector performs on Lucca.

• update_departmentwrite · needs approval

  Rename a department or move it under another one.

Example prompts

Just ask your AI in plain language — it picks the right Lucca API V5 tool:

• “List employees from the directory — from Lucca API V5, in plain language.”
• “Get one employee's details by id — from Lucca API V5, in plain language.”
• “List the organization's departments — from Lucca API V5, in plain language.”
• “List the company's business establishments (sites) — from Lucca API V5, in plain language.”

How it works

1. Create your Proxoria account and add your MCP endpoint to Claude or ChatGPT.
2. Connect Lucca API V5 with your API key — each user connects their own account, credentials encrypted at rest.
3. Your AI instantly gets the Lucca API V5 tools. Write actions wait for your approval in the dashboard before anything changes.

Frequently asked questions

Does Lucca API V5 have an official MCP server?

You don't need one. Proxoria exposes Lucca API V5 to your AI through the Model Context Protocol, so you can use it from Claude, ChatGPT, Mistral or any MCP-compatible client — no official Lucca API V5 MCP server required.

What can my AI do with Lucca API V5 through Proxoria?

It gets 36 tools: list_employees, get_employee, list_departments, list_establishments, list_legal_entities, list_personal_records, get_personal_record, list_employments, get_employment, list_employment_templates, get_employment_template, list_probationary_periods, get_probationary_period, list_working_time_arrangements, get_working_time_arrangement, list_job_positions, get_job_position, list_professions, get_profession, list_job_qualifications, get_job_qualification, list_occupation_categories, get_occupation_category, get_legal_entity, get_establishment, get_department, list_employee_attributes, get_employee_attribute, list_employee_attribute_definitions, get_employee_attribute_definition, list_taxonomies, get_taxonomy, list_taxonomy_labels, get_taxonomy_label, create_department, update_department. For example, list employees from the directory.

Is the Lucca API V5 connector read-only?

No — it can also make changes. Write actions go through Proxoria's confirmation guardrail by default: your AI proposes them, and you approve each one from your dashboard before anything is written to Lucca API V5.

How do I connect Lucca API V5 to my AI?

Create a Proxoria account, connect Lucca API V5 with your API key, and add your Proxoria MCP endpoint to Claude or ChatGPT. Your AI instantly gains the Lucca API V5 tools.