Overview

This tool pack gives an agent access to Lucca's HR suite, covering people, absences, timesheets, expenses, and variable pay, through two parallel tool sets: a Legacy v3 API set (broader, including timesheets and user creation) and a newer Latest API set (cleaner pagination, same people and absence reads). Choose one set per deployment to match the API your Lucca tenant exposes.

For setup instructions, see SnapLogic MCP Server quickstart.

Example Prompts

• Approve leave request 789
• Reject leave request 812 with the comment 'clashes with the release week'
• Approve that holiday request and add a note saying enjoy your break
• Sign off on leave request 456 for me
• Approve leave request 789 in Lucca
• Decline leave request 812 and explain that cover is unavailable
• Approve this time-off request with a thumbs-up comment
• Record my decision to approve request 456
• Submit an expense claim called 'Client lunch - Paris' for item 4521
• Create a claim for my Paris travel expense line

Tools

Set up the MCP Server tools

1. Download lucca_tools.zip.
2. In SnapLogic Designer, open the target project space (or create one), then choose Import Project / Import Pipelines and select the downloaded lucca_tools.zip. Designer unpacks each pipeline into the project.
3. Attach the required account to the connectivity snaps (see Connection Setup).
4. Expose the project as an MCP server — each pipeline becomes a tool named after its label. New to this? Start with the MCP quickstart, then use the MCP Server Pipeline Builder to generate the server from the imported pipelines.

Configure account

Attach an API Suite account (OAuth 2.0 or Bearer token) to the HTTP Client snap in Designer after import.

These pipelines ship without credentials by design — attach a valid account in Designer before the tools will execute.

See the SnapLogic account documentation for this connector: API Suite Account Configuration.

LuccaApproveLeaveRequest

Approves or rejects a leave request with an optional comment, defaulting to approve unless the caller explicitly passes false. Use LuccaApproveLeaveRequestV2 for the same action on the newer Latest API.

* Required parameter.

Try asking:

• Approve leave request 789
• Reject leave request 812 with the comment 'clashes with the release week'
• Approve that holiday request and add a note saying enjoy your break
• Sign off on leave request 456 for me

LuccaApproveLeaveRequestV2

Approves or rejects a leave request on the Lucca Latest API, with the same approve-by-default behavior and optional comment as LuccaApproveLeaveRequest. Use this version when your Lucca tenant is on the Latest API.

* Required parameter.

Try asking:

• Approve leave request 789 in Lucca
• Decline leave request 812 and explain that cover is unavailable
• Approve this time-off request with a thumbs-up comment
• Record my decision to approve request 456

LuccaCreateExpenseClaim

Creates an expense claim in Lucca by combining a title with an existing temporary expense item id, submitting the draft line as a formal claim. This is a Legacy v3 API tool; attach exactly one expense item per call.

* Required parameter.

Try asking:

• Submit an expense claim called 'Client lunch - Paris' for item 4521
• Create a claim for my Paris travel expense line
• Raise an expense claim titled 'October conference' from temp item 8890
• Turn expense item 4521 into a submitted claim

LuccaCreateTimeEntry

Logs a time entry for an employee with a start timestamp, optional end time, activity category, and comment. Use it to record work that has not yet been entered, typically after reviewing existing entries with LuccaListTimeEntries.

* Required parameter.

Try asking:

• Log 9am to 5pm on 12 May for employee 123
• Record eight hours of project work for user 88 yesterday against axis section 42
• Book my Tuesday to the client project with the comment 'onsite workshop'
• Create a time entry starting 2026-05-12T09:00:00 for employee 123

LuccaCreateUser

Creates a new employee record in Lucca with identity and contract details, optionally placing them in a legal entity, department, and role. Use it to complete a new-hire setup end to end, after resolving the department id with LuccaListDepartments.

* Required parameter.

Try asking:

• Create a Lucca user for Marie Dupont, login mdupont, email [email protected], starting 1 July
• Onboard a new hire in department 5 under legal entity 1 starting next Monday
• Add Thomas Bernard to Lucca with a contract start of 2026-09-01
• Set up a Lucca account for our new engineer and put them in the Engineering department

LuccaGetLeaveBalance

Retrieves individual leave records for an employee over a date window, showing what was taken or booked within a period by account and day. Use LuccaGetLeaveBalanceV2 for the same information on the newer Latest API.

Try asking:

• How much leave has employee 123 taken since January?
• Show me the leave records for user 88 this year
• What's booked against leave account 4 for employee 123?
• List every half-day of absence for user 210 since 2026-01-01

LuccaGetLeaveBalanceV2

Lists an employee's leave accounts on the Lucca Latest API, returning the accounts themselves rather than individual dated leave lines. Use the Legacy LuccaGetLeaveBalance when you need dated leave detail; use this when you just want to see which accounts an employee has.

Try asking:

• What leave accounts does employee 123 have?
• Show me the leave account balances for user 88
• List the leave accounts in Lucca, 50 per page
• Fetch page 2 of the leave accounts for employee 210

LuccaGetUser

Retrieves the full profile of a Lucca employee by id, including reporting line, legal entity, and contract dates. Use LuccaGetUserV2 for the same lookup on the newer Latest API.

* Required parameter.

Try asking:

• Show me the Lucca profile for user 123
• Who is employee 4521's manager?
• What is the contract start date for user 88?
• Which legal entity does Lucca user 210 belong to?

LuccaGetUserV2

Retrieves a single employee record on the Lucca Latest API, returning the fields the versioned endpoint provides. Use the Legacy LuccaGetUser when you specifically need manager, legal entity, or contract date fields.

* Required parameter.

Try asking:

• Pull the employee record for id 123 from Lucca
• Get details on Lucca employee 4521
• Show me the full record for employee 88

LuccaListDepartments

Lists Lucca departments with their ids and hierarchy, letting you resolve a department name to the id other tools expect. Filter by parent id to walk one level of the org tree at a time.

Try asking:

• List all departments in Lucca
• What are the sub-departments under department 3?
• Find the department id for Engineering
• Show me the org hierarchy from Lucca

LuccaListDepartmentsV2

Pages through the Lucca department list on the Latest API without parent-id filtering, returning the full department page. Use it when your tenant is on the Latest API; use LuccaListDepartments for the Legacy version, which supports parent-id filtering.

Try asking:

• List the departments in Lucca
• Give me the first 50 departments
• Fetch page 2 of the department list
• What departments exist in our Lucca tenant?

LuccaListExpenseClaims

Lists Lucca expense claims, filterable by employee, status, and declaration date, so you can answer spend and approval-queue questions. This is a Legacy v3 API tool with no Latest API equivalent.

Try asking:

• Show me the approved expense claims for employee 123
• What expense claims are still awaiting approval?
• List all claims declared this quarter with their totals
• How much has user 88 claimed, and in what currency?

LuccaListLeaveRequests

Lists leave requests in Lucca, filterable by employee and numeric status code, covering absence queues and history questions. Use LuccaListLeaveRequestsV2 for the same listing on the Latest API, where statuses are named strings.

Try asking:

• Show me all pending leave requests
• What leave has employee 123 booked?
• List the leave requests waiting for approval
• How many days is each open leave request in the queue?
• Give me the last 50 leave requests

LuccaListLeaveRequestsV2

Lists leave requests on the Lucca Latest API, filtered by employee and named status (such as 'pending'), with page-based pagination. Use the Legacy LuccaListLeaveRequests when you need numeric status codes or a total count.

Try asking:

• List the pending leave requests in Lucca
• What leave requests does employee 123 have?
• Show me approved leave, 100 per page
• Fetch page 2 of the leave request list

LuccaListTimeEntries

Lists logged time entries for an employee over a date window, showing hours, activity, and comments for each entry. Use it to answer timesheet questions such as what someone logged last week or how a period was filled.

Try asking:

• What did employee 123 log in May?
• Show me this week's time entries for user 88
• How many hours did user 123 book between 1 and 31 May?
• List the timesheet entries with their activity and comments for last month

LuccaListVariableComp

Retrieves variable compensation items (bonuses, commissions, and similar pay elements) for one or more employees, returned newest period first. Use it for questions about someone's variable pay history or the latest bonus round.

Try asking:

• What variable compensation has employee 123 received?
• Show me the most recent bonus items for user 88
• List commission payments for this employee, 50 at a time
• Pull the latest variable pay items across the team

LuccaSearchUsers

Finds Lucca employees by email fragment, login, department, or employment status, returning a list of matching people with their ids. Use it to resolve a person's name to an id before calling the leave, timesheet, or expense tools.

Try asking:

• Find the employee whose email contains dupont
• Look up the Lucca user with login mdupont
• List everyone in department 5
• Show me former employees still on record in Lucca
• Give me the first 20 people whose email mentions martin

LuccaSearchUsersV2

Searches Lucca employees by email and department on the Latest API, using exact email matching and page-based pagination. Use the Legacy LuccaSearchUsers for richer filtering by login or employment status.

Try asking:

• Search Lucca for employees with the email dupont
• Who is in department 12?
• Get me page 2 of the employee list, 50 per page
• Find the employee record for [email protected]