# BrioHR MCP > BrioHR MCP connects your AI agent directly to an HR database, letting you pull employee data, track leave status, run payroll checks, and manage recruitment pipelines without logging into a single dashboard. It's the unified view of every person in your company. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** briohr, hr-management, employee-data, leave-tracking, payroll-integration, recruitment-ats, human-resources ## Description This connection lets your AI agent handle most routine HR data requests. Instead of navigating through separate systems—one for time-off, another for payroll claims, and yet another for job openings—you ask your agent a single question. It gathers all the necessary information automatically. You can get detailed records on specific employees or pull reports across entire departments. The system handles everything from listing active job postings to monitoring who is away during specific date ranges. This central access means you don't waste time stitching together data from multiple sources. Because Vinkius hosts this catalog, your agent connects once and gains instant access to all of BrioHR's capabilities for your whole team. ## Tools ### get_employee_details Gets the detailed profile for one specific employee. ### get_payroll_summary Retrieves a payroll overview for a given month. ### get_who_is_away Lists employees who are currently away or scheduled to take leave. ### list_performance_appraisals Lists historical performance review cycles completed by employees. ### list_job_candidates Lists candidates associated with a particular job posting. ### list_claim_reports Retrieves approved claim reports, ready for payroll integration. ### list_departments Lists all organizational departments within the company structure. ### list_employees Downloads the main information records for every employee in the system. ### list_job_postings Retrieves all active job openings currently listed in the recruitment module. ### list_leave_requests Gets detailed leave requests for a specified employee. ## Prompt Examples **Prompt:** ``` Who is away in my company between 2024-05-01 and 2024-05-15? ``` **Response:** ``` Checking BrioHR leave records... I've found 3 employees away during that period: 1. John Doe (Annual Leave), 2. Jane Smith (Sick Leave), 3. Robert Brown (Personal Leave). Would you like to see the specific request details for any of them? ``` **Prompt:** ``` List all active job postings in my BrioHR account. ``` **Response:** ``` Retrieving job openings... I've found 4 active postings: 1. Senior Frontend Engineer (ID: job_101), 2. Product Marketing Manager (ID: job_102), 3. HR Coordinator (ID: job_103), 4. Customer Support Lead (ID: job_104). ``` **Prompt:** ``` Show the payroll summary for January 2024. ``` **Response:** ``` Connecting to BrioHR payroll service... For January 2024, the total headcount was 50 employees. Total payroll costs processed: RM 250,000.00. Status: Fully processed. Would you like the department breakdown? ``` ## Capabilities ### Get an employee’s full profile Retrieves detailed records about a specific employee, including their role and department. ### Check who is taking leave Lists employees currently away or scheduled for time off within defined date ranges. ### Process payroll summaries and claims Accesses monthly payroll overviews and retrieves approved claim reports needed for accounting reconciliation. ### Manage the employee roster Downloads a complete list of all current employees or lists departmental structures. ### Track recruitment status Lists open job roles and monitors candidates moving through the hiring pipeline. ### Review performance records Retrieves historical data on employee performance appraisal cycles. ## Use Cases ### The Quarterly Review Prep An HR Manager needs to know who is due for a review next quarter. They ask the agent, which then cross-references `list_performance_appraisals` with `get_employee_details` to list all employees in specific departments that haven't updated their records recently. ### Budgeting for Staffing Levels The Operations Manager needs to know if they can hire three new people next month. They query the system, which uses `list_job_postings` to show current openings and combines that data with a count derived from `get_employee_details` for current department sizes. ### Payroll Audit A Finance Specialist needs to verify all approved claims before the payroll run. The agent executes `list_claim_reports`, ensuring every necessary document is retrieved and matched against a monthly summary from `get_payroll_summary`. ### Annual Leave Planning A manager plans an all-hands meeting in May. They ask the agent to run `get_who_is_away` for that month, immediately identifying key staff who will be out and requiring alternate coverage. ## Benefits - Get a full headcount overview using `list_employees` and department structure via `list_departments`. You get the entire roster instantly without running multiple reports. - Automate time-off tracking. Instead of checking three separate calendars, use `get_who_is_away` to list everyone out for a specific date range in one query. - Streamline payroll prep work by using `list_claim_reports`. You retrieve approved claims directly, skipping manual data entry into accounting systems. - Keep your hiring pipeline clean. Check open roles with `list_job_postings` and track applicants through the funnel by running `list_job_candidates` for any given job ID. - Consolidate employee history. You can check both a person's current department using `get_employee_details` and their past performance records via `list_performance_appraisals`. ## How It Works The bottom line is that you give your agent the keys, and it handles all the complex data retrieval behind the scenes. 1. Subscribe to this MCP and provide your BrioHR API Username, Password, and Company ID. 2. Connect the credentials into your AI client's configuration fields. 3. Your agent then uses natural language prompts to execute specific HR functions like checking leave status or pulling payroll data. ## Frequently Asked Questions **How does `list_employees` differ from `get_employee_details`?** `list_employees` downloads the main information for every single employee in a roster format. You use `get_employee_details` when you only need to see the full profile, roles, and department of one specific person. **Can I track active job postings using `list_job_postings`?** Yes. `list_job_postings` pulls every open role currently listed in your recruitment module. This is distinct from viewing candidates, which requires the `list_job_candidates` tool. **Does BrioHR help with payroll summaries?** Absolutely. You can use `get_payroll_summary` to retrieve a payroll overview for any specific month. This is critical for auditing and budgeting purposes. **What if I need leave status for multiple people? Should I use `list_leave_requests`?** While you can run `list_leave_requests` for an individual, a better approach is to use `get_who_is_away`. This tool automatically checks the calendar for a group or date range. **What credentials do I need to successfully run `list_claim_reports`?** You must provide your API Username, Password, and Company ID. Since this tool handles financial data, BrioHR requires you to first contact their support team for API access and IP whitelisting. **Can I limit the search when using `list_departments`?** Yes, you can filter department listings by division or location. The MCP supports filtering parameters so your agent only retrieves relevant organizational structures for a specific business unit. **If my company has many applicants, what are the limits when running `list_job_candidates`?** The tool handles up to 50 candidates per request batch. If you need more than that, your agent will automatically prompt for subsequent batches until all records have been retrieved. **What format does the data come in when I use `list_performance_appraisals`?** The data arrives as a structured JSON object. Each appraisal includes key fields like reviewer name, date completed, overall rating, and detailed written feedback. **How do I get API access for BrioHR?** You must reach out to the BrioHR support team at support@briohr.com. They will provide your credentials and require your IP addresses for whitelisting before you can connect. **Can my AI automatically list all active job postings?** Yes! Use the `list_job_postings` tool. Your agent will retrieve all current vacancies from your BrioHR recruitment module, including titles and IDs. **How do I retrieve the payroll summary for a specific month?** Use the `get_payroll_summary` tool with the month (MM) and year (YYYY). The agent will return the headcount and total calculations for that period.