Run an HR report
Headcount, joiners and leavers, time off taken, or everyone's leave balances.
Free*
*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.
An example
How many vacation days does everyone have left this year?
Your agent callshr_reportFree*
The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.
{
"report": "balances"
}Use it when
Someone asks how big the team is, who joined or left, or how much leave is left.
- For a page that shows the report to a person, use
view_show.
What it does
headcount: who works here on as_of (default today), by department, location and employment type, people on leave counted. joiners_leavers: who started, and whose last day fell, from-to. time_off: approved working days off from-to, per leave type and per person. balances: everyone's balance of each tracked leave type for a leave year (default the current one), paged. Periods default to this leave year so far. To show a person, put it in a view (view_show).
What comes back
The report's name and dates, and its rows: for balances the leave types and each person's balances, with the total; for headcount people by department, location and type; for joiners_leavers who started and left; for time_off the days off per type and person. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
reportRequired | string | One of: headcount,joiners_leavers,time_off,balances. |
as_of | string | YYYY-MM-DD. Matches ^\d{4}-\d{2}-\d{2}$. |
from | string | YYYY-MM-DD. Matches ^\d{4}-\d{2}-\d{2}$. |
to | string | YYYY-MM-DD. Matches ^\d{4}-\d{2}-\d{2}$. |
year | integer | A leave year, named by the year it starts in. Default: the current one. 2,000 to 2,100. |
limit | integer | 1 to 500. Default: 100. |
offset | integer | At least 0. Default: 0. |
The call
Over MCP, call hr_report on https://api.conecto.chat/mcp/hr. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/hr_report \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"report":"balances"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
invalid_input400 | A date is not a date like 2026-10-01, or from is after to. | Fix the date. |
More HR tools
All 23 tools- Add or change people
hr_save_peopleAdds people or changes them, up to 100 at a time, all or none: names, emails, job, department, location, manager, dates and allowances.$1.00 per person added - List people
hr_list_peoplePeople by last name, everyone who hasn't left by default, filtered by status, department, location, manager, type or words.Free* - Get a person
hr_get_personEverything about one person: details, leave balances for a year, pending and upcoming leave, documents, open tasks and direct reports.Free* - Delete a person
hr_delete_personErases a person for good with their leave, tasks and document records; their files stay in the store.Free - Read the HR settings
hr_get_settingsThe working days, hours, leave year, time zone, leave types, public holidays and checklists.Free* - Change the HR settings
hr_save_settingsSets the work calendar: working days, hours per day, leave year, time zone, and one location's public holidays for a year.$0.001 a call - Add or change a leave type
hr_save_leave_typeAdds or changes a kind of time off: annual days, monthly or yearly accrual, carry-over, paid and tracked.$0.001 a call - Adjust a leave balance
hr_adjust_leaveAdds days to, or takes days off, one person's balance of a tracked leave type, with the reason.$0.01 a call
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md