# BrightHR MCP MCP > BrightHR connects your AI agent directly to your employee records, allowing you to manage everything from holiday requests to compensation data using natural conversation. It handles absence tracking, shift scheduling, and full workforce visibility for UK and ANZ businesses. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** employee-management, absence-tracking, leave-management, shift-scheduling, hr-compliance, workforce-management ## Description Stop jumping between HR portals just to get a simple answer about staff availability or leave balances. This MCP lets you take control of your entire employee lifecycle through your agent's chat interface. You can ask questions like, 'Who is out next week?' or 'What are the benefits for new hires?' and get instant, structured data back. It handles complex tasks—like logging a sickness absence or listing every active staff member—in plain language. When you connect it via Vinkius, your agent acts less like an assistant and more like a dedicated HR administrator sitting right next to you. You maintain full visibility into job roles, salary information, training history, and organizational structure without ever touching the raw dashboard. It's about getting answers immediately, keeping your team coordinated, and automating the oversight of people management. ## Tools ### check_api_health Tests and confirms if the BrightHR API connection is currently working. ### get_employee_details Pulls general information for a single, specified employee. ### get_employee_job_details Retrieves the specific job title and metadata associated with an employee's role. ### get_employee_salary_info Gets detailed salary information for a particular staff member. ### get_organization_info Pulls general details about the overall company structure and setup. ### list_absences Lists all reported employee absences, optionally filtering by a specific staff ID. ### list_configured_webhooks Shows a list of webhooks that are currently set up to trigger alerts or actions. ### list_employee_benefits Lists all the benefits packages available for a specific employee. ### list_employees Generates a full list of every individual currently employed by the company. ### list_holiday_requests Displays all planned leave or holiday requests, which can be filtered by staff ID. ### list_training_records Retrieves a history of training and certifications completed by an employee. ### record_absence Logs a new absence record, such as sickness or planned leave, for any staff member. ## Prompt Examples **Prompt:** ``` List all active employees in my organization. ``` **Response:** ``` I've retrieved your employee directory. You currently have 25 active staff members, including @user1 and @user2. Would you like to see the detailed job metadata for any of them? ``` **Prompt:** ``` Show the holiday requests for employee ID 'emp_123'. ``` **Response:** ``` Fetching leave records... Employee emp_123 has 2 upcoming holiday requests: a 1-week trip in June (Approved) and a 3-day break in August (Pending). Shall I retrieve the high-fidelity absence history for them? ``` **Prompt:** ``` Record a sickness absence for @user1 starting from tomorrow. ``` **Response:** ``` Absence recorded! I've successfully registered the sickness absence for @user1 in BrightHR. The start date is set for tomorrow. Shall I notify the team lead about this update? ``` ## Capabilities ### List all personnel Retrieve a complete directory of every employee in the organization. ### Check staff availability View upcoming planned holidays or track current absences for any team member. ### Review compensation and job data Get specific details about an employee's role, department, salary, and benefits package. ### Update records Log a new absence or track leave requests that need approval. ### Audit organizational status Access current company details, check API health, and monitor active webhooks for system reporting. ## Use Cases ### A team lead needs to know who is available for the Q3 launch. The team leader asks the agent: 'Who can cover the West Coast shift next week?' The agent runs `list_holiday_requests` and cross-references it with `list_absences`, providing a list of fully available staff members, saving an hour of manual calendar checking. ### HR needs to audit compensation structure after a policy change. The HR manager prompts the agent: 'Show me the salary and job metadata for all department heads.' The system uses `list_employees` combined with `get_employee_job_details` and `get_employee_salary_info`, generating an immediate, comparative spreadsheet view. ### A staff member calls in sick; the manager needs to update records. Instead of filling out a form and emailing it, the manager tells their agent: 'Log a sickness absence for Jane Doe starting tomorrow.' The agent uses `record_absence` instantly, making the record accurate before the end of the day. ### The company is onboarding new hires and needs to know their entitlements. The manager asks: 'What benefits does a developer get in this department?' The agent uses `list_employee_benefits` against the specific role data, providing an accurate list of perks immediately. ## Benefits - Coordinate team scheduling instantly. Instead of manually checking multiple dashboards, you can ask the agent to list available staff and review `list_holiday_requests` against current absences in one query. - Maintain compliance oversight simply. You can pull comprehensive reports on employee roles and compensation by using `get_employee_job_details` alongside salary data from `get_employee_salary_info`. - Keep records clean. If someone gets sick, you don't need to fill out a form; your agent logs the sickness absence immediately with `record_absence` and notifies the right people. - Get full visibility into employee development. You can instantly pull training history using `list_training_records`, ensuring managers know when staff are due for required compliance courses. - Audit system status proactively. Before relying on the data, use `check_api_health` to confirm that all your integration links are active and working correctly. - Understand benefits at a glance. For onboarding or review periods, you can run a query using `list_employee_benefits` without needing access to multiple payroll systems. ## How It Works The bottom line is that you talk to your AI client, and it handles all the complex API calls behind the scenes. 1. Subscribe to this MCP on Vinkius and generate an Access Token from your BrightHR developer dashboard. 2. Connect the token credentials to your preferred AI client (Claude, Cursor, etc.). 3. Use natural language prompts with your agent; it sends structured queries to BrightHR and returns actionable data. ## Frequently Asked Questions **How do I use the list_employees tool in BrightHR?** The agent runs `list_employees` when you ask for a full staff directory. It pulls all current records from BrightHR, allowing you to see every person and their basic details instantly. **Can I use get_employee_salary_info with this MCP?** Yes, if you need salary data for a specific employee, you prompt the agent to run `get_employee_salary_info`. It retrieves the exact pay details directly from BrightHR. **What is the difference between list_absences and list_holiday_requests?** Use `list_holiday_requests` for pre-approved, planned time off. Use `list_absences` to see records of actual sickness or unplanned time away. **Is the BrightHR MCP good for managing shifts?** While it doesn't schedule them, you can check availability by combining `list_employees`, `list_holiday_requests`, and `list_absences` to determine who is free when. **How do I check if the BrightHR API is working?** Just run the `check_api_health` tool. It sends a quick ping to the system and tells you immediately if there are any connectivity issues before your agent tries to pull data. **How do I use the get_employee_job_details tool to understand organizational structure?** The tool returns rich job metadata, including specific roles, department hierarchies, and associated reporting lines. You can's map out how different positions relate to the overall company structure for better oversight. **What does the list_configured_webhooks tool show me about data flow?** This MCP lets you check all active webhooks set up in BrightHR. You can quickly see what automated reporting streams are running, verifying which systems are receiving live employee or HR updates. **What parameters do I need when calling the record_absence tool?** You must provide the employee ID, a start date, and an end date. The tool also requires a reason code to accurately log the absence type—whether it's sick leave or planned time off.