# Breathe HR MCP by usefulapi (remote · breathe-hr.usefulapi.io)

Read Breathe HR employees, absences, sickness and leave; create and review leave requests.

- Trust score: 18/100 (low)
- Change this week: −54
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

## Components

- remote · `breathe-hr.usefulapi.io`: 18/100 (this document), [markdown](https://verifymcp.io/servers/io-usefulapi-breathe-hr/breathe-hr.md), [page](https://verifymcp.io/servers/io-usefulapi-breathe-hr/breathe-hr)

## Channel facts

- Endpoint: `https://breathe-hr.usefulapi.io/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.23.2`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Endpoint Security**: 46/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not yet verified: we couldn't confirm whether this endpoint requires it.
  - HTTPS enforcement could not be verified: the plaintext port redirected somewhere other than https, so enforcement is unproven.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 0/100
  - Transport check failed: declared streamable-http, but the endpoint redirected instead of responding directly.
- **Schema Quality & AI Usability**: 0/100
  - Schema not yet verified: we couldn't read the endpoint's schema, or could read only part of its tool list.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 0/100
  - Tool coverage not yet verified: we couldn't read the endpoint's tools, or could read only part of the list.
- **Tool Safety**: 0/100
  - Tool safety not yet verified: we couldn't read the endpoint's tools, or could read only part of the list.
- **Capabilities**: 0/100
  - Capabilities not yet verified: we couldn't read the endpoint's capabilities.

**Unverified: 5 categories.** Categories scored 0 because we could not verify them: authentication we do not have, an unreachable endpoint, or not enough scan history. We only credit what we can confirm.

## Install

### How do I install the Breathe HR MCP by usefulapi server?

Breathe HR MCP by usefulapi is a hosted endpoint at https://breathe-hr.usefulapi.io/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http io-usefulapi-breathe-hr 'https://breathe-hr.usefulapi.io/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "io-usefulapi-breathe-hr": {
      "url": "https://breathe-hr.usefulapi.io/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "io-usefulapi-breathe-hr": {
      "type": "http",
      "url": "https://breathe-hr.usefulapi.io/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.io-usefulapi-breathe-hr]
url = "https://breathe-hr.usefulapi.io/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-usefulapi-breathe-hr": {
      "type": "remote",
      "url": "https://breathe-hr.usefulapi.io/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add io-usefulapi-breathe-hr --url 'https://breathe-hr.usefulapi.io/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  io-usefulapi-breathe-hr:
    url: "https://breathe-hr.usefulapi.io/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "io-usefulapi-breathe-hr": {
      "Transport": "http",
      "Url": "https://breathe-hr.usefulapi.io/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add io-usefulapi-breathe-hr -t streamable-http -u 'https://breathe-hr.usefulapi.io/mcp'
```

### Other

```json
{
  "mcpServers": {
    "io-usefulapi-breathe-hr": {
      "type": "http",
      "url": "https://breathe-hr.usefulapi.io/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-01 (score 18, −58)

- [security regression] Endpoint reachability: reachable → not serving MCP
- [security regression] Stability: 0.70 → unverified
- [security regression] Tool safety: pass → unverified
- [security regression] Authorization: pass → unverified
- [functional regression] Schema quality: 100 → unverified
- [functional regression] Capabilities: pass → unverified
- [functional regression] Tool coverage: 100 → unverified

### 2026-10-31 (score 76, +4)

- [security improvement] Authorization: partial → pass
- [functional improvement] MCP protocol: fail → pass
- [functional] New prompt “check_an_employee_s_holiday_allowance_and_days_left”
- [functional] New prompt “look_through_employees_departments_and_expense_claims”
- [functional] New prompt “request_leave_and_approve_or_reject_leave_requests”
- [functional] New prompt “review_leave_requests_and_their_approval_status”
- [functional] New prompt “see_who_is_off_and_for_how_many_days”
- [functional] MCP protocol version: 2025-06-18 → 2025-11-25
- [functional] Server version: 1.19.0 → 1.21.0
- [functional] Server version: 1.18.0 → 1.19.0
- [functional] Server version: 1.17.2 → 1.18.0

### 2026-10-30 (score 72, 0)

- [functional] Server version: 1.17.1 → 1.17.2
- [functional] Server version: 1.17.0 → 1.17.1

### 2026-10-29 (score 72, +1)

- [functional] Server version: 1.16.0 → 1.17.0
- [functional] Server version: 1.15.0 → 1.16.0

### 2026-10-28 (score 71, 0)

- [functional] Server version: 1.13.0 → 1.15.0

### 2026-10-27 (score 71, +1)

- [functional] Server version: 1.12.0 → 1.13.0

### 2026-10-25 (score 70, +1)

- [functional] Server version: 1.11.0 → 1.12.0
- [functional] Server version: 1.10.0 → 1.11.0
- [functional] Server version: 1.9.3 → 1.10.0
- [functional] Server version: 1.9.2 → 1.9.3
- [functional] Server version: 1.9.0 → 1.9.2

### 2026-10-24 (score 69, 0)

- [security] The server rewrote its instructions, which are the text every model session reads
- [functional] Server version: 1.8.0 → 1.9.0
- [functional] Server version: 1.7.0 → 1.8.0
- [functional] Server version: 1.5.0 → 1.7.0

## MCP tools (25)

### `breathehr_get_account` (~37 tokens)

Get account

The Breathe HR account (company) this API key belongs to: id, name, domain and enabled modules. GET /account.

### `breathehr_list_departments` (~84 tokens)

List departments

List the company's departments (id, name). Use the ids to filter absences, leave, sickness and pay. GET /departments.

Input parameters:

- `page` (integer): Page number, from 1 (default 1). Pass the previous reply's next_page.
- `per_page` (integer): Results per page, 1-100 (default 25).

### `breathehr_list_divisions` (~34 tokens)

List divisions

List the company's divisions (id, name). All of them are returned in one reply. GET /divisions.

### `breathehr_list_locations` (~33 tokens)

List locations

List the company's work locations (id, name). All of them are returned in one reply. GET /locations.

### `breathehr_list_working_patterns` (~42 tokens)

List working patterns

List the working patterns (hours per weekday, total weekly hours, default flag). All of them are returned in one reply. GET /working_patterns.

### `breathehr_list_holiday_allowances` (~61 tokens)

List holiday allowances

List the holiday allowance schemes (id, default flag, year_1 to year_10 = the allowance for each year of service, created_at, updated_at). All of them are returned in one reply. GET /holiday_allowances.

### `breathehr_list_other_leave_reasons` (~54 tokens)

List other leave reasons

List the reasons for non-holiday leave (e.g. compassionate, jury service). Use the ids to filter absences. All of them are returned in one reply. GET /other_leave_reasons.

### `breathehr_list_employees` (~124 tokens)

List employees

List employees with job title, department, division, location, line manager, holiday approver, working pattern, join/leaving dates and status. Bank details and National Insurance numbers are never returned. GET /employees.

Input parameters:

- `filter` (string): Only employees with this role: hr (HR managers), line_manager, either, or neither.
- `page` (integer): Page number, from 1 (default 1). Pass the previous reply's next_page.
- `per_page` (integer): Results per page, 1-100 (default 25).

### `breathehr_get_employee` (~56 tokens)

Get employee

One employee's record by id (personal and job details, contacts, manager, working pattern). Bank details and NI number are never returned. GET /employees/{id}.

Input parameters:

- `employee_id` (integer, required): Breathe employee id.

### `breathehr_get_holiday_years` (~95 tokens)

Get holiday years (allowance balance)

An employee's holiday years: start/end, allowance, days or hours taken, booked and remaining. Pass for_date to get only the year that contains that date. GET /employees/{id}/employee_holiday_years.

Input parameters:

- `employee_id` (integer, required): Breathe employee id.
- `for_date` (string): Only the holiday year that includes this date (yyyy-mm-dd), e.g. today.

### `breathehr_list_absences` (~220 tokens)

List absences

List approved absences (holiday and other leave) with employee, dates, half days, days deducted and cancelled flag. Filter by employee, department, type, other-leave reason and dates. GET /absences.

Input parameters:

- `department_id` (integer): Only absences of employees in this department.
- `employee_id` (integer): Only this employee's absences.
- `end_date` (string): Only absences up to this date (yyyy-mm-dd).
- `exclude_cancelled` (boolean): Leave out cancelled absences.
- `other_leave_reason_id` (integer): Only other leave with this reason (ids from breathehr_list_other_leave_reasons).
- `page` (integer): Page number, from 1 (default 1). Pass the previous reply's next_page.
- `per_page` (integer): Results per page, 1-100 (default 25).
- `start_date` (string): Only absences on or after this date (yyyy-mm-dd).
- `type` (string): Holiday or OtherLeave.

### `breathehr_list_leave_requests` (~179 tokens)

List leave requests

List leave requests (pending, approved, rejected and cancelling requests) with employee, dates, half days, type, status and notes. Filter by employee, department and start-date range. GET /leave_requests.

Input parameters:

- `department_id` (integer): Only requests of employees in this department.
- `employee_id` (integer): Only this employee's requests.
- `end_date` (string): Only requests starting on or before this date (yyyy-mm-dd).
- `exclude_cancelled` (boolean): Leave out cancelled requests.
- `page` (integer): Page number, from 1 (default 1). Pass the previous reply's next_page.
- `per_page` (integer): Results per page, 1-100 (default 25).
- `start_date` (string): Only requests starting on or after this date (yyyy-mm-dd).

### `breathehr_get_leave_request` (~42 tokens)

Get leave request

One leave request by id, with its status. GET /leave_requests/{id}.

Input parameters:

- `leave_request_id` (integer, required): Breathe leave request id.

### `breathehr_list_sicknesses` (~173 tokens)

List sickness records

List sickness absence records (health data): employee, sickness type, dates, half days, days deducted, status (open, returned, closed…) and reason. Filter by employee, department and start-date range. GET /sicknesses.

Input parameters:

- `department_id` (integer): Only sickness of employees in this department.
- `employee_id` (integer): Only this employee's sickness.
- `end_date` (string): Only sickness starting on or before this date (yyyy-mm-dd).
- `page` (integer): Page number, from 1 (default 1). Pass the previous reply's next_page.
- `per_page` (integer): Results per page, 1-100 (default 25).
- `start_date` (string): Only sickness starting on or after this date (yyyy-mm-dd).

### `breathehr_list_salaries` (~135 tokens)

List salaries

List salary records (amount, basis, payment schedule, start date) for the whole company, one employee or one department. GET /salaries, /employees/{id}/salaries or /departments/{id}/salaries.

Input parameters:

- `department_id` (integer): Only records of employees in this department.
- `employee_id` (integer): Only this employee's records.
- `page` (integer): Page number, from 1 (default 1). Pass the previous reply's next_page.
- `per_page` (integer): Results per page, 1-100 (default 25).

### `breathehr_list_bonuses` (~128 tokens)

List bonuses

List bonus records (amount, date, description) for the whole company, one employee or one department. GET /bonuses, /employees/{id}/bonuses or /departments/{id}/bonuses.

Input parameters:

- `department_id` (integer): Only records of employees in this department.
- `employee_id` (integer): Only this employee's records.
- `page` (integer): Page number, from 1 (default 1). Pass the previous reply's next_page.
- `per_page` (integer): Results per page, 1-100 (default 25).

### `breathehr_list_benefits` (~129 tokens)

List benefits

List employee benefits (type, value, start/end) for the whole company, one employee or one department. GET /benefits, /employees/{id}/benefits or /departments/{id}/benefits.

Input parameters:

- `department_id` (integer): Only records of employees in this department.
- `employee_id` (integer): Only this employee's records.
- `page` (integer): Page number, from 1 (default 1). Pass the previous reply's next_page.
- `per_page` (integer): Results per page, 1-100 (default 25).

### `breathehr_list_employee_jobs` (~97 tokens)

List employee jobs

List job history records (job title, start/end dates, department, location) for all employees or one employee. GET /employee_jobs.

Input parameters:

- `employee_id` (integer): Only this employee's jobs.
- `page` (integer): Page number, from 1 (default 1). Pass the previous reply's next_page.
- `per_page` (integer): Results per page, 1-100 (default 25).

### `breathehr_list_training_courses` (~98 tokens)

List training courses

List employee training records (course name, type, status, dates, cost) for all employees or one employee. GET /employee_training_courses.

Input parameters:

- `employee_id` (integer): Only this employee's training.
- `page` (integer): Page number, from 1 (default 1). Pass the previous reply's next_page.
- `per_page` (integer): Results per page, 1-100 (default 25).

### `breathehr_list_expense_claims` (~110 tokens)

List expense claims

List expense claims (employee, total, state, approver) filtered by employee and state. GET /employee_expense_claims.

Input parameters:

- `employee_id` (integer): Only this employee's claims.
- `page` (integer): Page number, from 1 (default 1). Pass the previous reply's next_page.
- `per_page` (integer): Results per page, 1-100 (default 25).
- `state` (string): Only claims in this state.

### `breathehr_list_expenses` (~124 tokens)

List expenses

List individual expense items (date, description, type, amount, VAT, project). By default only unclaimed items; set include_claimed to see all. GET /employee_expenses.

Input parameters:

- `employee_id` (integer): Only this employee's expenses.
- `include_claimed` (boolean): Also return expenses already part of a claim.
- `page` (integer): Page number, from 1 (default 1). Pass the previous reply's next_page.
- `per_page` (integer): Results per page, 1-100 (default 25).

### `breathehr_list_change_requests` (~116 tokens)

List change requests

List employee self-service change requests (field, requested value, approval state) for all employees or one employee. Requested values of bank and NI fields are redacted. GET /change_requests or /employees/{id}/change_requests.

Input parameters:

- `employee_id` (integer): Only this employee's change requests.
- `page` (integer): Page number, from 1 (default 1). Pass the previous reply's next_page.
- `per_page` (integer): Results per page, 1-100 (default 25).

### `breathehr_create_leave_request` (~228 tokens)

Create leave request

WRITE: request leave for an employee (holiday by default, or other leave). It is created as a request, then follows the account's approval rules; the employee's approver is notified. Each call creates a new request. POST /employees/{id}/leave_requests.

Input parameters:

- `employee_id` (integer, required): Breathe employee id.
- `end_date` (string, required): Last day of leave (yyyy-mm-dd), same as start_date for one day.
- `half_end` (boolean): The last day is a half day (default false).
- `half_end_am_pm` (string): Which half of the last day: am or pm (with half_end).
- `half_start` (boolean): The first day is a half day (default false).
- `half_start_am_pm` (string): Which half of the first day: am or pm (with half_start).
- `notes` (string): Notes for the approver.
- `start_date` (string, required): First day of leave (yyyy-mm-dd).
- `type` (string): Holiday (default) or OtherLeave.

### `breathehr_approve_leave_request` (~70 tokens)

Approve leave request

WRITE: approve a pending leave request; it becomes an absence and is deducted from the allowance. Recorded as done by the "API Employee". POST /leave_requests/{id}/approve.

Input parameters:

- `leave_request_id` (integer, required): Breathe leave request id (from breathehr_list_leave_requests).

### `breathehr_reject_leave_request` (~84 tokens)

Reject leave request

WRITE: reject a pending leave request with a reason the employee will see. Recorded as done by the "API Employee". POST /leave_requests/{id}/reject.

Input parameters:

- `leave_request_id` (integer, required): Breathe leave request id (from breathehr_list_leave_requests).
- `rejection_reason` (string, required): Why the request is rejected (shown to the employee).

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/io-usefulapi-breathe-hr/breathe-hr#diagnostics

## Score history

- 2026-11-05: 18
- 2026-11-04: 18
- 2026-11-03: 18
- 2026-11-02: 18
- 2026-11-01: 18
- 2026-10-31: 76
- 2026-10-30: 72
- 2026-10-29: 72
- 2026-10-28: 71
- 2026-10-27: 71
- 2026-10-26: 70
- 2026-10-25: 70
- 2026-10-24: 69
- 2026-10-23: 69
- 2026-10-22: 69
- 2026-10-21: 68
- 2026-10-20: 68
- 2026-10-19: 67
- 2026-10-18: 67
- 2026-10-17: 66
- 2026-10-16: 66
- 2026-10-15: 65
- 2026-10-14: 65
- 2026-10-13: 64
- 2026-10-12: 62
- 2026-10-10: 61

## Common questions

### What is the Breathe HR MCP by usefulapi server?

Breathe HR MCP by usefulapi is listed in the public MCP registry as io.usefulapi/breathe-hr. Read Breathe HR employees, absences, sickness and leave; create and review leave requests. This page covers its hosted endpoint (https://breathe-hr.usefulapi.io/mcp).

### Is the Breathe HR MCP by usefulapi server safe to use?

Breathe HR MCP by usefulapi scores 18 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Breathe HR MCP by usefulapi server expose?

Breathe HR MCP by usefulapi exposes 25 tools: breathehr_get_account, breathehr_list_departments, breathehr_list_divisions, breathehr_list_locations, breathehr_list_working_patterns, and 20 more. Their descriptions and schemas cost roughly 2,553 tokens of context every time the server is loaded.

### Does the Breathe HR MCP by usefulapi server require authentication?

Its publisher declares no required credentials for Breathe HR MCP by usefulapi. We have not been able to confirm that against the live endpoint, and a server can require authorisation without declaring it here.

### Is the Breathe HR MCP by usefulapi server still maintained?

Breathe HR MCP by usefulapi is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- Remote endpoint: https://breathe-hr.usefulapi.io/mcp
- Repository: https://github.com/m190/usefulapi-mcp
- Website: https://usefulapi.io/breathe-hr/
- Changelog RSS feed: https://verifymcp.io/servers/io-usefulapi-breathe-hr/breathe-hr.xml
- Changelog JSON feed: https://verifymcp.io/servers/io-usefulapi-breathe-hr/breathe-hr.json
- HTML version of this page: https://verifymcp.io/servers/io-usefulapi-breathe-hr/breathe-hr