conecto. Get started
HR

Read the HR settings

hr_get_settings · Reads only · Markdown

The working days, hours, leave year, time zone, leave types, public holidays and checklists.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

An example

Which public holidays do we have in Hamburg this year?

Your agent callshr_get_settingsFree*

The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.

With these arguments
{
  "year": 2026,
  "location": "Hamburg"
}
What comes back
{
  "settings": {
    "working_days": [
      1,
      2
    ],
    "working_day_names": [
      "Monday",
      "Tuesday"
    ],
    "hours_per_day": "8",
    "leave_year_start": 1,
    "time_zone": "Europe/Berlin",
    "time_zone_own": true,
    "today": "2026-10-14",
    "leave_year": {
      "year": 2026,
      "from": "2026-01-01",
      "to": "2026-12-31"
    }
  },
  "leave_types": [
    {
      "name": "Sick",
      "tracked": false,
      "paid": true,
      "annual_days": "0",
      "accrual": "yearly",
      "carry_over_max": "0",
      "archived": false
    },
    {
      "name": "Vacation",
      "tracked": true,
      "paid": true,
      "annual_days": "28",
      "accrual": "yearly",
      "carry_over_max": "5",
      "archived": false
    }
  ],
  "holidays": {
    "year": 2026,
    "location": "Hamburg",
    "days": [
      {
        "date": "2026-10-03",
        "name": "German Unity Day",
        "location": "Hamburg"
      },
      {
        "date": "2026-10-31",
        "name": "Reformation Day",
        "location": "Hamburg"
      }
    ]
  },
  "checklists": [
    {
      "name": "Warehouse onboarding",
      "kind": "onboarding",
      "items": [
        {
          "title": "Hand over the warehouse keys",
          "owner": "manager",
          "due_days": -1
        },
        {
          "title": "Safety briefing for the forklift and the racks",
          "owner": "hr",
          "due_days": 0
        }
      ]
    }
  ]
}

Use it when

Before requesting leave or starting a checklist, to know the names and rules.

What it does

The working days, hours per day, the month the leave year starts, the time zone and today's date in it; every leave type; the public holidays of a calendar year (every location's, or one location's with everyone's); and the onboarding and offboarding checklists.

What comes back

settings (working days, hours per day, leave year start, time zone and today), every leave type, the year's public holidays per location, and the checklists. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
yearintegerHolidays of this calendar year. Default: this year. 2,000 to 2,100.
locationstringOnly this location's holidays and everyone's. Up to 120 characters.

The call

Over MCP, call hr_get_settings on https://api.conecto.chat/mcp/hr. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/hr_get_settings \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2026,"location":"Hamburg"}'

More HR tools

All 23 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md