BrightHR MCP by usefulapi

Read employees, clock-ins and absences; set employee external references in BrightHR.

Sollte ich dies verwenden

Qualität und Sicherheit

A
Qualität der Beschreibung
100%
Vollständigkeit des Schemas
95%
Qualität der Benennung
75%
Risiko der Vergiftung
100%
Übereinstimmung der Berechtigungen
100%
Einhaltung des Protokolls
100%

Befunde (1)

  • LOWTool 'brighthr_set_employee_external_reference' name length outside 3-30 rangein brighthr_set_employee_external_reference

Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.

Kontextkosten

~991Tokens (Tool-Definitionen)
~1.8 KBTypische Antwortgröße
Mittlere Auswirkung auf die Aufmerksamkeit (0.77% von 128k Kontext)

Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.

Installieren

Installation mit einem Klick

Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:

{
  "mcpServers": {
    "brighthr": {
      "url": "https://brighthr.usefulapi.io/mcp"
    }
  }
}

Remote-Endpunkte

https://brighthr.usefulapi.io/mcpstreamable-http

Was es kann

Tool-Inventar

Tools (4)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢brighthr_list_employees(email, externalReference, isTerminated, pageSize, continuationToken)

List the employees of your BrightHR organisation with name, job title, start and end dates, email, external reference and registration/termination status. Filter by email, external reference or termination status. Paginated: pass the returned continuationToken to get the next page. BrightHR Customer API: POST /employees/v1/query.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "email": {
      "description": "Only employees with this email address.",
      "type": "string"
    },
    "externalReference": {
      "description": "Only employees with this external reference.",
      "type": "string"
    },
    "isTerminated": {
      "description": "true for leavers only, false for current employees only.",
      "type": "boolean"
    },
    "pageSize": {
      "description": "Items per page (1-100, default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "continuationToken": {
      "description": "continuationToken from the previous response; omit for the first page.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴brighthr_set_employee_external_reference(employeeId, externalReference)

WRITE: set or clear the external reference of one employee (1-36 characters; several employees may share one). Use it to link a BrightHR employee to an id in another system. Replaces any existing value. Pass null to clear it. BrightHR Customer API: PUT /employees/v1/{employeeId}/external-reference.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "employeeId": {
      "type": "string",
      "minLength": 1,
      "description": "The BrightHR employee id (from brighthr_list_employees)."
    },
    "externalReference": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 36
        },
        {
          "type": "null"
        }
      ],
      "description": "The new external reference (1-36 characters), or null to clear it."
    }
  },
  "required": [
    "employeeId",
    "externalReference"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢brighthr_list_clockings(employeeId, from, to, pageSize, continuationToken)

List Blip clock-in records of one employee: clock-in and clock-out times with time zones, breaks and notes, within an optional date range. Paginated with continuationToken. BrightHR Customer API: POST /blip/v1/clockings/query.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "employeeId": {
      "type": "string",
      "minLength": 1,
      "description": "The BrightHR employee id (from brighthr_list_employees)."
    },
    "from": {
      "description": "Start or end of the range, as the API's date or date-time string (for example 2026-01-31).",
      "type": "string"
    },
    "to": {
      "description": "Start or end of the range, as the API's date or date-time string (for example 2026-01-31).",
      "type": "string"
    },
    "pageSize": {
      "description": "Items per page (1-100, default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "continuationToken": {
      "description": "continuationToken from the previous response; omit for the first page.",
      "type": "string"
    }
  },
  "required": [
    "employeeId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢brighthr_list_absences(employeeId, from, to, pageSize, continuationToken)

List approved absences of one employee within an optional date range: holiday, sickness, time off in lieu (TOIL) and other. Lateness is not included. Each item has a $type field. Paginated with continuationToken. BrightHR Customer API: POST /absences/v1/query.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "employeeId": {
      "type": "string",
      "minLength": 1,
      "description": "The BrightHR employee id (from brighthr_list_employees)."
    },
    "from": {
      "description": "Start or end of the range, as the API's date or date-time string (for example 2026-01-31).",
      "type": "string"
    },
    "to": {
      "description": "Start or end of the range, as the API's date or date-time string (for example 2026-01-31).",
      "type": "string"
    },
    "pageSize": {
      "description": "Items per page (1-100, default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "continuationToken": {
      "description": "continuationToken from the previous response; omit for the first page.",
      "type": "string"
    }
  },
  "required": [
    "employeeId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet4 Tools