MCP tools
Every tool the HR system's MCP server offers, grouped by what it does, with the scope each one needs. Reading, acting for yourself, deciding and sensitive data.
The MCP server is at https://<your company address>/mcp. Assistant access explains how to connect and what each scope allows. Every call goes through the same permission checks as the app and is written to the audit log.
Dates are YYYY-MM-DD. Amounts of leave are in hours; day-based leave types show days too. Text that people typed, such as a leave note or a pay request, is returned as data and marked as such, so an assistant doesn’t treat it as an instruction.
Reading
Section titled “Reading”| Tool | Scope | What it does |
|---|---|---|
getGuide |
read | The operating guide for assistants, by topic. Read it before making a change |
getMyBalances |
read | Your leave balances and the leave types you can book, optionally as of a date |
listMyRequests |
read | Your leave requests, newest first, filtered by status or year |
previewLeave |
read | The working days and hours a booking would use. Changes nothing |
whoIsOff |
read | Approved and pending leave in a date range, for the people you can see |
getTeamCalendar |
read | Who is off on each day in a range. HR can filter by department |
listPendingApprovals |
read | Leave requests waiting for your decision |
findPerson |
read | People by name, job, department, location or email, with directory fields only |
getOrgChart |
read | A person’s manager and direct reports. HR also gets the chain of managers |
listUpcomingChanges |
read | HR only: probation, trial period and contract ends, and dated job and status changes |
getLeavePolicies |
read | The leave policies that apply to you. HR gets all of them |
getHolidays |
read | Public holidays for a year |
Acting for yourself
Section titled “Acting for yourself”| Tool | Scope | What it does |
|---|---|---|
bookLeave |
self | Book leave. The request goes to your manager and stays pending until they decide |
cancelLeave |
self | Cancel a pending request, or an approved one that hasn’t started |
updateMyContactDetails |
self | Change your own contact details |
The assistant tells you what it’s about to do and gets your agreement before calling these.
Deciding
Section titled “Deciding”| Tool | Scope | What it does |
|---|---|---|
prepareLeaveDecision |
decide | Step 1: checks an approval or denial and returns the request with a one-time token. Changes nothing |
confirmLeaveDecision |
decide | Step 2: carries out the decision, only after you agree in the chat |
Sensitive data
Section titled “Sensitive data”| Tool | Scope | What it does |
|---|---|---|
getSensitiveDetails |
sensitive | HR only: one person’s ID, bank, tax and health details |
getPayHistory |
sensitive | HR only: one person’s pay history |
listPayInfoRequests |
sensitive | HR only: requests for pay information under Article 7 |
getPayGapSummary |
sensitive | HR only: the mean and median gaps, quartiles and gap per grade for the reporting year |
Done in the app
Section titled “Done in the app”terminateEmployee, changePay, deleteEmployee and changeAccess change nothing. Each returns the steps and a link to the screen where HR does it.