Use in ToolGate

In the ToolGate console, open Server packages, then Marketplace, and install this package. These values identify exactly what you install:

{
    "marketplace": "olo-labs-marketplace",
    "packageId": "examples.hr",
    "version": "0.1.0",
    "packageDigest": "sha256:50473fd7dd8eb58b7e57395b6cadd038724df76f19118c44cb2a72f687261901"
}

Overview

HR helpdesk (mocked)

Tools: hr.employee, hr.policy, hr.my-leave, hr.request-leave. Part of the mocked tool examples.

An HR helpdesk. hr.employee looks someone up in the directory. hr.policy answers a question from the policy handbook and cites the section. hr.my-leave returns the caller's leave balances and hr.request-leave books leave for the caller, counting working days and naming the approver.

It shows identity done properly: my-leave and request-leave act for the caller, whose employee id comes from the verified employee_id token claim (@JwtClaim), never from an argument, so nobody can read or book someone else's leave. In toolgate dev the claim comes from toolgate.dev.json; under ToolGate, from the caller's identity token. Without it the tools return CLAIMS_UNAVAILABLE.

Employees E-100 (engineering manager), E-101 and E-102 (engineers reporting to E-100), E-200 (HR partner).

Try it

cp toolgate.dev.example.json toolgate.dev.json   # never commit toolgate.dev.json
toolgate dev                                      # an MCP server over stdio
toolgate pack                                     # build/toolgate/hr-helpdesk-0.1.0.tgpkg

Things to ask a model connected to it:

"How much annual leave do I have left?"
"Book me off from 2 to 6 November."
"How much parental leave do we get, and who is my HR partner?"

Source repository
License: Apache-2.0

Tools

hr.employee Read only: Look up an employee Finds colleagues in the directory by id, name or email fragment, with title, team, manager and office.
hr.my-leave Read only: My leave balance Returns the caller's own leave balances. The caller is identified by their sign-in, not by an argument.
hr.policy Read only: Search HR policy Finds the HR policy sections relevant to a question, with their text, so the answer can cite them.
hr.request-leave Non idempotent: Request leave Requests leave for the caller between two dates (mocked: nothing is stored) and routes it to their manager. A repeat with the same reference returns the first request.

Settings it needs

Name	Kind	Type	Default	Description
`employeeId`	claim	STRING		Identity claim employee_id

Versions

Version	API change	Compatibility	Published
0.1.0	none	Java 17, protocol 2	15 Oct 2026 - 11:55

Publisher

ToolGate Examples, OLO Labs

Publisher details are supplied by the publisher. Validation checks package format, not code safety.

Hr - ToolGate tool package