# Factorial MCP

> Factorial MCP connects any AI agent to your entire human resources workflow. Use it to instantly list employees, track leave requests and company holidays for a given year, audit shift schedules for months, or verify available payslips. It also lets you find specific HR policy documents and access global organizational metadata directly from conversation.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** time-tracking, employee-management, leave-management, recruitment, organizational-structure, hr-automation

## Description

Stop jumping between tabs just to answer basic questions about staff availability or payroll status. This MCP connects your Factorial HR account directly to your AI agent, giving it full visibility into your company's employee records and operational workflows through natural language chat. Need to know who’s out next month? Your agent checks the leave requests automatically. Want to verify if a team has enough coverage for shifts coming up? You ask, and the MCP pulls the detailed schedule data instantly. It lets you get full employee profiles or find specific HR policies stored in company documents without ever logging into the main dashboard. This capability is what makes connecting through Vinkius so useful; it centralizes complex HR tasks so your agent can act as a true digital assistant for management and finance teams alike.

## Tools

### clock_in
Records the time when a shift begins.

### clock_out
Records the time when a shift ends.

### get_employee
Retrieves detailed information on one specific employee using their ID number.

### get_me
Pulls general data about the current company's identity settings.

### list_documents
Lists all available company documents and folders for review.

### list_employees
Retrieves a comprehensive list of every employee registered in Factorial.

### list_folders
Shows all structured company folders where documents are stored.

### list_holidays
Provides a list of recognized holidays for any specific year.

### list_leaves
Shows all approved leave requests submitted and tracked for a given year.

### list_payslips
Lists available payslip records for both a specific month and year.

### list_shifts
Retrieves all shift scheduling details for a given month and year.

### list_teams
Provides a complete list of every team structure within the company.

## Prompt Examples

**Prompt:** 
```
List all employees in the 'Engineering' team
```

**Response:** 
```
Retrieving 'Engineering' members... I found 15 employees including 'John Smith' (Lead), 'Jane Doe' (Senior Dev), and 'Alice Wong'. Would you like the contact details or manager info for any of them?
```

**Prompt:** 
```
Show me upcoming leave requests for June 2026
```

**Response:** 
```
Checking June 2026... There are 3 approved leave requests: 'Jane Doe' (June 1-5), 'Robert Brown' (June 15-20), and 'Sarah Connor' (June 22-26). Your team availability is currently at 80% for that month.
```

**Prompt:** 
```
Find HR policy documents in the company folders
```

**Response:** 
```
Searching company documents... I found 2 related files: '2024_Remote_Work_Policy.pdf' and 'Global_Benefits_Guide.pdf'. Would you like the download link or a summary of the remote work policy?
```

## Capabilities

### Manage employee profiles
Retrieve detailed records on specific employees, including their roles, contact information, manager relationships, and hiring dates.

### Audit team availability
List all registered teams and check for upcoming leave or holidays to calculate current team capacity.

### Review time and payroll data
Get detailed shift schedules, clock in or out records, and list available payslips for specific months and years.

### Access company knowledge
Search through stored company folders and documents to pull up HR policies or internal documentation using keywords.

### Check organizational structure
Fetch global company metadata, confirming administrative settings and the current list of all registered employees and teams.

## Use Cases

### Checking quarterly PTO capacity
A manager needs to know how much remaining paid time off the entire marketing department has. They ask their agent, and it uses `list_leaves` combined with team data to give a precise answer, avoiding manual calculations.

### Auditing staffing for an upcoming peak season
The operations lead needs to confirm if enough staff are scheduled. They use the agent to run `list_shifts` for next quarter and check team size using `list_teams`, ensuring every shift is covered.

### Onboarding a new employee's manager
A new HR hire needs to verify the reporting structure. They ask their agent, which uses `get_employee` and related data to confirm the manager relationship and contact details instantly.

## Benefits

- You immediately get a complete employee directory using `list_employees`, letting you pull roles, departments, and contact details without navigating multiple menu screens.
- Checking team availability is simple. Running `list_leaves` or `list_holidays` tells you exactly how many people are out for any given year, helping prevent scheduling conflicts before they happen.
- Finance teams can verify compensation records by using `list_payslips`, confirming that the correct payslip data exists for a specific month and year.
- Need to find an old policy? Use `list_documents` or `list_folders` to search company files directly through conversation, bypassing complex file path navigation.
- Scheduling becomes effortless. Instead of cross-referencing calendars, you can run `list_shifts` to audit team rotations and operational coverage for any month.

## How It Works

The bottom line is you get an instant window into your company's HR data without ever leaving your chat client.

1. Subscribe to this MCP on Vinkius.
2. Enter your Factorial API Key (you'll find this in Settings > Advanced configuration > API Keys).
3. Ask your AI agent a question like, 'Show me all approved leave requests for June 2026,' and it runs the query.

## Frequently Asked Questions

**How do I use Factorial MCP to check employee contact details?**
You can get specific employee information by running the `get_employee` tool. You just need the employee's ID number, and the agent will pull their full profile right into the chat.

**Can Factorial MCP tell me about company policies?**
Yes, you can list all stored company documents using `list_documents`. The agent searches those files for keywords like 'remote work' or 'PTO policy,' giving you the title and summary of what it finds.

**Does Factorial MCP track my current shift status?**
You can use the `clock_in` and `clock_out` tools to record your shifts. This helps the agent keep an accurate running log that you can review later in conversation.

**How do I find out what time off is available for my team?**
You should use the `list_leaves` tool, making sure to specify the year. This gives you a clear list of all approved absence requests so you can plan around them.

**Does Factorial MCP handle payroll reports?**
The agent uses `list_payslips` to check for available payslip records, confirming the financial data exists for a specific year and month. It's great for auditing purposes.