# BrioHR MCP for AI Agents AI Agent Connect

> BrioHR MCP. Orchestrate HR management tasks by fetching employee profiles, tracking leave, and pulling claim reports directly into your AI agent. It connects your AI client to your BrioHR account to automate data retrieval for payroll, recruitment, and organizational oversight.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_7mbMhXcrsuttzw0qiypr2mImc7KN8zSAjN7ArBBE/ai-agent-connect
- **Tags:** briohr, hr-management, employee-data, leave-tracking, payroll-integration, recruitment-ats, human-resources

## Description

This Connector lets you pull data from BrioHR into your AI agent so you can stop jumping between tabs to manage your people. Instead of manually exporting CSVs or hunting through different modules to see who is on vacation, you can just ask your agent for the facts. It handles the heavy lifting of data orchestration for HR Business Partners and finance teams who need to move information quickly. If you're trying to reconcile payroll, you can grab approved claim reports without the usual manual export headache. If you're hiring, you can check candidate status or see active job postings in one go. It makes the HR data you already have actually useful in your daily conversations with your AI client. Since it's part of the Vinkius catalog, you get this added to your existing setup without any extra friction. It's about making your HR workflows move as fast as your team does.

## Tools

### get_employee_details
Get a full profile for a specific employee to check roles and departments. This helps you quickly verify staff information.

### get_payroll_summary
Pull a monthly payroll overview to see total costs and headcount. Use this for high-level monthly budget tracking.

### get_who_is_away
List all employees currently on leave or scheduled to be away. It's perfect for checking office availability.

### list_departments
View the organizational structure and all departments. Use this to map out your company's layout.

### list_employees
Get the basic information for every employee in the company. Use this for a quick headcount check.

### list_job_postings
See all active job openings in the recruitment module. This helps you keep an eye on your hiring status.

### list_leave_requests
Retrieve specific leave requests for a single employee. Use this to see the details of an individual's time off.

### list_performance_appraisals
View all active and past performance review cycles. Use this to keep track of employee development timelines.

### list_job_candidates
See the current list of candidates for a specific job opening. This helps you monitor the hiring pipeline.

### list_claim_reports
Download approved claim reports to sync with external accounting software. This automates your payroll reconciliation.

## Prompt Examples

**Prompt:** 
```
Who is out of the office next Tuesday?
```

**Response:** 
```
Checking BrioHR records for Tuesday, 2024-05-21...

I've found 2 employees scheduled to be away:
* **John Doe** (Annual Leave)
* **Sarah Jenkins** (Sick Leave)

Would you like me to pull the specific leave request details for either of them?
```

**Prompt:** 
```
Give me a summary of our current job openings.
```

**Response:** 
```
Here are the active job postings in your BrioHR account:

| Job Title | Status | Module |
| :--- | :--- | :--- |
| Senior Frontend Engineer | Active | Recruitment |
| Product Marketing Manager | Active | Recruitment |
| HR Coordinator | Active | Recruitment |
| Customer Support Lead | Active | Recruitment |

Let me know if you want to see the candidates for a specific role.
```

**Prompt:** 
```
What was the payroll summary for last month?
```

**Response:** 
```
Connecting to BrioHR payroll service...

**Payroll Summary: January 2024**
* **Total Headcount:** 50 employees
* **Total Costs Processed:** RM 250,000.00
* **Status:** Fully processed

I can also pull the department breakdown or the approved claim reports for this month if you need them.
```

## Capabilities

### Get employee profiles
Fetch full details for specific staff members to see roles and departments.

### Track staff absences
See who is out of the office on specific dates or currently on leave.

### Pull payroll summaries
Get a monthly payroll overview to see total costs and headcount.

### Extract claim reports
Download approved claim reports to sync with your external accounting software.

### Monitor recruitment
Check the status of candidates across your entire hiring pipeline.

### View job openings
List all active roles and job postings in your recruitment module.

### Track performance cycles
View all active and past performance review cycles for your team.

### Map department structures
Inspect your organizational layout and department list in real time.

## Use Cases

### Automated Payroll Reconciliation
A finance lead asks their agent for the January payroll summary and all approved claims to match against bank records using list_claim_reports.

### Real-time Hiring Updates
An operations manager wants to see how many candidates are in the pipeline for a new engineering role using list_job_candidates.

### Quick Leave Checks
An HRBP asks the agent who is away next week to coordinate a team meeting, and the agent uses get_who_is_away to find out.

### Onboarding Org Mapping
A manager needs to see the department structure and current headcount for a new team using list_departments and list_employees.

## Benefits

- Stop manually exporting CSVs for payroll by using list_claim_reports to pull approved data directly into your accounting workflow.
- Get instant answers on staff availability using get_who_is_away to see who is out of the office on any date.
- Speed up hiring by using list_job_candidates to check the status of everyone in your recruitment pipeline.
- Simplify org charts by using list_departments to see how your team structure looks in real time.
- Automate appraisal tracking with list_performance_appraisals to ensure no review cycles are missed.
- Reduce data entry errors by using list_employees to pull accurate, up to date staff information for your records.

## How It Works

The bottom line is you turn your HR data into a conversational tool for your AI.

1. Subscribe to the BrioHR MCP on the Vinkius marketplace.
2. Contact BrioHR support to request API access and whitelist your IP address.
3. Enter your API Username, Password, and Company ID into the configuration fields.

## Frequently Asked Questions

**Can the BrioHR MCP help with payroll reconciliation?**
Yes, it can pull approved claim reports and monthly payroll summaries directly into your chat. This helps you sync your data with accounting software without manual exports.

**How does BrioHR MCP handle staff leave?**
The Connector allows your AI agent to see who is currently away or scheduled for leave on specific dates. You can ask for a summary of absences for any date range.

**Can I use BrioHR MCP to track my hiring pipeline?**
Yes, you can use it to list active job postings and see the list of candidates for specific jobs. It gives you a clear view of your recruitment status.

**Does BrioHR MCP work with Claude or Cursor?**
Yes, it works with any MCP-compatible client, including Claude, Cursor, Windsurf, and VS Code.

**How do I get my API keys for the BrioHR MCP?**
You'll need to contact BrioHR support to request your API Username, Password, and Company ID, and to have your IP address whitelisted.

**Can the BrioHR MCP edit employee records?**
This Connector is designed for data orchestration and monitoring. It allows you to retrieve and view information, but it does not support editing or deleting records.

**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.