Lucca MCP Server
for AI Agents
Connect your AI agent to StackOne's Lucca MCP server and give it 256 MCP tools out of the box. Auth, tool execution, and security all managed.
Coverage
256 Agent Actions
Extend your agent's capabilities with custom actions.
Authentication
Agent Tool Authentication
Per-user OAuth in one call. Your Lucca MCP server gets session-scoped tokens with zero credentials stored on your infra.
Agent Auth →Security
Agent Protection
Every Lucca tool response scanned for prompt injection in milliseconds, with 88.7% accuracy, all running on CPU.
Prompt Injection Defense →Performance
Max Agent Context. Min Cost.
Free up to 96% of your agent's context window to enhance reasoning and reduce cost, on every Lucca call.
Tools Discovery →What is the Lucca MCP Server?
A Lucca MCP server lets AI agents work with Lucca data through the Model Context Protocol, Anthropic's open standard for connecting LLMs to external tools. StackOne's Lucca MCP server ships with 256 pre-built actions, fully extensible via the Connector Builder, plus managed authentication, prompt injection defense, observability, and agent execution runtime. Connect it from MCP clients like Claude Desktop, Claude Code, Cursor, Goose, and VS Code, or from agent frameworks like OpenAI Agents SDK, LangChain, and Vercel AI SDK.
All Lucca MCP Tools
Every StackOne action for Lucca, ready for your agent. Scoped to exactly what you need.
Leaves
- Import Leaves
Create leaves in batch from an uploaded CSV file.
- List Leaves
List approved leaves for a set of employees over a date range.
A Variable Items
- Create A Variable Item
Create a variable remuneration item on an employee work contract.
- Get A Variable Item
Retrieve a single variable remuneration item by ID.
- Update A Variable Item
Update an existing variable remuneration item.
- Delete A Variable Item
Delete a variable remuneration item.
A Fixed Items
- Create A Fixed Item
Create a fixed remuneration item on an employee work contract.
- Update A Fixed Item
Replace the data of an existing fixed remuneration item.
- Delete A Fixed Item
Delete a fixed remuneration item.
An Employee-attribute-definitions
- Create An Employee-attribute-definition
Create a new custom employee attribute definition.
- Retrieve An Employee-attribute-definition
Retrieve a single employee-attribute-definition by ID.
- Update An Employee-attribute-definition
Partially update a custom employee attribute definition.
- Delete An Employee-attribute-definition
Archive a custom employee attribute definition.
An Employee-attributes
- Create An Employee-attribute
Set a custom attribute value for an employee.
- Retrieve An Employee-attribute
Retrieve a single employee-attribute by ID.
- Update An Employee-attribute
Partially update an employee-attribute.
A User (legacy V3)s
- Retrieve A User (legacy V3)
Retrieve a single user by ID from the legacy Lucca Directory v3 API.
- Update A User (legacy V3)
Update a user by ID in the legacy Lucca Directory v3 API.
A Work Contracts
- Create A Work Contract
Create a work contract for an existing employee in the legacy Lucca Directory v4 API.
- Retrieve A Work Contract
Retrieve a single work contract by ID from the legacy Lucca Directory v4 API.
- Update A Work Contract
Partially update a work contract by ID in the legacy Lucca Directory v4 API.
- Delete A Work Contract
Delete a work contract by ID in the legacy Lucca Directory v4 API.
An Employees
- Create An Employee
Create a new employee with their first employment and first job position.
- Retrieve An Employee
Retrieve a single employee.
- Update An Employee
Partially update an existing employee.
An Employee-personal-records
- Retrieve An Employee-personal-record
Retrieve an employee-personal-record.
- Update An Employee-personal-record
Partially update an employee-personal-record.
An Employments
- Create An Employment
Create a new employment, with its first job position, for an existing employee.
- Retrieve An Employment
Retrieve an employment by its ID.
- Update An Employment
Partially update an existing employment.
- Delete An Employment
Delete an employment and all its job positions.
A Job-positions
- Create A Job-position
Create a new job position within an employee employment.
- Retrieve A Job-position
Retrieve a job-position by its ID.
- Update A Job-position
Partially update an existing job position.
- Delete A Job-position
Delete a job position.
A Probationary-periods
- Create A Probationary-period
Create a probationary period for an employment.
- Retrieve A Probationary-period
Retrieve a probationary-period by its ID.
- Update A Probationary-period
Partially update a probationary period.
- Delete A Probationary-period
Delete a probationary period.
A Temporary Expenses
- Create A Temporary Expense
Create a temporary expense for an employee.
- Get A Temporary Expense
Retrieve a temporary expense by ID.
- Update A Temporary Expense
Update a temporary expense by ID.
Expense Claims
- Create Expense Claims
Declare one or more expense claims from temporary expenses.
- List Expense Claims
List declared expense claims.
A Files
- Upload A File
Upload a file in order to reference it as the attachment of another resource (e.g. a portrait).
- Retrieve A File
Retrieve a file, either its JSON representation or its content.
User Locations
- Import User Locations
Create, replace or delete user locations in batch from an uploaded CSV file.
- List User Locations
List where employees work on given days.
A Departments
- Create A Department
Create a new department.
- Retrieve A Department
Retrieve a single department by ID.
- Update A Department
Update a department.
An Axis Sections
- Create An Axis Section
Create an axis section (analytical code) under an axis in the legacy Lucca v3 API.
- Retrieve An Axis Section
Retrieve a single axis section by ID from the legacy Lucca v3 API.
- Update An Axis Section
Update an axis section by ID in the legacy Lucca v3 API.
- Delete An Axis Section
Delete an axis section by ID in the legacy Lucca v3 API.
Purchases
- Create Purchase
Create a new purchase in Lucca Cleemy Procurement.
- List Purchases
List purchases in Lucca Cleemy Procurement.
- Get Purchase
Retrieve a purchase by its ID.
Cost-centers
- Create Cost-center
Create a new cost-center.
- Import Cost-centers
Bulk import a list of cost-centers.
- List Cost-centers
List cost-centers in Lucca Cleemy Procurement.
- Get Cost-center
Retrieve a cost-center by its ID.
- Update Cost-center
Update a cost-center.
Suppliers
- Create Supplier
Create a new supplier.
- List Suppliers
List suppliers in Lucca Cleemy Procurement.
- Get Supplier
Retrieve a supplier by its ID.
- Update Supplier
Update a supplier.
Natures
- Create Nature
Create a new purchase nature.
- List Natures
List purchase natures (categories).
- Get Nature
Retrieve a nature by its ID.
- Update Nature
Update a purchase nature.
Invoices
- Get Invoice
Retrieve an invoice by its ID.
- Update Invoice
Update the editable fields of an invoice.
Inbox Documents
- List Inbox Documents
List documents waiting to be processed in the inbox.
- Update Inbox Document
Update an inbox document and optionally attach or create a purchase.
Documents
- Get Document
Retrieve a document by its ID.
- Update Document
Update a document's information before booking it.
- Delete Document
Delete a document.
A Clients
- Create A Client
Create a new Lucca Project client in an organization.
- Get A Client
Retrieve a single Lucca Project client by its ID.
- Update A Client
Update a Lucca Project client by its ID.
- Delete A Client
Permanently delete a Lucca Project client by its ID.
A Projects
- Create A Project
Create a new Lucca Project project for a client.
- Get A Project
Retrieve a single Lucca Project project by its ID.
- Update A Project
Update a Lucca Project project by its ID.
- Delete A Project
Delete a draft Lucca Project project by its ID.
A Work Cycle Exceptions
- Get A Work Cycle Exception
Get a single work cycle exception by ID.
- Delete A Work Cycle Exception
Soft-delete a work cycle exception by ID.
A Working Time Arrangements
- Create A Working Time Arrangement
Create a working time arrangement through the legacy schedule API.
- Update A Working Time Arrangement
Replace the properties of a working time arrangement through the legacy schedule API.
- Delete A Working Time Arrangement
Permanently delete a working time arrangement by ID.
A Collective Schedules
- Create A Collective Schedule
Add a weekly working pattern to a working time arrangement.
- Get A Collective Schedule
Get one collective schedule of a working time arrangement by ID.
- Update A Collective Schedule
Replace the weekly working pattern of a collective schedule.
- Delete A Collective Schedule
Delete a collective schedule from a working time arrangement.
A Taxonomys
- Create A Taxonomy
Create a new taxonomy.
- Retrieve A Taxonomy
Retrieve a taxonomy by its ID.
- Update A Taxonomy
Partially update a taxonomy.
- Delete A Taxonomy
Delete a taxonomy and all its labels.
A Taxonomy-labels
- Create A Taxonomy-label
Create a new value in a taxonomy.
- Retrieve A Taxonomy-label
Retrieve a taxonomy-label by its ID.
- Update A Taxonomy-label
Partially update a taxonomy-label.
- Delete A Taxonomy-label
Permanently delete a taxonomy-label.
Time Entries
- Create Time Entries
Create one or more time entries, possibly for several owners.
- List Time Entries
List time entries (worked hours) matching the given filters.
Multiple Time Entries
- Update Multiple Time Entries
Update one or more existing time entries, possibly for several owners.
- Delete Multiple Time Entries
Delete one or more time entries by ID.
A Time Entrys
- Get A Time Entry
Retrieve a single time entry by its ID.
- Update A Time Entry
Update the fields of a single time entry by its ID.
- Delete A Time Entry
Delete a single time entry by its ID.
A Time Punchs
- Create A Time Punch
Record a clock-in or clock-out for an employee.
- Get A Time Punch
Retrieve a single time punch by its ID, archived or not.
A Trainings
- Create A Training
Create a training in the training catalogue.
- Get A Training
Retrieve a training by ID.
A Realized Trainings
- Create A Realized Training
Record a completed training for an employee.
- Get A Realized Training
Retrieve a realized training by ID.
- Delete A Realized Training
Delete a realized training by ID.
A Webhook-endpoints
- Create A Webhook-endpoint
Create a new webhook-endpoint.
- Retrieve A Webhook-endpoint
Retrieves a single webhook-endpoint resource.
- Update A Webhook-endpoint
Update an existing webhook-endpoint.
- Delete A Webhook-endpoint
Delete an existing webhook-endpoint.
Other (135)
- Import Leave Entitlements
Credit leave accounts by adding the values in an uploaded file to existing balances.
- Create A User (legacy V3, API Key)
Create a new employee (user) in Lucca through the legacy v3 API, with role IDs, using API Key authentication.
- Create An Expense Accounting Export
Create an accounting export and return its entry lines.
- Upload A File (legacy)
Upload a file to Lucca Files through the legacy API to reference it from another resource.
- Create Purchase Commitment
Create a commitment on an existing purchase.
- Create Commitment Request
Submit a purchase commitment for approval.
- Create A Project Service
Add a new service (work item) to a Lucca Project project.
- Create A Job Application
Create a candidate application for a job opportunity in Lucca Recruitment.
- Create Or Update A Work Cycle Exception
Create a work cycle exception, or update the existing one on the same employee half-day.
- Create A Timesheet Report
Start generating a timesheet report from a report template.
- Retrieve A Leave
Retrieve a single approved leave by its ID.
- List Leave Requests
List leave requests with their status and approval history.
- Retrieve A Leave Request
Retrieve a single leave request by its ID.
- Retrieve Leaves Import Progress
Retrieve the progress of an asynchronous leaves import.
- List Sick Leave Certificates
List sick leave certificates holding extra legal details for certain leaves.
- Retrieve A Sick Leave Certificate
Retrieve a single sick leave certificate by its ID.
- List Fixed Natures
List the fixed remuneration natures configured in Lucca Compensation.
- Get A Fixed Nature
Retrieve a single fixed remuneration nature by ID.
- List Fixed Nature Categories
List the categories of fixed remuneration natures.
- List Variable Items
List variable remuneration items (bonuses, commissions) matching a set of filters.
- List Variable Natures
List the variable remuneration natures configured in Lucca Compensation.
- Get A Variable Nature
Retrieve a single variable remuneration nature by ID.
- List Variable Nature Categories
List the categories of variable remuneration natures.
- List Fixed Items
List fixed remuneration items (e.g. base salary) matching a set of filters.
- List Employee-attribute-definitions
Returns a paginated list of employee-attribute-definitions.
- List Employee-attributes
Returns a paginated list of employee-attributes.
- List Professions
List professions.
- Retrieve A Profession
Retrieve a profession by its ID.
- List Job-qualifications
Returns a paginated list of job-qualifications.
- Retrieve A Job-qualification
Retrieve a job-qualification by its ID.
- List Occupation-categories
Returns a paginated list of occupation-categories.
- Retrieve An Occupation-category
Retrieve an occupation-category.
- List Users (legacy V3)
List users (employees) from the legacy Lucca Directory v3 API.
- List Work Contracts
List employee work contracts from the legacy Lucca Directory v4 API.
- List Employees
Returns a paginated list of employees.
- List Employee-personal-records
Retrieve a paginated list of employee-personal-records.
- List Employments
Returns a paginated list of employments.
- List Employment-templates
Retrieve a paginated list of employment-templates.
- Retrieve An Employment-template
Retrieve an employment-template by its ID.
- List Job-positions
Retrieve a paginated list of job-positions.
- List Probationary-periods
List probationary-periods.
- List Temporary Expenses
List temporary (not yet declared) expenses.
- List Expense Claim Items
List expenses already declared in an expense claim.
- Get An Expense Claim Item
Retrieve a declared expense claim item by ID.
- List Meal Voucher Statutories
List meal voucher statutories (application settings).
- Get A Meal Voucher Statutory
Retrieve a meal voucher statutory by ID.
- Get Statutory General Parameters
Retrieve the general parameters of a meal voucher statutory.
- List Statutory Distributions
List the meal voucher distributions of a statutory.
- Get Meal Voucher Computation Details
Retrieve the per-employee meal voucher counts of a computation.
- Retrieve A User Location
Retrieve a single user location by its ID.
- List Work Locations
List the work locations employees can work from.
- Retrieve A Work Location
Retrieve a single work location by its ID.
- Retrieve User Locations Import Progress
Retrieve the progress of a user locations import.
- Retrieve User Locations Import Analysis
Retrieve the dry-run analysis of a simulated user locations import.
- Retrieve User Locations Import Results
Retrieve the results of a user locations import.
- List Departments
Returns a paginated list of departments.
- List Legal-entities
Returns a paginated list of legal-entities.
- Retrieve A Legal-entity
Retrieve a legal-entity.
- List Business-establishments
List business-establishments.
- Retrieve A Business-establishment
Retrieve a business-establishment.
- List Legal Units (legacy V4)
List legal units from the legacy Lucca Organization Structure v4 API.
- List Establishments (legacy V4)
List establishments from the legacy Lucca Organization Structure v4 API.
- List Departments (legacy V4)
List departments from the legacy Lucca Organization Structure v4 API.
- Retrieve A Department (legacy V4)
Retrieve a single department by ID from the legacy Lucca Organization Structure v4 API.
- List Axes
List analytical axes that group axis sections in the legacy Lucca v3 API.
- List Axis Sections
List axis sections (analytical codes) in the legacy Lucca v3 API.
- List VAT Rates
List the VAT rates applicable on a given date in a territory.
- List Invoice Confirmations
List the confirmations (approvals) of an invoice.
- List Booked Documents
List booked documents (invoices and credit notes).
- List Clients
List the Lucca Project clients of an organization.
- List Projects
List the Lucca Project projects of an organization.
- List Project Services
List the services (work items) of a Lucca Project project.
- List Project Organizations
List the Lucca Project organizations.
- List Project Financials
List financial metrics for the Lucca Project projects of an organization.
- List Active Job Offers
List a company's currently open job offers from the public Lucca Recruitment XML feed.
- List Work Cycle Exceptions
List work cycle exceptions that override an employee's planned hours on a half-day.
- List Shift Overrides
List one-time overrides of employees' regular work schedules.
- List User Dates
List the computed daily theoretical working hours of employees over a period.
- List Working Time Arrangements (legacy Schedule API)
List working time arrangements through the legacy schedule API.
- Get A Working Time Arrangement (legacy Schedule API)
Get a working time arrangement by ID through the legacy schedule API.
- List Collective Schedules
List the collective schedules (weekly working patterns) of a working time arrangement.
- List Employee Assignments
List assignments of working time arrangements to employees over time.
- List Taxonomies
Returns a paginated list of taxonomies.
- List Taxonomy-labels
Returns a paginated list of taxonomy-labels.
- List Timesheets
List timesheets matching owner, date and status filters.
- List Due Timesheets
List timesheets that are not yet submitted.
- Download A Timesheet Report As CSV
Download the content of a generated timesheet report as a CSV file.
- Download A Timesheet Report As Excel
Download the content of a generated timesheet report as an Excel file.
- List Time Punches
List clock-ins and clock-outs, archived ones included.
- List Trainings
List trainings in the training catalogue.
- List Realized Trainings
List realized (completed) trainings.
- List Training Demands
List training demands (training requests per employee).
- List Training Providers
List training providers.
- List Training Categories
List training categories.
- List Webhook-endpoints
Returns a paginated list of webhook-endpoints.
- List Webhook-deliveries
Returns a paginated list of webhook-deliveries.
- Retrieve A Webhook-delivery
Retrieve a webhook-delivery.
- List Webhook-delivery-attempts
Retrieve a paginated list of webhook-delivery-attempts.
- Retrieve A Webhook-delivery-attempt
Retrieve a webhook-delivery-attempt.
- List Events
Returns a paginated list of webhook events.
- Retrieve An Event
Retrieve a single webhook event.
- List Working-time-arrangements
Returns a paginated list of working-time-arrangements.
- Retrieve A Working-time-arrangement
Retrieve a single working-time-arrangement.
- Cancel A Leave
Cancel a single approved leave by its ID.
- Cancel A Leave Request
Request cancellation of a leave request by its ID.
- Approve Or Deny A Leave Request
Approve or deny a pending leave request.
- Replace Leave Entitlements
Adjust leave accounts so their entitlement totals match the values in an uploaded file.
- Replace An Employee-attribute-definition
Replace a custom employee attribute definition as a whole.
- Replace An Employee-attribute
Replace the value of an employee-attribute as a whole.
- Cancel Commitment Request
Cancel a pending commitment request.
- Close Purchase
Close a purchase.
- Confirm Invoice
Confirm (approve) an invoice.
- Book Inbox Document
Book (validate) a document from the inbox.
- Replace Shift Overrides For An Employee
Replace all shift overrides of one employee within a date range.
- Archive A Working Time Arrangement
Archive a working time arrangement so it is no longer given to employees.
- Unarchive A Working Time Arrangement
Restore an archived working time arrangement.
- Duplicate A Working Time Arrangement
Create a copy of an existing working time arrangement.
- Assign A Working Time Arrangement To An Employee
Assign a new working time arrangement to an employee from a start date.
- Replace A Taxonomy
Replace a taxonomy as a whole.
- Replace A Taxonomy-label
Replace a taxonomy-label as a whole.
- Remind Timesheets
Email users a reminder to submit their due timesheets.
- Submit Timesheets (v3)
Submit timesheets for approval through the v3 workflow service.
- Cancel Timesheets (v3)
Cancel submitted timesheets by ID through the v3 workflow service.
- Approve Timesheets (v3)
Approve pending timesheets by ID through the v3 workflow service.
- Deny Timesheets (v3)
Deny pending timesheets by ID with a mandatory comment.
- Invalidate Timesheets (v3)
Reject approved timesheets by ID with a mandatory comment.
- Submit Timesheets
Submit all of an owner's timesheets up to a given period.
- Approve A Timesheet
Approve a pending timesheet and any earlier pending ones of the same owner.
- Cancel A Timesheet
Cancel a pending timesheet and any later pending ones of the same owner.
- Deny A Timesheet
Deny a pending timesheet with a mandatory comment.
- Invalidate A Timesheet
Reject an approved timesheet with a mandatory comment.
- Approve Timesheets
Approve several pending timesheets by ID in one call.
- Replace Time Entries For A Period
Replace an owner's time entries over a period with the ones provided.
- Archive Or Restore A Time Punch
Archive a time punch sent by mistake, or restore an archived one.
- Trigger A Test Delivery
Triggers a test delivery to a webhook endpoint to verify it is configured correctly.
Lucca AI Agent Use Cases
Connect your AI agent to Lucca and help your team scale the HR operations they run by hand today.
Use StackOne to connect your AI agent to your HRIS, identity management, and LMS to automate employee onboarding.
ViewUse StackOne to connect your AI agent to your HRIS, knowledge base, and messaging tools to automate HR policy Q&A.
ViewUse StackOne to connect your AI agent to your HRIS, identity management, and ITSM to automate employee offboarding and deprovisioning.
ViewSet Up Your Lucca MCP Server in Minutes
One endpoint. Any framework. Your agent is talking to Lucca in under 10 lines of code.
Agent Frameworks
{
"mcpServers": {
"stackone": {
"command": "npx",
"args": [
"-y",
"mcp-remote@latest",
"https://api.stackone.com/mcp?x-account-id=<account_id>",
"--header",
"Authorization: Basic <YOUR_BASE64_TOKEN>"
]
}
}
}Check More HRIS / HCM MCP Servers
163+ actions
162+ actions
129+ actions
127+ actions
120+ actions
120+ actions
117+ actions
Platform Resources
Comparing BM25, TF-IDF, and Hybrid Search for MCP Tool Discovery
Benchmarking BM25, TF-IDF, and hybrid search for MCP tool discovery across 916 tools. The 80/20 TF-IDF/BM25 hybrid hits 21% Top-1 accuracy in under 1ms.
10 min
Indirect Prompt Injection Defense for MCP Tools: A Technical Guide
MCP tools that read emails, CRM records, and tickets are indirect prompt injection vectors. Here's how we built a two-tier defense that scans tool results in ~11ms.
12 min
MCP vs A2A: Architecture, Security, and When to Use Each
MCP vs A2A: what each protocol standardizes, how they differ, the security risks they share, and when to use one, both or a hybrid.
12 min
MCP vs API: What Hundreds of Connector Builds Taught Us
MCP wraps APIs, it doesn't replace them. After building hundreds of connectors that serve both, here's when each approach wins.
14 min read
Lucca MCP Server FAQ
Does StackOne have a Lucca MCP server?
Lucca MCP server vs direct API integration: what's the difference?
How does Lucca authentication work for AI agents?
origin_owner_id.Are Lucca MCP tools vulnerable to prompt injection?
What is the context bloat of a Lucca agent and how do I avoid it?
Can I limit which actions my Lucca agent can access?
Can I create custom agent actions for my Lucca MCP server?
When should I NOT use a Lucca MCP server?
What AI frameworks and AI clients does the StackOne Lucca MCP server support?
Put your AI agents to work
Connect AI to every company system and control what it can do in each one, down to the field.