# Factorial MCP for AI Agents AI Agent Connect

> Factorial MCP lets you manage your entire workforce through natural conversation. It connects your Factorial HR account to your AI agent so you can check employee leave, browse HR documents, and view team hierarchies without ever opening a dashboard.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_TyON9Jn6V1WzfAjzuwlRSDq13vVfh9YiK3NRqFg8/ai-agent-connect
- **Tags:** employee-directory, time-off-management, payroll-processing, performance-reviews, hr-operations, leave-tracking

## Description

Factorial lets you manage your entire workforce without switching tabs or digging through complex HR dashboards. By connecting your Factorial HR account to an AI agent, you can handle the heavy lifting of human resource management through simple conversation. Instead of manually pulling reports or hunting for employee files, you just ask your agent to find the info you need. You can quickly check who's out of the office, pull up company documents, or see how your teams are structured. It's like having a dedicated HR administrator who knows every detail of your organization. You get to focus on the actual people in your company while the agent handles the data retrieval and organization. This Connector is part of the Vinkius catalog, making it easy to plug into your existing AI workflow.

## Tools

### list_employee_contracts
List all employment contracts in your system. This is useful for auditing and ensuring your company stays compliant.

### list_hr_documents
Get a list of all company HR documents. This helps you find specific files by looking at their metadata and IDs.

### list_employees
List all active employees. Use this to quickly find staff IDs, email addresses, and basic profile info.

### list_document_folders
List HR document folders. Use this to navigate the company's internal document library more efficiently.

### list_time_off_leaves
List employee leave requests. This lets you monitor staff availability and see who is currently away.

### list_attendance_shifts
List all attendance shifts. Use this to track working hours and understand team productivity patterns.

### list_company_teams
List all organizational teams. This helps you understand the full hierarchy and team structure of your company.

### get_employee_details
Get details for a specific employee. Use this to review detailed profile information and specific job roles.

## Prompt Examples

**Prompt:** 
```
Who is on leave next week?
```

**Response:** 
```
I've checked the leave requests for next week. Here is who will be out:

| Employee | Dates | Status |
| :--- | :--- | :--- |
| Jane Doe | Oct 12 - Oct 15 | Approved |
| Mark Smith | Oct 14 - Oct 18 | Pending |

Would you like me to see the details for any of these requests?
```

**Prompt:** 
```
Show me the company team structure.
```

**Response:** 
```
Here are the organizational teams currently defined in your Factorial account:

* **Engineering**
* **Marketing**
* **Sales**
* **Operations**
* **Human Resources**

Let me know if you want to see the members of a specific team.
```

**Prompt:** 
```
List all active employee contracts for the audit.
```

**Response:** 
```
I'm pulling the active contracts now. I found 42 active employment contracts. 

Notable items include:
* **Recent Signings:** 3 new contracts were added this month.
* **Compliance:** All contracts have valid metadata attached.

Do you want me to list the specific names and IDs for these contracts?
```

## Capabilities

### Check employee leave
See who is currently out of the office or has pending requests.

### Browse HR documents
Navigate company folders and find specific HR files instantly.

### View team hierarchy
Get a clear look at your company's departments and team structures.

### Track attendance shifts
Review chronological clock-in and clock-out data for the team.

### Audit employee contracts
Pull a list of all active employment contracts for compliance checks.

### Get staff profiles
Retrieve contact information and roles for any active employee.

## Use Cases

### Checking for team coverage
A team lead asks the agent who is available for a meeting today, and it checks list_time_off_leaves to provide a clear list of active staff.

### Onboarding a new hire
An HR manager asks for the folder structure for new hires, and the agent uses list_document_folders to guide them to the right place.

### Audit preparation
An ops lead needs to review all active contracts, so the agent pulls a full list using list_employee_contracts for a compliance review.

### Quick profile check
A manager needs a specific employee's role and contact info, so they use get_employee_details to see the full profile instantly.

## Benefits

- Check staff availability instantly by using list_time_off_leaves to see who is on vacation without opening the Factorial app.
- Audit your records faster with list_employee_contracts to keep your company in compliance with much less manual effort.
- Navigate your company files easily with list_hr_documents and list_document_folders to find specific policies in seconds.
- Get a clear view of your company's structure by using list_company_teams to understand reporting lines at a glance.
- Identify staff members quickly with list_employees to get contact info and IDs without searching through a database.
- Track productivity patterns by using list_attendance_shifts to see how your team's working hours are distributed.

## How It Works

The bottom line is you get a conversational interface for your entire Factorial HR database.

1. Subscribe to this Connector on the Vinkius marketplace.
2. Enter your Factorial API Key from your account settings.
3. Start asking your AI client to manage HR tasks like checking leave or listing employees.

## Frequently Asked Questions

**Can I use the Factorial MCP to see who's out of the office?**
Yes. You can ask your agent to check leave requests, and it will pull a list of employees who are currently away or have approved time off.

**Does the Factorial MCP work with Cursor or Claude?**
It works with any MCP-compatible client, including Claude, Cursor, Windsurf, and VS Code.

**How does the Factorial MCP help with HR audits?**
It allows you to quickly pull a list of all active employment contracts and HR documents, making it much easier to review compliance data.

**Can I search for specific HR documents using the Factorial MCP?**
Yes. You can ask the agent to list document folders or specific HR documents to find the information you need without manual searching.

**Is the Factorial MCP good for tracking employee shifts?**
It's great for that. You can query attendance shifts to see clock-in and clock-out data to understand your team's working patterns.

**How do I connect my Factorial account to my AI agent?**
Just subscribe to the Connector and provide your Factorial API Key from your account settings. Your agent will then have access to your HR data.

**Can my AI automatically find the details of a specific employee just by providing their ID?**
Yes! Use the `get_employee` tool with the unique ID. Your agent will respond with complete metadata, contact information, and role details in seconds.

**How do I monitor team leaves and availability?**
Simply ask the agent to run the `list_leaves` tool. It will compile a list of all requested and approved absences, allowing you to see who is out of the office.

**Does the integration permit modifying employee data?**
No. The core set of tools focuses strictly on querying and analyzing HR context—listing employees, leaves, and attendance. State alteration operations are not currently exposed, ensuring your records remain secure.